别让 Agent 先写后问：mattpocock/skills 把拷问、TDD 与架构巡检装进斜杠命令

本地已经写过不少 Skills 文：addyosmani/agent-skills 讲生产级工程习惯斜杠命令；frontend-slides / html-ppt-skill 讲演示稿；uipro-design-skill 讲设计系统；diagram-design-skill 讲画图；opensquilla-meta-skill 讲编排协议。它们回答的是「单个技能怎么写、怎么装、怎么组」。

这篇换对象。源微信标题写得很虚——「开源一个神级 Skill，斩获 32000+ GitHub Star！」——核对 sn=13332ca4ef1c5392 后，真实仓库是 mattpocock/skills（MIT）。作者是 TypeScript 圈子里的 Matt Pocock。源文发布时 Star 约 3.2 万；仓库后续继续暴涨，社区报道曾冲到二十万量级。它要解决的不是再堆一个「一键出 PPT」类技能，而是：把资深工程师每天会做的需求澄清、领域语言、红绿重构、代码评审、架构巡检，收成可组合、可改写的 Agent Skills。 官方口号直白——Skills For Real Engineers，不是 vibe coding。

源微信页抓取遇阻，正文以官方 README、skills/ 目录下的 SKILL.md，以及 skills.sh/mattpocock/skills 安装说明为准，不臆造未公开能力。

一、为什么不是又一套「接管一切」的流程框架

GSD、BMAD、Spec-Kit 这类方案，倾向于拥有整条流程：从需求到交付由框架主导。Matt 的批评很具体——流程一旦被框架吞掉，出了 bug 你很难拆开修；你也失去了「只改其中一个环节」的控制权。

mattpocock/skills 走另一条路：

一句话：它不负责替你当项目经理，只负责在关键节点把「专业工程师会怎么干」写进可调用的 Markdown 技能卡。

二、30 秒装上：两条安装哲学，别混用

官方明确：Claude Code 插件和 skills.sh 拷贝是两种哲学，装两种会让每个技能出现两份。选一条即可。

路线 A：Claude Code 官方插件（只读订阅）

claude plugins install mattpocock-skills

会话内也可以：

/plugin install mattpocock-skills

它在 Claude Code 官方 marketplace 里，作者推送后你会跟着更新，适合「我信任上游、不想 fork」的人。

路线 B：skills.sh 拷贝（可编辑、可本地化）

适合 Codex 及其他 Agent，也适合想改技能正文的人：

npx skills@latest add mattpocock/skills

安装器会让你勾选技能与目标 Agent。务必把 setup-matt-pocock-skills 勾上。 之后可用 npx skills update 按需拉取上游，不会在背后偷偷改你仓库。

装完先跑一次 /setup-matt-pocock-skills

每个仓库跑一次。它会问三件事：

1. 用哪个 Issue 追踪器（GitHub / Linear / 本地文件）

2. 分诊时用哪些标签（/triage 依赖标签）

3. 生成的文档放哪（领域文档、ADR、CONTEXT 布局）

答完，后续 /to-tickets、/grill-with-docs、/implement 才有统一落点。

配套练习目录里放了最小安装备忘：practice/install-notes.md。

三、四个失败模式，对应四组技能

README 把日常踩坑收成四类。这比「三十个技能清单」更好记。

失败 1：Agent 没做成你要的

根因几乎总是对齐失败——你以为说清楚了，模型其实在另一条产品想象上狂奔。

Matt 自己说 /grill-me 是仓库里「最酷的技能，没有之一」。源文也把「先慢思考再写码」当作卖点：加「用户权限」时，先拷问粒度与继承，再用下游技能出 PRD / Issue，而不是直接甩实现。

失败 2：Agent 话太多、术语飘

对策是共享语言。/grill-with-docs 会逼你把黑话收成术语表。官方举例：把「课程里某节变成真实落盘」收成 materialization cascade——变量、文件、对话都复用同一词，导航更稳，Token 也更省。

失败 3：代码根本跑不通

对齐之后仍产出垃圾，多半是反馈环太稀。仓库给了：

/tdd 明文反对「先写完所有测试再实现」的水平切片，也反对测私有方法、 tautological 断言（用代码同一算法再算一遍当 expected）。

失败 4：越写越成泥球

Agent 加速编码，也加速熵增。仓库把设计意识嵌进多层：

官方提醒：架构巡检是勘察不是抢救——老泥球它能列候选，不会替你一夜拆完。

四、工程流水线怎么串：从拷问到评审

用户可点名的工程技能，大致能排成一条「可裁剪」流水线（不必每次全跑）：

/ask-matt                 # 不知道用哪个时先问路
    ↓
/grill-with-docs          # 对齐 + CONTEXT.md / ADR
    ↓
/to-spec  →  /to-tickets  # 规格 → 带阻塞边的 tracer-bullet 工单
    ↓
/implement                # 按约定 seam 驱动 /tdd，收工前 /code-review
    ↓
/improve-codebase-architecture   # 隔几天巡检一次

大到单会话装不下时，用 /wayfinder：把决策拆成 Issue 上的决策票地图，一次只消一张。

模型可自动召回的纪律卡包括：prototype、research、code-review（Standards × Spec 双轴、并行子代理）、resolving-merge-conflicts（按意图解冲突，禁止轻易 --abort）、wizard（生成人类才能点的交互式 bash 向导）等。

用户可点名技能可以调用模型可调技能；用户可点名技能之间不要互相调用。 这是仓库对编排边界的硬约定，和「随便写个超级 Prompt 套娃」不是一回事。

五、和本地已有 Skills 文怎么错开

防重结论：同产品必须 SKIP。核对后本地无 mattpocock/skills 独立成篇，公众号列表亦无同仓库标题，故继续撰写。

六、排坑与边界

1. 别双安装：插件 + npx skills add 会重复技能文件，斜杠命令行为难预期。

2. 先 setup 再干活：跳过 /setup-matt-pocock-skills，后续工单与文档路径会各写各的。

3. /tdd 要先钉 seam：未确认公共边界就写测试，容易测到实现细节，一重构就碎。

4. 架构巡检有节奏：隔几天跑 /improve-codebase-architecture 比「项目烂透了才救」有用；它不承诺 magically 重构。

5. 拷问会「慢」：/grill-me 故意让你慢下来。若你只想要一行生成一万行代码，这套仓库会显得「碍事」——那是产品定位，不是 bug。

6. Star 数字会过期：源文写 32000+；引用时写清时间点，或链到仓库实时数据，避免标题党漂移。

七、最小可复现清单

1. 选路线：Claude 插件 或 npx skills@latest add mattpocock/skills（含 setup-matt-pocock-skills）。

2. 在仓库里跑 /setup-matt-pocock-skills，定追踪器与文档目录。

3. 下次改需求前先 /grill-me 或 /grill-with-docs，逼出边界条件。

4. 实现时显式 /tdd，只在约定 seam 上写红绿环。

5. 合入前让 /code-review 走 Standards + Spec；隔几天用架构巡检扫加深机会。

仓库地址：https://github.com/mattpocock/skills
安装页：https://skills.sh/mattpocock/skills
主页：https://aihero.dev/skills

把 Agent 从「会打字的实习生」变成「守纪律的结对伙伴」，靠的不是更大的模型，而是你愿不愿意在斜杠命令里先被拷问一轮。