Skill 版本管理：团队共享的菜谱，也要进 git
本条目是「Skill Engineering」的第 13 部分，对应学习清单条目 4.6.3。
为以下铺垫：多工具协同、Loop Engineering
一、核心观点
Skill 落地 git，写版本号，每月 review 一次。 一条过时的 Skill 规则，比没有 Skill 还害人——它会在你不知情时，稳定地教 Agent 做错事。
Skill 像团队共享的菜谱：改了要 commit，要标版本，要定期尝尝还合不合口味。没人想照着一份写着「加盐两勺」、但厨房三年前就换了低钠盐的菜谱做菜。模型、工具、项目都在变，Skill 不维护就会悄悄变成「精确的谬误」。
二、定义 / 原理 / 实践 / 示例 / 优劣势
2.1 定义
Skill 版本管理 = 用 git 追踪变更、用语义化版本号标记演进、定期 review 清理过时内容。
2.2 原理：为什么「过时 Skill」比「没有」更糟
没有 Skill，Agent 靠通用能力；有一条过时 Skill，Agent 会被「权威文件」带偏且你难以察觉。所以 review 不是锦上添花，是安全绳。
2.3 实践：四步法
flowchart TD A[写 Skill → git commit] --> B[标 version 语义化版本] B --> C[每月 review 一次] C --> D[更新工具版本/优化 Gotchas/清理] D --> A
-
落地 git：
git add .claude/skills/ && git commit -m "feat: 添加 code-review skill" -
版本号：
version: 1.2.0（主.次.修订 = 重大.功能.bug 修复） -
每月 review：查过时内容、更新工具版本（mypy/ruff）、优化 Gotchas、清理无用 Skill
-
引用其他 Skill：用纯文本 Skill 名，不用 markdown 链接（跨 Skill 调用解析易错）
2.4 示例：review 清单
# Skill Review 清单（每月）
- [ ] 检查过时内容（模型/工具/项目已变？）
- [ ] 更新工具版本（mypy、ruff 等）
- [ ] 优化 Gotchas（新踩的坑补进去）
- [ ] 清理无用 Skill
- [ ] 更新 version
2.5 优劣势
-
✅ 可回滚、可协作、能发现过时；Skill 随时间变强而非变朽
-
❌ 需要纪律（每月 review 容易被拖）
三、最新研究与企业数据（2025–2026）
-
官方支持 Skill 版本化（一手）：Anthropic 在发布 Agent Skills 时同步推出
/v1/skills端点，给开发者「对自定义 Skill 进行程序化版本控制与管理」的能力（anthropic.com/news/skills）。这说明版本管理是官方一等公民，而非野路子。 -
开放分发需版本（一手）：Agent Skills 已作为开放标准跨工具分发，版本号是跨工具消费 Skill 时的兼容性契约（skill.md）。
四、学习资源
五、相关链接
-
跨系列（收尾）：Harness Engineering（Skill 是 Harness 层组件）· 四层嵌套关系
-
系列清单：Agent 方法论与产品思维学习路线图
六、核心要点
-
🎯 Skill 落地 git + 语义化版本号 + 每月 review；过时 Skill 比没有更糟。
-
💡 引用其他 Skill 用纯文本名，别用 markdown 链接（跨 Skill 解析易错）。
-
⚠️ review 是安全绳不是装饰：模型/工具/项目在变，Skill 不维护就变「精确谬误」。
参考来源（一手链接 · 可溯源深挖）
-
Anthropic (2025-12-18)《Introducing Agent Skills》（
/v1/skills端点支持程序化版本管理）：anthropic.com/news/skills -
Agent Skills 开放标准（跨工具分发需版本契约）：skill.md
-
Anthropic Agent Skills 文档：docs.anthropic.com/en/docs/agents-and-tools/agent-skills
速记卡（面试闪卡）
Q1：一句话讲清「Skill 版本管理：团队共享的菜谱，也要进 git」到底是什么？
A：Skill 落地 git、标语义化版本号、每月 review，过时 Skill 比没有更危险。
Q2：一、核心观点 —— 怎么理解？
A：团队共享的菜谱要 commit、标版本、定期尝味：厨房三年前换了低钠盐，照着「加盐两勺」的老菜谱做菜只会害人。Skill 也一样，模型、工具、项目在变，不 review 就会变成精确的谬误。
Q3：二、定义与四步法 —— 怎么理解？
A：版本管理（Version Control，用 git 记录每次改动）像给菜谱建修订史：主.次.修订对应重大.功能.bug 修复。四步法循环：写 Skill→commit→标 version→每月 review→优化 Gotchas→回到写。可回滚、可协作，代价是每月 review 的纪律。
Q4：三、官方背书与开放标准 —— 怎么理解？
A：Anthropic 发布 Agent Skills 时同步推出 /v1/skills 端点（Endpoint，程序化接口），让开发者能对自定义 Skill 做版本控制——版本管理是官方一等公民。Skills 还成了开放标准（Open Standard，跨工具通用规范），版本号就是跨工具消费 Skill 的兼容性契约。
Q5：四、引用与小结 —— 怎么理解？
A：引用其他 Skill 用纯文本名而非 markdown 链接（跨 Skill 解析易错）。一句话收尾：Skill 进 git 是安全绳不是装饰，三月不 review，精确的规则就腐烂成精确的谬误。
Q6：核心速记主线有哪些？
-
Skill 进 git + 语义化版本号 + 每月 review，三者缺一不可
-
过时 Skill 比没有更糟：会被权威文件带偏且难察觉
-
四步循环：commit → version → review → 优化 Gotchas
-
引用其他 Skill 用纯文本名，别用 markdown 链接
口诀
A：Skill 进 git，版本号标清；
每月尝一尝，过时最害人。
引用用纯名，别用链接拼；
菜谱常更新，才不做错菜。