Matt Pocock 的 Agent Skills 详解：里面有什么，怎么安装

Matt Pocock（TypeScript 教育者，aihero.dev 创始人）把他每天真实在用的 agent skills 开源了，直接来自他自己的 .agents 目录。目标只有一个：让编码 agent 做真正的工程，而不是 vibe coding。这篇讲清楚仓库里有什么、为什么存在、怎么安装。

这个仓库是什么

mattpocock/skills（MIT 协议）是一组 agent skills——可复用的指令包，教编码 agent（Claude Code、Codex、Cursor 等）怎么做真正的工程，而不是 vibe coding。理念是：小而可组合的 skills，基于几十年的工程经验，而不是接管流程的框架。

为什么有这些 skills：4 种失败模式

Pocock 做这些 skills，是为了解决他反复看到的 4 种 agent 失败模式：

1. Agent 没按我想的做。 解法是"拷问环节"——写代码之前让 agent 先采访你。对应 /grill-me（以及 /grill-with-docs，还会顺手建项目的共享词汇表）。
2. Agent 话太多。 解法是共享语言——一份术语表，让 agent 用 1 个词代替 20 个词。
3. 代码跑不起来。 解法是反馈环：/tdd skill（红-绿-重构）和 /diagnosing-bugs skill（分阶段、有门禁的调试循环）。
4. 造出了一坨泥球。 Agent 加速写代码，代码腐烂也加速。解法是持续的设计投入，包括 /improve-codebase-architecture，定期扫描代码库找重构机会。

值得了解的 skills

• /grill-me — 最火的一个。对你的方案穷追猛打式提问，直到每个设计决策都敲定。每次改代码前都用它。
• /grill-with-docs — 拷问 + 顺手写 GLOSSARY.md 和 ADR。
• /tdd — 红-绿-重构循环，做功能修 bug 都用。
• /diagnosing-bugs — 复现 → 最小化 → 假设 → 插桩 → 修复 → 回归测试，分阶段推进。
• /code-review — 双轴 diff 评审（代码规范 + 是否忠实实现 spec）。
• /triage、/implement、/to-spec、/ask-matt — issue 分诊、spec 驱动实现，以及一个帮你选 skill 的路由器。

怎么安装

Claude Code（官方 marketplace 插件）：

claude plugins install mattpocock-skills

Codex 和其他 agent：

npx skills@latest add mattpocock/skills

然后每个仓库跑一次 /setup-matt-pocock-skills 配置 issue tracker 和约定。二选一，别两个都装，否则每个 skill 会有两份。

SkillStack 的位置

仓库本身免费且 MIT 协议，建议直接从源头安装。如果你想要 Pocock 的调试方法论做成开箱即用的精装包，SkillStack 上架了他的 /diagnosing-bugs skill——针对疑难 bug 和性能回退的分阶段诊断循环，附完整文档。

可以搭配我们的互补 skills：Systematic Debugging（日常 bug 的四阶段根因分析）和 Test-Driven Development（红-绿-重构纪律）。第一次配 Claude Code 的话，看这篇 MCP 接入指南。

适合谁

• 用 Claude Code、Codex、Cursor，想要 agent 遵循真实工程纪律的开发者
• 受够了 agent 又啰嗦又不写测试、代码越写越烂的团队
• 搜 "matt pocock skills" 想要 30 秒装好、不想看推销的人

不适合谁

• 完全不写代码的人——这是给编码 agent 的指令包
• 想要全托管流程（GSD、BMAD、Spec-Kit 那种）的人——Pocock 的哲学正好相反：小 skills，你自己拥有和改造