Matt Pocock 的 Skills 线路图

用出效果的 8 条

从 Matt 的 README、问路 Skill 和教程页里提炼。每条下面注明出处。

我现在要……

挑一个最像你眼下情况的，右边给出该坐的路线。路线按 Matt 的问路 Skill（ask-matt）整理。

38 站索引

全部 Skill，按 Matt 仓库里的分组排列。圆圈颜色对应线路图上的线。点任意一行看详解。

换不换会话：阶段交界处的 5 个问题

一个「阶段」是会话里的一段活：追问、实现、验收。一段活做完、下一段还没开始，才是做这个决定的时候；做到一半不决定，要么继续，要么把剩下的拆给子 agent。按顺序问，第一个回答「是」的就是答案。

1. 能在这个会话里继续吗？

   能，就继续。

   两种情况算能：下一步要直接用这一步的原始推理（追问完接着实现是标准例子），或者「聪明区」还剩够用的空间（约 15 万 token）。继续不花任何代价，也不丢任何东西，所以最先排除它。

2. 这个会话里的东西，对接下来的事已经没用了？

   用 /clear。

   最便宜的一步，立刻拿回整个窗口，旧会话以后还能恢复。代价是单向的：清掉还有用的上下文，你会丢掉「为什么这样做」，回头看 diff 也找不回来。

3. 东西要带走吗？

   用 /handoff。

   只有四种情况需要：换工具（比如从 Claude 换到 Codex）、换目录或仓库、交给同事、在阶段中途分出一个支线任务。它买的是「能带走」，没东西要带走就用不着。

4. 这件事能不用你盯着就做完吗？

   派一个子 agent。

   范围收得够紧、中途不需要你掌舵的活，典型是自动审查：子 agent 在自己的窗口里读 diff、写报告，当前会话原封不动。

5. 以上都不是？

   用 /compact，并告诉它下一步要干什么，比如 /compact we're going to QA this area。

   它是兜底，不是第一选择。一上来就压缩，新会话会把被摘要抹平的决定「自信地记错」。

为什么这样设计

Matt 说这些 Skill 用来修 Agent 常见的四种翻车。它们故意做得小、好改、能拼着用，不挑模型。他不认同 GSD、BMAD、Spec-Kit 这类把整个流程接过去的框架：它们拿走你的控制权，流程本身出了 bug 也难修。

一条硬规则：你敲的 Skill 可以调用 Agent 用的 Skill，但不能调用另一个你敲的 Skill。所以 /implement 能自己跑 /tdd 和 /code-review，/grill-with-docs 能调用 /grilling 和 /domain-modeling，但它们都不能替你敲 /to-spec。

出处：README「Reference」一节、.agents/invocation.md。

概念词典

Skill 原文里反复出现的词。先认得它们，读 Matt 的文章和 Agent 的输出会轻松很多。

出处：grilling、codebase-design、to-tickets、domain-modeling 原文，ask-matt 与 PHASE-BOUNDARIES.md，CONTEXT.md，CHANGELOG。

Matt 公开怎么说

仓库、文章、教程页、演讲和播客里的原话。每条标了出处和核实程度：「已打开原文」是调研时真的读到了原文；「仅见于搜索摘要」是原页打不开（x.com 要付费），只看到搜索引擎给的片段。

• “My agent skills that I use every day to do real engineering - not vibe coding.”

  我每天真正做工程用的 Agent Skill，不是凭感觉写代码。

  仓库 README，已核对原文

• “These skills are designed to be small, easy to adapt, and composable. They work with any model.”

  这些 Skill 故意做得小、好改、能拼着用，不挑模型。

  仓库 README，已核对原文

• “You have access to a fleet of middling to good engineers that you can deploy at any time. But these engineers have a critical flaw: they have no memory.”

  你随时能调动一支中等到不错的工程师队伍，但他们有个要命的缺陷：没有记忆。

  《5 Agent Skills I Use Every Day》，2026-03-16，已打开原文

• “AI has a natural inclination to sycophancy... it wants to produce complete solutions all at once. It doesn't stop to validate assumptions or get feedback.”

  AI 天生爱讨好，总想一口气交出完整方案，不会停下来验证假设、要反馈。

  《Tracer Bullets: Keeping AI Slop Under Control》，2026-01-22，已打开原文

• “The principles apply harder to AI than they ever did to humans. Context window constraints make the discipline non-negotiable.”

  这些工程原则放在 AI 身上比放在人身上更要紧，上下文窗口的限制让这份纪律没得商量。

  同上一篇，已打开原文

• “The glossary is the point. Domain language is the thing this skill is actually building.”

  词汇表才是重点，这个 Skill 真正在建的是领域语言。

  grill-with-docs 教程页，与本地 docs 原文一致

• “No instruction makes an agent comply 100% of the time... the loop is worth running even when it is not followed strictly, because the results are still better overall.”

  没有哪条指令能让 Agent 百分之百照做；就算没严格执行，这套红绿循环的整体结果仍然更好。

  tdd 教程页，与本地 docs 原文一致

• “GOOD: Ubiquitous Language / Bounded Contexts / ADR's. BAD: Entities / Value Objects / Aggregates / Domain Events”

  领域驱动设计里他要共享语言、限界上下文和 ADR，不要实体、值对象、聚合、领域事件：用它记录应用，不用它规定应用长什么样。

  X @mattpocockuk，仅见于搜索摘要

他在不同场合推荐的顺序

去哪看、去哪听

数字：GitHub 270,125 个 star、22,752 个 fork（2026-09-26 用 gh 查）。skills.sh 列出 54 个条目（含改名前的旧条目），累计安装 2470 万次，其中 grill-me 约 120 万次（调研员 09-26 打开页面所见）。网上文章里的 star 数从 5.4 万到 16 万各说各的，本页不采用。

版本和改名

Matt 改名、合并、删除得很勤。看他早期的视频和文章时，用下面的对照表把旧名字换成现在的。日期来自 GitHub 上各版本标签的提交时间。

1. 2026-02-03 仓库建立

2. 2026-06-17v1.0.0 和 v1.0.1

   • 加入问路的 /ask-matt
   • 新增两个共用词汇 Skill：/codebase-design、/domain-modeling，并把 /grilling 单独拿出来当可复用的内核
   • diagnose 改名 diagnosing-bugs；write-a-skill 换成 writing-great-skills；删掉 caveman、zoom-out
   • 分类从 Commands / Skills 改叫「你敲的 / Agent 用的」；teach 改成优先复用已有组件

3. 2026-07-08v1.1.0

   • to-prd 改名 /to-spec；to-plan 和 to-issues 合并成 /to-tickets
   • review 转正为 /code-review，加上 Fowler 的 12 种代码坏味道做基线
   • decision-mapping 改名 /wayfinder 并转正；新增 /research
   • grilling 加「你确认前不动手」，并分开事实和决定；tdd 只讲红→绿，重构挪到审查

4. 2026-08-05v1.2.0 和 v1.2.2

   • 做成 Claude Code 插件，当天进入官方插件市场；同时补上 Codex 需要的元数据
   • 新增 /wait-what；/to-questionnaire、/wizard 转正
   • grilling 从一次一问改成一轮问一组；prototype 改成一个能分享的 HTML 文件，原型留在 prototype/名字 分支
   • writing-great-skills 改名 /writing-for-agents；删掉 6 个旧 Skill（见下表）

5. 2026-08-06v1.2.3（你装的就是这一版）

   • diagnosing-bugs 要求给密钥和敏感输出打码；派子 agent 的写法不再绑定 Claude Code 的工具名；wizard 去掉时间估算

6. 2026-09-17 上游新增测试版 /pr（还没发版）

7. 2026-09-24 最近一次推送

旧名字对照

出处：插件内 CHANGELOG.md；版本日期用 gh 查标签提交时间。

来源和说明

• 内容整理自 mattpocock/skills（MIT License），仓库地址 https://github.com/mattpocock/skills。
• Skill 原文：插件缓存 1.2.3（每个 SKILL.md、参考文件、docs 教程页、CHANGELOG、ADR），加上 GitHub main（09-26 用 gh 查：版本号同为 1.2.3，最近推送 09-24，比插件多一个测试版 pr）。
• 讲解卡：按原文逐条翻译整理，每张卡底部列出读过的文件。docs 教程页和 SKILL.md 说法不一致时以 SKILL.md 为准，卡里另有注明。
• 公开发言：见「Matt 公开怎么说」的核实程度一栏。没核实到的：X 推文原文（x.com 要付费）、演讲逐字稿、第三方文章里互相矛盾的 star 数。
• 本页整理于 2026-09-26，个人信息已脱敏，欢迎转发。