摘要：踩坑笔记躺在 wiki 里没人看，流程经验锁在老员工脑子里，CLAUDE.md 越堆越长 AI 却不读——流程知识需要一个 AI 在干活那一刻会自动取用的家。本文实战技能库自建全程：把真实踩坑记录提炼成第一份 SKILL.md（触发描述、步骤门禁的写法），真刀魔改 mattpocock/skills 上游技能并同步更新，再用版本管理与评审守住技能质量，把团队经验养成可复用的资产。本文要点（TL;DR）流程知识的三种死法：锁进脑子里、躺进笔记里、堆进 CLAUDE.md——全量注入不等于被使用，技能才是「按需取用」的家。三条准入标准：可重复、有固定步骤、有门禁。CLAUDE.md 是宪法，skill 是操作手册，ADR 是判决书；AI 自动记忆是日记——反复被违反的日记，该升职成技能。从笔记到 SKILL.md：四条踩坑记录合并成一个「分阶段计划」技能；description 写「什么时候用」而不是「它是什么」，决定触发率。魔改动真格：给 /grill-with-docs 动三处刀，记血统、分血统、最小魔改，上游更新三步跟上。技能是代码不是文档：进仓库、走评审、配冒烟用例、季度巡检退役。一、流程知识的三种死法交接周的最后一天，我整理离职同事留下的 wiki：一份《AI 编程踩坑笔记》躺在文档树的角落，最后一次编辑是十个月前。问接手的同事翻过没有，他摇头：「出事的时候，根本想不起来还有这份东西。」与此同时，仓库里的 CLAUDE.md 已经堆到两百多行——编码规范、提交流程、发布清单全塞在里面，每个会话开场全量注入，AI 的注意力被摊薄，真正要紧的几条硬约束反而被淹没。这就是团队流程知识的三种死法：锁进老员工脑子里，人走知识走；躺进笔记里，写了没人看；堆进 CLAUDE.md，全量注入不等于被使用。根因是容器选错了：笔记是写给人的，人不会在干活的那个瞬间去翻文档；CLAUDE.md 是常驻的，塞得越多，单条规矩的权重越低。流程知识真正需要的，是一个 AI 能在「恰好要用的那一刻」自动取用的家。前两篇我们把 mattpocock/skills 用顺了：技能让 AI 守团队的规矩，协作线让会话之间像队友。但用的始终是别人家的技能。这篇走完最后一公里：怎么把自家的踩坑经验写成新技能，怎么魔改不合身的上游技能，怎么用版本管理守住技能库——让技能库从「装别人的」变成「养自己的」。二、什么值得做成技能：先过三条标准不是所有知识都配叫技能。一条经验值不值得沉淀成 SKILL.md，先过三条标准：可重复——同样的事发生了三次以上。一次性任务写成 issue 或文档就够了；有固定步骤——能写出「第一步做什么、第二步查什么」。纯靠个人手感、写不出流程的知识，硬写成技能只会得到一份空洞的口号；有门禁——存在明确的「不过就停」的检查点。门禁是技能和鸡汤的分界线：步骤告诉 AI 怎么走，门禁保证它真的停下来检查。过了标准的，还要选对容器。五种容器的分工，一句话讲清：CLAUDE.md 是宪法，skill 是操作手册，ADR 是判决书，wiki 是图书馆，AI 自动记忆是 AI 自己的日记。容器加载方式适合放什么不适合放什么CLAUDE.md / AGENTS.md每次会话全量注入项目身份、环境说明、少数硬约束成套流程（挤占上下文，越全越没用）Agent Skill按需取用：名称与描述先亮，命中再读正文有步骤、有门禁的可复用流程一句话的偏好、一次性任务ADR（架构决策
