宝玉分享了他维护 baoyu-skills 的团队协作经验，核心是三点。

1. Git 管理是必须的

Skills 本质上是 Markdown + 脚本文件，天然适合 Git 版本控制。改了什么、谁改的、什么时候改，全部可追溯。出了问题直接查 commit history 定位或回滚，比"我记得上次改过"靠谱得多。

2. 用 Symlink 而不是拷贝

不要把 Skills 整个复制到 .agents/skills，用 Symlink 链接到原始 Repo。

好处：

  • 版本控制干净：不会产生重复副本，Repo 里的版本就是唯一版本
  • Agent 直接改 Repo：使用中发现问题，Agent 在当前会话里改的就是 Repo 本身，改完直接提 PR，流程顺滑

坑：

  • Windows 不支持 Symlink
  • 首次配置稍麻烦（但可以让 Agent 帮你操作）

3. Agent 编辑 + PR 流程是最小协作单元

Skills 的 Markdown 部分验证困难——没有自动化测试，主要靠积累的测试集加人工review。但配合 Git 流程，快速迭代反而更现实：不怕改出问题，出了就看 commit history 定位或回滚。

重要提醒：Skills 尽量跟着项目走，放到项目目录的 .agents/skills，不要放全局 ~/.agents/skills。原因：即使渐进式加载，meta 信息累积起来也会占用不小的上下文空间。