mattpocock/skills：给真工程师的技能集

这是 Matt Pocock（Total TypeScript 作者）直接从自己 .agents 目录里搬出来的 agent 技能集，副标题很直白：做真正的工程，而不是 vibe coding。他的判断是 GSD、BMAD、Spec-Kit 这类框架把整个流程接管了，代价是你失去控制权、流程一出 bug 就很难排查；所以这套技能刻意做得小、好改、可组合，也不绑定模型。

仓库围绕四个常见失败模式组织：一、Agent 没做你想要的——用 /grill-me 和 /grill-with-docs 在动手前把你反复拷问一遍，把设计树的每个分支都问清楚，这也是仓库里最受欢迎的两个技能。二、Agent 太啰嗦——用 CONTEXT.md 建一套项目共享语言（"materialization cascade" 胜过一整句解释），命名更一致、思考更省 token。三、代码跑不起来——/tdd 强制红绿重构，/diagnosing-bugs 把调试拆成逐阶段闸门的纪律化循环。四、写成了一团泥球——/to-spec 在出方案前先问你动了哪些模块，/improve-codebase-architecture 定期扫描代码库、把"可以做深的模块"候选交到你手上（注意它是体检报告，不是重构机器）。

技能按调用方分成两类：user-invoked 只有你输入斜杠命令才会触发，负责编排流程（/ask-matt、/triage、/implement、/wayfinder）；model-invoked 则可以由 agent 在任务匹配时自行取用，装的是可复用的纪律（/tdd、/codebase-design、/code-review、/writing-for-agents）。除工程类外还有 productivity 一组：/handoff 压缩会话交接、/teach 多轮教学、/wait-what 在你听不懂时用自己项目的词汇重讲一遍。

两种装法对应两种哲学：Claude Code 插件（`claude plugins install mattpocock-skills`）是订阅制，只读、作者更新后自动同步；`npx skills@latest add mattpocock/skills` 则把技能文件复制进你的仓库，随便改成自己的。两种别同时装，否则每个技能都会出现两遍。装完在每个仓库跑一次 /setup-matt-pocock-skills，配置 issue 追踪器（GitHub / Linear / 本地文件）、triage 标签和文档存放位置。适合已经有真实项目要维护、且受不了 agent 越写越乱的工程师。