mattpocock/skills：把工程纪律装进 AI 代理的 Shell 技能包

它解决的是代理听话的问题，不是代码生成的问题

mattpocock/skills 是一个收集了 Matt Pocock 日常使用的 AI 代理技能的仓库，主要面向 TypeScript、测试、调试和日常软件工作。它的出发点很具体：代理最常见的失败模式不是写不出代码，而是写出来的东西和你想要的不是一回事。仓库里引用了《程序员修炼之道》的一句话：没有人确切知道自己想要什么。所以它的核心手段是盘问，用 /grill-me 和 /grill-with-docs 这两个技能让代理在动手前先向你提出详细问题。这听起来像流程负担，但 Matt 的立场是，与其让代理在错误方向上跑一个小时，不如先花十分钟对齐。这个仓库的目标用户是那些已经在用 Claude Code、Codex 等编码代理，但发现它们经常跑偏的工程师。不是给新手用的，新手可能连代理的基础操作都没掌握。

从盘问到共享语言，机制是层层递进的

仓库里的技能不是一堆零散的提示词，而是按问题域组织的一套流程。第一层是 /grill-me，用于非代码场景的盘问，让代理在开始前澄清需求。第二层是 /grill-with-docs，它在盘问的基础上增加了文档生成，帮助建立共享语言。共享语言这个机制值得细说：代理刚进入项目时，往往要自己摸索行话，结果就是用了 20 个词表达 1 个词能说清的事。解决方案是生成一份 CONTEXT.md，把领域术语固定下来。仓库给了一个例子，从「课程中某个部分里的课程被设为真实时出了问题」压缩成「materialization cascade 级联存在问题」。这种术语一旦建立，代理在后续会话中命名变量、函数和文件时都会保持一致，token 消耗也会下降。再往后是反馈循环，仓库主张静态类型、浏览器访问这类手段，让代理能感知到代码实际运行的结果，而不是盲写。整个机制的核心是让代理的行为可预期，而不是依赖某个模型的魔法。

安装有两条路，哲学完全不同

README 提供了两种安装方式，对应两种使用哲学。第一种是 Claude Code 插件，命令是 claude plugins install mattpocock-skills，或者从会话内执行 /plugin install mattpocock-skills。这个方式安装的是托管、只读的捆绑包，Matt 每次更新你都会自动收到，属于订阅制。第二种是 npx skills@latest add mattpocock/skills，它会让你选择要安装哪些技能，以及装到哪些编码代理上。这种方式把技能文件复制到你的仓库里，变成普通文件，你可以随意修改。README 特意警告：不要两种都装，否则每个技能会出现两份。对于想折腾的人，npx skills 是唯一选择，因为它把控制权交给你。安装完成后，需要运行 /setup-matt-pocock-skills，它会询问你使用哪个问题跟踪器（GitHub、Linear 还是本地文件）、你给工单打什么标签（/triage 会用到），以及文档保存位置。这一步是必须的，跳过它技能就跑不起来。

可组合性是卖点，也是潜在陷阱

Matt 在 README 里反复强调这些技能是「小、易适应、可组合」的，并且和任何模型都能配合。这听起来不错，但可组合意味着你需要自己理解每个技能的作用，才能决定怎么搭配。比如 /grill-with-docs 依赖 CONTEXT.md 和 ADR 文件，如果你不熟悉 ADR（架构决策记录）的写法，这个技能生成的东西可能不符合你的预期。另外，技能是 Markdown 文件，理论上你可以随意编辑，但这要求你愿意投入时间维护它们。如果你只是想要一个开箱即用的代理，那这个仓库会显得琐碎。它更像是一套工程实践模板，而不是一个自动化工具。还有一个实际问题：npx skills add 会列出可选技能，README 特意提醒要确保 setup-matt-pocock-skills 被选中，否则整个流程会断在初始化阶段。这说明技能之间是有依赖关系的，不是每个都能独立运行。

和 GSD、BMAD 之类的方案比，它选择放弃控制权

README 明确提到了 GSD、BMAD 和 Spec-Kit 这些方案，说它们试图拥有整个流程，但这样做会夺走你的控制，让流程中的 bug 难以解决。mattpocock/skills 的立场是反过来的：它把流程拆成小块，让你自己掌握。GSD 这类方法通常提供一套完整的端到端工作流，从需求到实现都有固定步骤，你只需要跟着走。而 Matt 的技能是让你在关键节点介入，比如盘问阶段、建立共享语言阶段，其余时候代理自由发挥。这种差异在实际使用中很明显：如果你喜欢强流程保障，GSD 可能更合适；如果你觉得流程束缚了代理的灵活性，那这套技能更对你胃口。但要注意，放弃控制也意味着你要更主动地维护 CONTEXT.md 和 ADR，否则共享语言会过期。

维护成本和许可证，你需要知道的

仓库采用 MIT 许可证，这意味着你可以自由复制、修改和分发技能文件，甚至商用，只要保留版权声明。维护成本取决于你选择的安装方式。用 Claude Code 插件的话，更新是自动的，你不需要管，但代价是你不能修改技能内容，如果 Matt 的更新改变了某个技能的行为，你可能需要重新适应。用 npx skills 方式，技能文件落在你的仓库里，你可以改，但更新需要手动执行 npx skills update，而且如果你做了本地修改，更新时可能会产生冲突。README 没有详细说明冲突处理机制，但从文件复制的方式推测，你需要在更新前合并自己的改动。另外，仓库最近有多个版本发布（v1.2.0 到 v1.2.3），说明迭代很快，这既是好事也是负担，频繁更新可能带来行为变化。

编辑结论

mattpocock/skills 适合那些被 AI 代理反复带偏、又不想被重型流程框架锁死的工程师。它用可编辑的 Markdown 技能文件把盘问、共享语言和反馈循环变成可复用的命令，这在 Claude Code 和 Codex 上都能跑。但如果你需要的是一个开箱即用、无需调教的完整解决方案，或者你的项目没有明确的领域术语需要统一，这套技能可能显得过度。采用前先验证两件事：一是确认 /setup-matt-pocock-skills 会写入的 CONTEXT.md 和 ADR 文件是否符合你团队的文档规范，二是检查 npx skills add 选择的技能列表是否包含 setup-matt-pocock-skills，否则流程会断在第一步。

官方来源

1. Official README
2. Project repository
3. Release notes