团队内的 skills 管理和维护的一点经验分享

公众号名称：宝玉AI

发布时间：2026-04-10 02:09

团队内的 skills 管理和维护的一点经验分享（以 codex cli 用的 .agents/skills 目录为例）：

1. Git 管理是一定要的。
版本控制太重要了，而且 Skills 都是 Markdown 和脚本文件，天然适合 Git。

2. 用好 Symlink。
不要把 Skills 整个拷贝到 .agents/skills，而是通过 Symlink 直接链接到原始 Skills 的 Repo。

好处有两个：一是版本控制更干净；二是使用中遇到问题，Agent 定位后可以直接在 Repo 里改，改完就能 Review 提 PR。

我日常维护 baoyu-skills 就是这么干的，用的时候发现问题，让 Agent 在当前会话改，改的就是 Repo 本身，流程非常顺。

主要的坑是 Windows 下好像不支持 Symlink，另外首次配置稍麻烦（可以让 Agent 帮你操作）。

3. Skills 的编辑优先让 Agent 来。
改完走 Git 提 PR，这就是最好的协作和发布流程。

4. 验证确实不太好做。
脚本部分可以写单元测试，Skill 的 Markdown 部分只能靠平时积累的测试集，大部分还得人工。
但配合 Git 的版本管理，快速迭代反而更现实：不怕改出问题，出了问题根据 commit history 快速定位，或者直接回滚。

5. 最后提醒一下：大部分 Skills 应该跟着项目走（放项目目录下的 .agents/skills），不要放全局（～/.agents/skills）。
即使是渐进式加载，meta 信息累积起来也会占不小的上下文空间。

图1：

图2：

图3：

图4：

图5：

图6：

图7：

---

内容效果不满意？点此反馈