把 Claude Code 斜杠命令迁移为可移植…

当需要把 .claude/commands/*.md 斜杠命令转换成跨 AI 运行时通用的 skills/*/SKILL.md 格式时使用。

适用场景

解决思路

1. 读取源命令文件：从 .claude/commands/ 读取待转换的命令文件；若未提供源路径，先向用户询问源命令文件路径。
2. 提取元数据：从 YAML frontmatter 中取出 description、handoffs（相关技能/后续步骤），以及 $ARGUMENTS 的输入处理方式。
3. 确定技能名：把 command.name.md 转为 command-name（点替换为连字符），多词名称使用 kebab-case。
4. 创建技能目录：新建 skills/<skill-name>/ 目录。
5. 转换内容为 SKILL.md 格式：frontmatter 只保留 name 和 description；把 description 扩展为包含何时使用该技能；把 $ARGUMENTS 改写为 Inputs 章节；把命令步骤抽取为编号的 Workflow 章节；根据命令上下文和描述补充 When to Use 章节；补充 Outputs 章节列出生成的文件/产物；把 handoffs 转换为引用相关技能的 Next Steps 章节。
6. 移除运行时特定内容：删除带 $ARGUMENTS 代码块的 ## User Input 章节；从 frontmatter 移除 handoffs（改为散文形式）；删除 /command.name 形式的引用，改用技能名。
7. 校验技能结构：确认 frontmatter 只有 name 和 description；正文包含清晰章节（When to Use、Inputs、Workflow、Outputs）；没有遗留 TODO 占位符；没有 $ARGUMENTS 等运行时特定变量。
8. 按转换规则映射：$ARGUMENTS → 描述预期用户输入的 Inputs 章节；handoffs: → 引用技能的 Next Steps 章节；/command.name → kebab-case 的 skill-name；agent: foo.bar → foo-bar 技能引用；frontmatter 的 description: → 扩展加入触发条件的 description；内联 ## User Input → 删除并记录到 Inputs。
9. 报告转换结果：列出源命令路径、生成的技能路径、应用的关键转换，以及需要人工复核的建议。
10. 转换后收尾：复核生成的 SKILL.md 是否完整；删除 scripts/、references/、assets/ 中未使用的示例文件；如适用更新 AGENTS.md/CLAUDE.md 的技能清单；按需创建符号链接以集成到运行时。

适用边界 · 注意事项

• 源命令包含无法脱离 Claude Code 运行时语义的复杂 handoffs 或专有变量时，直接自动转换可能丢失逻辑，需人工介入。
• 目标运行时并不支持标准 Agent Skills 格式时，转换后仍需额外适配。
• 命令逻辑高度依赖 $ARGUMENTS 的即时注入行为时，改写为 Inputs 章节可能改变原有交互语义。