用途:把现有技能从 .claude/skills/{name} 迁移到统一的 .agents/skills/{name} 目录,同时在 .claude/skills/ 与 .codex/skills/ 下建立指向新位置的符号链接,使同一份技能实体被多个工具目录共享。
主要能力:接收技能名参数,执行 scripts/migrate.sh;迁移前校验源目录存在且为真实目录(非符号链接)、目标 .agents/skills/{name} 尚不存在、避免重复链接。迁移后结构为 .agents/skills/{name}/ 作为实体,.claude/skills/{name} 与 .codex/skills/{name} 均为指向 ../../.agents/skills/{name} 的符号链接。
使用方式:命令行传入技能名与可选项目根路径:bash scripts/migrate.sh <skill-name> [project-root]。skill-name 为必填,指待迁移技能目录名;project-root 省略时使用当前目录。例如:bash /path/to/migrate-skill-to-agent/scripts/migrate.sh intent-based-dedup /path/to/project。
工作流程:先获取技能名参数,进行源存在性、既有链接、目标重复等校验,再以项目根为第二参数运行脚本,最后报告结果。
适用场景:需要把 Claude 侧的技能统一归档到 .agents 并同时供 .codex 复用的项目。
限制:源目录必须为真实目录,目标不得已存在;若 .claude/skills/{name} 已是符号链接或目标已占用则无法迁移。具体参数、错误处理与回滚方式资料未进一步提供。