多 Agent 技能共享
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_6e8b625b/skill-sync-multi-agent。
技能介绍
要解决什么问题
如果你同时在 Knot、Codex、Claude、Gemini 等环境里用技能,默认每个 Agent 各自维护一份 skills/ 目录。装一次技能要复制多份,改一处也容易漏同步,目录里还会混进 .system 等非技能内容。
技能如何工作
本技能以 ~/.agent/skills/ 作为单一来源:所有技能文件只放在这里,其它 Agent 的 skills 目录里只创建指向该目录的软链接,不移动、不删除真实文件。
典型流程:
- 查看状态:确认各 Agent 目标路径当前是目录、软链还是缺失
- 全量或按需同步:一次同步全部支持的 Agent,或只指定例如
claude、codex - 预览:先 dry-run,看会创建哪些链接再执行
- 移除软链:只拆掉链接,源目录里的技能文件保留
支持的 Agent 与目标目录对应关系在技能说明中有表(如 ~/.codex/skills/、~/.claude/skills/ 等);knot 侧即主目录 ~/.agent/skills/。
适用边界与注意点
- 若目标位置已是真实目录(不是软链),脚本会跳过并警告,需你手动合并或改名后再同步
- 各 Agent 的
.system目录不会被同步 - 新技能装进
~/.agent/skills/后,再跑一次同步即可;若某 Agent 根配置存在但skills/不存在,脚本会先建目录;部分 Agent(如claude-internal)若无 skills 目录则可能自动跳过
使用场景
- 在 `~/.agent/skills/` 新装或更新技能后,需要让 Codex、Claude 等目录立即指向同一套文件,而不是再复制一份。
- 本机并行使用 codex 与 codex-internal(或 claude 与 claude-internal),希望一次维护、多处 Agent 都能加载相同技能。
- 执行同步前用预览模式查看将为哪些 Agent 创建软链,以及哪些目标因已是真实目录会被跳过。
- 准备停用某个 Agent 或重装环境时,只移除其 skills 下的软链接,不改动主目录里的技能文件。
适合人员
- 每天在 Knot、Codex、Claude 之间切换写代码,希望技能只装在 `~/.agent/skills/` 一处、各端自动对齐的工程师。
- 负责给团队维护 Agent 技能包,需要覆盖 Copilot、Gemini、Codebuddy 等多产品路径的本地环境维护者。
- 同步脚本报「目标为真实目录」后,需要弄清该 Agent 的 skills 路径现状并选手动合并或改名再同步的开发者。
- 刚接触 skill-sync 工作流、需要按 Agent 名单量同步或全量同步并定期复查链接状态的个人贡献者。