一行命令装上mattpocock/skills，我的AI不再“瞎写”

🚀 30 秒快速安装

安装过程确实简单到“一行命令完事”：

npx skills@latest add mattpocock/skills

运行后安装器会引导你做两件事：

1. 选技能：从几十个技能里挑你想要的（不用全装）。
2. 选 Agent：这套技能兼容 Claude Code、Codex 等主流编码 Agent。

⚠️ 最关键的一步：安装时务必勾选 /setup-matt-pocock-skills，然后跑一次这个初始化命令。它会问你三个问题：

• 用什么问题追踪器（GitHub Issues、Linear，还是本地 .scratch/ 目录）；
• 分拣标签怎么定义（比如 needs-triage、ready-for-agent）；
• 生成的文档存到哪个目录。

这一步跑完，后面的技能才知道“这个项目的规矩是什么”，避免互相打架。

如果你不想把技能复制进项目里自己改，也可以把它装成 Claude Code 的“插件版”——技能包会跟随作者更新自动升级，是只读的。两种安装方式，丰俭由人。

🧠 它解决什么问题：四个 AI 编程经典翻车现场

Matt Pocock（Total TypeScript 创始人，前 Vercel 核心开发者）把自己日常踩坑总结的工程经验，翻译成了针对四个高频失败模式的修复技能。

1. 对不齐：/grill-with-docs

问题：你脑子里想的是 A，描述出来变 B，AI 理解成 C，写出来是 D。这是最高频的翻车现场。

修复：/grill-with-docs 会启动一个“盘问 session”——AI 反过来像面试官一样，一个问题一个问题地追问你，直到每个设计分支都对齐。

更关键的是，它会把盘问过程中提炼出来的统一语言（Ubiquitous Language） 写入 CONTEXT.md。Matt 给了一个很真实的例子：

• 之前：“课程中一个章节里的某节课被标记为‘真实’（即在文件系统里占了个位置）”
• 之后：只用说 “物化级联（materialization cascade）问题”

术语统一后，变量命名、函数签名、文件结构都会更一致，Agent 思考也更省 token。Matt 说这可能是整个仓库里“最强的一招”。

2. 太啰嗦：CONTEXT.md 共享语言

问题：AI 用 20 个词说 1 个词的事，变量名长得读不完，token 哗哗烧。

修复：上面提到的 CONTEXT.md 就是解法。它本质上是一份项目专属的领域词汇表，一次定义，全员共识。这个文件由 /grill-with-docs 懒加载创建——第一个术语被澄清之前它根本不存在，不需要预先搭架子。

3. 跑不起来：/tdd + /diagnosing-bugs

问题：需求对齐了，AI 写出来的代码还是跑不通。

修复：/tdd 技能强制走红-绿-重构（Red-Green-Refactor） 的 TDD 循环：

• 先写一个会失败的测试（红灯）；
• 写最少的代码让它通过（绿灯）；
• 在测试全绿的安全网下重构（重构）。

Matt 特别强调了一个反模式叫“水平切片”——别一次性把所有测试写完再写实现，那样测出来的是“想象中的行为”。正确的做法是垂直切片：写一个测试→写最少的代码让它过→再写下一个，一颗一颗试射。

调试方面有 /diagnosing-bugs，把调试拆成六个阶段，最强调的永远是第一步：稳定复现。复现不了的 bug，后面全是猜。

4. 架构烂成泥：/improve-codebase-architecture

问题：AI 加速了编码，也加速了软件熵增。代码库烂得比以往任何时候都快。

修复：/improve-codebase-architecture 会扫描代码库，找出“可以深化”的机会（比如把复杂逻辑藏到简单接口后面），生成可视化报告，然后引导你逐个处理。Matt 建议每隔几天就在项目上跑一次，定期清淤。

还有 /to-spec 和 /to-tickets 等技能，负责在动手前先把 spec 和 ticket 拆清楚，避免架构级跑偏。

🧩 一条完整的推荐流程

Matt 设计了一条串联起来的推荐工作流：

grill-with-docs → to-prd → to-issues → implement → code-review

• grill-with-docs：先盘问对齐，沉淀术语；
• to-prd：基于对齐结果产出产品需求文档；
• to-issues：按垂直切片拆成可独立实现的小块任务，而不是按前后端横切；
• implement：内部驱动 /tdd 走红绿重构；
• code-review：并行启动两个子代理——一个审“代码规不规范”，另一个审“功能有没有漏”——互不干扰，分开汇报。

💡 最后

整套技能最打动我的一点，是它的设计哲学：把 skill 当纪律，不当框架。

它不要求你全装，也不要求你按某个固定顺序走。用了一阵子觉得某个技能不顺手，就换，就改——因为那些 SKILL.md 文件只有几百行，改几行就能适配自己的项目。

而这一切的起点，就是那行命令：

npx skills@latest add mattpocock/skills

装完跑完 /setup-matt-pocock-skills，剩下的，就是挑几个顺手的技能，开始真正“像工程师一样”用 AI 干活。