用途:将本地来源的 Agent 技能(claude-toolkit 插件、.claude/skills/、.claude/commands/)统一整理进 dogfooded-skills 库,然后作为独立本地技能导入回项目。适用于把 claude-toolkit 中经过验证的技能合并进共享库、把仅本地使用的技能放入库中跨项目复用,或替换工具包符号链接为 dogfooded-skills 副本。
前置条件:dogfooded-skills 仓库已克隆(ls ~/Projects/fellowship-dev/dogfooded-skills/skills/),且 gh auth status 显示可推送。
工作流程:以 <skill-name> 为参数,先查找全部来源,包括工具包插件技能 .claude/plugins/claude-toolkit/skills/<skill-name>/SKILL.md、工具包命令 .claude/plugins/claude-toolkit/commands/<skill-name>.md、本地技能 .claude/skills/<skill-name>/(可能为符号链接)。读取全部来源,将命令(薄封装)与技能(完整内容)合并为单个 SKILL.md,遵循 skill-builder 标准:frontmatter、一行用途、When to Use、Prerequisites、含真实命令的 Workflow、Decision Tables、Error Handling、Critical Rules。随后写入 ~/Projects/fellowship-dev/dogfooded-skills/skills/<namespace>/<skill-name>/SKILL.md,并在 README.md 对应分类表中新增一行。接着提交推送:git add skills/<namespace>/<skill-name>/SKILL.md README.md、git commit -m "feat: add <skill-name> skill — migrated from claude-toolkit"、git push origin main。然后编写清理脚本到 /tmp/migrate-<skill-name>.sh 并执行,用于绕过 .claude/ 路径的沙箱限制:脚本删除工具包中的技能与命令、删除陈旧的符号链接或旧本地副本、从 dogfooded-skills 复制回 .claude/skills/<skill-name>/SKILL.md。最后验证:ls -la .claude/skills/<skill-name>/SKILL.md 与 head -6 .claude/skills/<skill-name>/SKILL.md。
关键规则:先阅读 skill-builder 标准,合并后的技能须满足 dogfooded-skills 质量标准;清理脚本放在 /tmp 是绕过 .claude/ 路径沙箱的唯一方式;不得留下孤立符号链接,创建新目录前先删除;若工具包是带独立远程的子模块,工具包变更需单独提交。
限制:资料未提供迁移规模、失败回滚、命名空间选择规则等细节。