软件基本功比以往任何时候都更重要：Matt Pocock 的 Claude Code 技能集

一个被 specs-to-code 浪潮淹没却仍冷静的人

2026 年是 AI 编程「specs-to-code」叙事的高光年——写规约、跑编译器、不看代码、再写规约、再跑编译器。社区里冒出来的口号是「code is cheap」（代码很便宜），意思是：反正 AI 一秒能再生成一万行，要它干嘛在意。

Matt Pocock 是少数公开站出来反驳这件事的人。他不否认 AI 写代码很猛，但他在自己开的课《Claude Code for Real Engineers》里实测了 specs-to-code，结论很扎心：每跑一次，代码反而越来越烂。这正是 Pragmatic Programmer 里早就讲过的「software entropy」——软件熵增。

于是他做了两件事：

1. 把这个观察打包成一场 18 分钟的演讲：Software Fundamentals Matter More Than Ever。
2. 把对应的解药打包成一个 GitHub 仓库：mattpocock/skills ——「Skills for Real Engineers. Straight from my .claude directory.」

仓库 2026 年 2 月 3 日上线，4 个月之内冲到 61.1k star、5.3k fork，是同期 AI 编程类仓库里增长最快的几个之一。

Matt Pocock 是谁

如果你写过 TypeScript，大概率刷到过他。他是这几年中文圈和英文圈最高产的 TypeScript 教育者之一：

• TotalTypeScript.com 创办人，一系列付费课程在英文圈流传度极高
• aihero.dev Newsletter 6 万+ 订阅，主题从 TS 转到了 AI Coding
• Twitter @mattpocockuk、YouTube @mattpocockuk 上有大量短视频教程
• 不是 OpenAI/Anthropic 的人，纯独立开发者+教育者背景

他的人设很清晰：资深工程师视角看 AI Coding。不喊「AGI 来了」，也不喊「程序员要失业了」。喊的是「老一辈软件工程师那些招还很有用，只是需要翻译成 LLM 能执行的形式」。

核心论点：代码不便宜

整场演讲只有一个论点，每个 skill 都是它的注脚：

如果你的代码库结构很烂，AI 在烂代码库里也只会写出烂代码。所以好代码库比以往任何时候都重要，软件基本功比以往任何时候都重要。

Matt 用了一个军事类比把人和 AI 的角色定位讲得很直白：

战略层做什么？设计概念、统一语言、模块边界——这三件事都是「定义问题」而非「写代码」，恰好也是 LLM 最不擅长替你做的。

五个失败模式 → 五本老书 → 五个 Skill

Matt 演讲里把整套方法论压缩成一张映射表。你每碰到一个失败模式，他都给你指回 20 年前就解决了的经典理论，再给你一个 Markdown 格式的 Skill 文件：

第五条在 repo 里没有单独的 skill（曾有 design-an-interface 但已废弃），它的精神被吸收进了 /to-prd 和 /improve-codebase-architecture——两者都强迫你在写代码前先思考模块接口。

真正每天用的 5 个 Skill

演讲是哲学骨架，Matt 后来在 aihero.dev 上发了一篇《5 Agent Skills I Use Every Day》，把骨架翻译成日常工作流。这 5 个就是这个系列后续要逐个拆解的对象：

/grill-me                       ← 先和 AI 谈清楚要做什么
        ↓
/to-prd                         ← 把对话凝固成 PRD
        ↓
/to-issues                      ← 把 PRD 切成可独立领取的 vertical slice
        ↓
/tdd                            ← 每个 slice 用红绿重构跑通
        ↓
/improve-codebase-architecture  ← 周期性检查，把 shallow 模块改成 deep

这 5 个 skill 串起来就是 Matt 自己的完整研发流程。每一步对应的失败模式见上一节的表。

每篇详细拆解（这个系列的后续页面）：

• Setup Matt Pocock Skills：先把项目规则写清楚
• Grill Me：让 AI 拷问你需求
• Grill With Docs：维护项目语言和 ADR
• to-PRD + to-Issues：从对话到可执行 ticket
• Diagnose 与 Triage：先建立反馈回路，再决定交给谁
• TDD：用红绿重构强迫 AI 走小步
• Zoom Out：当你迷路时，让 AI 先画地图
• Prototype：用可丢弃代码回答一个设计问题
• Improve Codebase Architecture：把 shallow 重构成 deep modules
• 其他 Skills：压缩沟通、交接、教学、写 Skill 与安全护栏

怎么装

仓库 README 里给了一行命令的安装方式：

npx skills@latest add mattpocock/skills

这条命令会：

1. 让你勾选要装哪些 skill
2. 让你勾选要装到哪些 agent（Claude Code、Codex、Cursor 等都支持）
3. 把对应的 SKILL.md 文件放进 .claude/skills/（或 agent 对应的目录）

强烈建议同时勾选 /setup-matt-pocock-skills——这是一个一次性配置 skill，会问你三个问题：

• Issue tracker 用什么？（GitHub / GitLab / 本地 markdown / 其他）
• Triage label 用什么词？（needs-triage 还是其他）
• Domain doc 放哪？（CONTEXT.md / ADR 路径）

跑一次 /setup-matt-pocock-skills，它会写到你项目根目录的 AGENTS.md 或 CLAUDE.md，之后所有 engineering 类 skill（to-prd、to-issues、triage、tdd 等）都会自动读取这份配置。这一步省了，后面每个 skill 都会反复问你同样的问题。

如果你只想试 /grill-me（最轻量、纯 productivity 类），可以跳过 setup，因为它不依赖 issue tracker。

这套 skill 和 BMAD / Spec-Kit / GSD 的区别

如果你已经在用 BMAD、Spec-Kit、GSD 这类 spec-driven 框架，可能会问：「为啥还需要 Matt 这套？」

Matt 在 README 里写得很直接：

核心差异：

• BMAD/Spec-Kit/GSD 是框架，规定了从 spec 到 code 的完整流水线，你要按它的流程走
• Matt 这套是散件，每个 skill 一个 markdown 文件，几行到几十行，你随时拆开改

例子：grill-me 的实际全文只有这么短——

Interview me relentlessly about every aspect of this plan until we reach
a shared understanding. Walk down each branch of the design tree,
resolving dependencies between decisions one-by-one. For each question,
provide your recommended answer.

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the
codebase instead.

整个 skill 7 行。但就是这 7 行让 Claude 在做决策前会问你 20、50 甚至 100 个问题。这种用极少文本撬动大行为变化的设计哲学，是这套 skill 流行的根本原因。

这个系列怎么读

如果你之前没接触过 Matt 这套，建议按 meta.json 里的顺序顺读：

1. Overview（你现在在的这篇）—— 了解全貌
2. Setup Matt Pocock Skills —— 先把 issue tracker、标签和领域文档位置写成项目契约
3. Grill Me —— 单装一个先体验，门槛最低
4. Grill With Docs —— grill-me 的进阶版，开始引入 CONTEXT.md
5. to-PRD + to-Issues —— 把对话变成可执行 ticket
6. Diagnose 与 Triage —— 处理 bug 和 issue 状态流转
7. TDD —— Matt 自己说「我用过的最稳定提升 agent 输出质量的方法」
8. Zoom Out —— 陌生代码先画地图
9. Prototype —— 用可丢弃代码回答设计问题
10. Improve Codebase Architecture —— 周期性维护，让 AI 长期可用
11. 其他 Skills —— caveman、handoff、teach、write-a-skill 和几组安全/课程工具

如果你已经在用 Claude Code 写真实项目，直接跳到 /grill-me + /tdd 这两篇，体感最强。

如果你做的是教学或写作，只读 /grill-me 一篇就够了——它是个通用的「设计对话」工具，不限于代码。

我的使用建议

我自己装了这套 skill 之后，最大的几个体感变化：

第一：不再急着开始写代码。以前 AI 接到「帮我加个登录」就开始铺 500 行，现在 /grill-me 会先问你 20 个问题——「要不要记住设备」「session 多久过期」「失败几次锁账号」。30 分钟后再让它写，省掉的是后续两小时的返工。

第二：CLAUDE.md 不再臃肿。以前 CLAUDE.md 里写了一堆「请先理解需求再写代码」「不要过度抽象」之类的禁令，但 Claude 该犯还是犯。换成 Matt 这套之后，CLAUDE.md 只放领域知识（设计系统、组件规范、部署），通用方法论交给 skill。两边职责清晰。

第三：deep module 思维比 skill 本身更值钱。即使你不装 /improve-codebase-architecture，光是读完它的 SKILL.md 里那条「deletion test」（如果删掉这个模块复杂度消失了，说明它本来就是 pass-through）就已经能让你在 PR review 时多看一眼。

注意代价：

• 装齐 5 个 skill 后，AI 会问话变多。习惯了「一句话生成 500 行」的人会觉得烦
• /tdd 严格执行后，简单脚本也会被它要求先写测试，对探索型代码不友好——可以告诉它「这次跳过 TDD」
• /grill-with-docs 会主动改你的 CONTEXT.md，第一次跑前最好让它进 dry-run

参考资源

演讲里引用的 5 本书（按出现顺序）：

• A Philosophy of Software Design — John Ousterhout（complexity 定义、deep modules）
• The Pragmatic Programmer — David Thomas & Andrew Hunt（software entropy、outrunning headlights）
• The Design of Design — Frederick P. Brooks（design concept、design tree）
• Domain-Driven Design — Eric Evans（ubiquitous language）
• Test-Driven Development — Kent Beck（invest in design every day）

每本都是 20 年以上的老书。Matt 演讲里多次重复一句话：「Go on Amazon, get it.」——这句话本身就是这场演讲的彩蛋。