什么是Transfer Skill To Windows
Transfer Skill To Windows 是一款专为将现有代理技能适配到 Windows 环境而设计的工具。它主要解决跨平台技能在从 Unix/Linux/macOS 迁移至 Windows 时常见的兼容性问题，尤其适用于那些原本依赖 Bash、Unix 路径或 Linux/macOS 特有工具的代理技能。该工具接受两种输入：技能文件夹路径或包含技能内容的 zip 压缩文件，并输出一个可在 Windows 系统上直接运行的版本，同时尽量保留原始技能的逻辑流程和使用意图。默认情况下，它会生成一个与源文件并列的新副本（如 `_windows_ready`），以确保原始文件不被修改，便于对比和回滚。 该工具的核心优势在于其精准的问题识别与最小化修改原则。它不会进行大规模重构，而是聚焦于检测并修复导致 Windows 不兼容的关键假设，例如硬编码的 Unix 绝对路径、仅适用于 bash 的命令示例、权限控制脚本以及机器特定的导入路径。通过自动替换 `export` 为 PowerShell 变量语法、`rm -rf` 为 `Remove-Item -Recurse -Force` 等操作，确保命令在 Windows 环境下可执行。此外，它还支持交叉平台兼容性判断，允许用户选择是否保留对 Linux/macOS 的支持，或在必要时添加 Windows 专属说明而不破坏原有文档结构。 整个过程分为七个阶段：加载技能内容、盘点 Windows 风险点、制定转换策略、重写代码与文档、更新辅助文件、验证结果并汇报成果。其中特别强调对 `SKILL.md` 文件的深度解析，因为它是技能行为的主要描述载体。工具会检查其中的命令行示例、路径引用、工具依赖等内容，并将其改写为 PowerShell 等效表达。若输入为 zip 文件，最终还会重新打包生成一个可直接用于部署的 Windows 就绪压缩包，并验证其完整性。整个流程透明可控，最终交付物不仅能在 Windows 上运行，还能保持与原技能一致的功能语义。
核心功能特点
- 支持技能文件夹或 zip 文件作为输入，自动识别技能根目录
- 智能检测 Unix 专属命令与路径假设，如 bash 脚本、/tmp 绝对路径
- 将 Shell 命令转换为 PowerShell 等价实现，保留原语义
- 自动修复机器特定路径引用，避免硬编码 C:\Users\ 等本地路径
- 可选生成独立 Windows 就绪副本，保护原始技能不受影响
- 若输入为 zip，则重建并验证 Windows 兼容的压缩包
适用场景
Transfer Skill To Windows 最典型的应用场景是将一个原本设计用于 Linux 或 macOS 环境的代理技能快速移植到 Windows 平台。例如，某个技能使用 `bash` 脚本批量处理日志文件，并通过 `grep` 和 `sed` 提取关键信息，但在 Windows 默认环境中这些命令无法直接运行。此时，该工具能将其中的 `grep pattern file` 替换为 `Select-String -Path file -Pattern pattern`，并将路径示例从 `/var/log/app.log` 改为相对路径或 Windows 标准格式，使技能在 PowerShell 下即可正常工作。这种场景常见于团队协作中，开发者希望让非 Unix 环境的同事也能顺利使用该技能，而无需手动逐行修改文档和脚本。 另一个典型用例是处理由他人分发但尚未适配 Windows 的技能包。这些技能可能以 zip 形式发布，内部包含 `.sh` 脚本、`package.json` 配置及详细的 `SKILL.md` 说明。由于缺乏 Windows 支持，用户在尝试运行时常遇到‘找不到命令’或‘路径错误’等问题。该工具能够解压分析结构，定位核心技能模块，然后统一替换所有 Unix 指令为 PowerShell 版本，同时调整模板中的路径分隔符和临时目录引用。完成后，不仅生成可直接使用的技能文件夹，还重新打包成 zip，方便后续分发。这使得跨平台的技能生态得以无缝扩展，降低了技术门槛。 此外，该工具也适用于维护阶段的主动审计与迭代优化。当发现已有技能在新机器上出现路径错乱或依赖缺失时，可以调用此工具进行一次深度清理：移除残留的机器名（如 `C:\Users\Alice\Documents`）、标准化所有示例为相对路径、补充必要的 Windows 注意事项。即使技能本身并非专为 Windows 设计，只要其逻辑不依赖底层系统特性，就能通过最小改动实现良好兼容。因此，它不仅是一个迁移工具，更是一种保障技能健壮性和可移植性的工程实践手段。