（3966期）Transfer Skill To Windows – Unix Skill 一键 Windows 化迁移工具

Unix Skill 一键 Windows 化迁移工具 将 Unix 风格的 AI Skill 自动转换为 Windows 兼容版本，保留原始工作流意图的同时最小化改动，支持文件夹或 zip 输入。 使用说明 核心用法 transfer-skill-to-windows 是一款面向开发者的技能迁移工具，专注于将基于 Unix/Linux 设计的 AI agent skill 快速适配到 Windows 环境。该技能接受两种输入形式：技能文件夹路径或包含 skill 的 zip 压缩包，通过系统化的检测与改写流程，输出 Windows 就绪的版本。 显著优点 精准的风险检测机制：内置详尽的 Windows 不兼容项检查清单，涵盖 bash 命令、Unix 路径（如 /tmp/、/usr/local/）、文件权限操作（chmod）、管道符号（&&）等 20 余类常见陷阱，甚至能识别文档中残留的机器特定绝对路径。 最小化改写策略：遵循"工具优先于 shell"的原则，优先采用 VS Code 工具工作流替代原始 shell 命令；若必须使用命令行，则转换为 PowerShell 5.1 兼容语法（如 export → $env:、rm -rf → Remove-Item），确保改动精准而非粗暴替换。 智能输出管理：默认采用 windowsready 后缀创建兄弟输出文件夹，保护原始输入；若源为 zip 文件，自动重建并验证 Windows 就绪的压缩包，确保交付物完整性。 交叉平台保留能力：在实现 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 依赖大小写敏感的路径匹配（如 Config vs config），转换后可能出现意外行为。 zip 重建一致性：当输入为 zip 时，需确保重建的压缩包根目录结构与原始 skill 一致，否则可能导致依赖路径解析失败。 残留绝对路径：文档或代码中硬编码的 C:\Users\username 类路径若未被发现，将在其他机器上失效，该技能虽标记为高风险检查项，但仍需人工复核。 原始说明 Adapt an existing agent skill so it works cleanly on Windows when the input is either a skill folder path or a zip file.