核心用法
transfer-skill-to-windows 是一款面向开发者的技能迁移工具，专注于将基于 Unix/Linux 设计的 AI agent skill 快速适配到 Windows 环境。该技能接受两种输入形式：技能文件夹路径或包含 skill 的 zip 压缩包，通过系统化的检测与改写流程，输出 Windows 就绪的版本。
显著优点
1. 精准的风险检测机制：内置详尽的 Windows 不兼容项检查清单，涵盖 bash 命令、Unix 路径（如 /tmp/、/usr/local/）、文件权限操作（chmod）、管道符号（&&）等 20 余类常见陷阱，甚至能识别文档中残留的机器特定绝对路径。
2. 最小化改写策略：遵循"工具优先于 shell"的原则，优先采用 VS Code 工具工作流替代原始 shell 命令；若必须使用命令行，则转换为 PowerShell 5.1 兼容语法（如 export → $env:、rm -rf → Remove-Item），确保改动精准而非粗暴替换。
3. 智能输出管理：默认采用 _windows_ready 后缀创建兄弟输出文件夹，保护原始输入；若源为 zip 文件，自动重建并验证 Windows 就绪的压缩包，确保交付物完整性。
4. 交叉平台保留能力：在实现 Windows 兼容的同时，通过条件分支或并行脚本（.ps1 与 .sh 共存）保留原有 Unix/macOS 支持，避免生态割裂。
潜在缺点与局限性
- 依赖 PowerShell 环境：要求目标 Windows 系统具备 PowerShell 5.1+，对纯 CMD 用户或旧版 Windows 支持有限。
- 工具链缺口风险：若原 skill 深度依赖 Unix 独有工具（如
awk、sed复杂用法）且无 Windows 等效方案，只能标记限制而无法自动解决。 - 路径假设盲区：虽能检测硬编码绝对路径，但对动态生成的路径拼接逻辑（如字符串模板中的
/${user}）依赖静态分析，可能漏检。 - 非通用迁移工具：明确限定于 "agent skill" 领域，不适用于一般应用程序迁移，用户需自行判断输入范围。
适合人群
- 跨平台技能开发者：需维护同时面向 macOS/Linux 与 Windows 用户的 skill 作者。
- 企业 IT 迁移团队：将内部 Unix 环境下开发的自动化工具脚本向 Windows 工作站推广的运维工程师。
- 开源贡献者：接收社区贡献的 skill 但发现其仅在 bash 环境测试通过，需快速验证 Windows 可行性。
常规风险
- 运行时权限差异：Windows 缺乏 Unix 的执行权限位模型，转换后的
.ps1脚本可能因执行策略（Execution Policy）被拦截，需用户手动调整。 - 大小写敏感性冲突：Windows 文件系统默认不区分大小写，若原 skill 依赖大小写敏感的路径匹配（如
Configvsconfig），转换后可能出现意外行为。 - zip 重建一致性：当输入为 zip 时，需确保重建的压缩包根目录结构与原始 skill 一致，否则可能导致依赖路径解析失败。
- 残留绝对路径：文档或代码中硬编码的
C:\Users\username类路径若未被发现，将在其他机器上失效，该技能虽标记为高风险检查项，但仍需人工复核。