Matt Pocock Skills 使用指南

mattpocock-skills 插件怎么用。2026-07-24 整理自官方仓库和网络资料，2026-07-29 用大白话重写了一遍。

一套给 Claude Code 用的工程纪律 skills，作者 Matt Pocock，就是写 Total TypeScript 的那位。GitHub 上很火，不同来源统计 54k 到 80k+ star。

这是什么

核心想法就一句话：别让 AI 凭感觉瞎写（所谓 vibe coding），把它按进正经软件工程的流程里。写之前先把需求盘清楚，写的时候走 TDD，写完自己 review，隔几天治理一次架构。

它跟 GSD、BMAD、Spec-Kit 那类框架的区别是不接管你的流程。每个 skill 都很小，能单独用，能自己改，换个模型也能跑。

本机已经用 Claude Code 插件方式装好了：marketplace 是 mattpocock（仓库 github.com/mattpocock/skills），插件 mattpocock-skills@mattpocock，v1.2.0，启用 22 个 skills。

为什么需要它

Matt 把 AI 写代码的翻车归成四类，每类给一个解法：

翻车现场	根因	解法
AI 做的不是我想要的	你没说清楚，或者你自己也没想清楚	/grill-me、/grill-with-docs，动手前让 agent 反过来拷问你
AI 老是理解偏、说话绕	项目黑话没有共享定义	/grill-with-docs 顺手建一份 CONTEXT.md 术语表
代码跑不对	写完没有反馈回路去验证	/tdd 红绿重构、/diagnosing-bugs 调试循环
架构越写越烂	AI 只是把熵增加速了	/improve-codebase-architecture，隔几天跑一次

最出名的是 grilling（拷问）系列。用法很简单：每次要动手改东西，先被拷问一轮，agent 会追着问，直到需求的每个分支都清楚为止。别嫌烦，这一步收益最大。

先做 setup，一个仓库一次

每个仓库第一次用之前跑：

它问三件事然后落成配置：用哪个 issue tracker（GitHub / Linear / 本地文件）、triage 给 ticket 打什么标签、生成的 spec / ADR / 术语表放哪。不跑这一步，工程类 skills 缺配置干不了活。

ps. 插件装的 skills 是只读的，跟着作者更新走。想改成自己的版本，用 npx skills@latest add mattpocock/skills 把文件拷进项目里再改。

核心工作流(常规开发流程)

从想法到合并，一条链路把 skills 串起来：

活太大、一个会话装不下，用 /wayfinder：把工作拆成 tracker 上的一张决策 ticket 地图，一个个啃，直到通往目标的路清晰。

拿不准该用哪个，直接问 /ask-matt，它就是个路由器。

Skills 全清单

skills 分两种调用方式。user-invoked 只能你手打 /xxx 触发，负责编排流程；model-invoked 你能手动调，agent 匹配到任务时也会自己调，装的是可复用的纪律。

工程类，日常写代码用

user-invoked：

Skill	干嘛的
/ask-matt	路由器，告诉你当前情况该用哪个 skill
/grill-with-docs	拷问的同时建领域模型，更新 CONTEXT.md 和 ADR，作者自称本仓库最酷的技巧
/triage	用状态机给 issue 和外部 PR 分类、验证，产出 agent 能直接执行的简报
/improve-codebase-architecture	扫描架构改进点，出可视化 HTML 报告，挑一个拷问细化
/setup-matt-pocock-skills	每个仓库首次使用前的一次性配置
/to-spec	把当前对话直接合成规格发到 tracker，不再访谈
/to-tickets	把计划或规格拆成小 ticket，带阻塞边
/implement	按 spec 或 ticket 实现，接缝处驱动 /tdd，收尾走 /code-review
/wayfinder	超大工作量的规划，产出决策 ticket 地图

model-invoked：

Skill	干嘛的
/tdd	测试驱动开发，红绿重构，一次一个纵切片
/diagnosing-bugs	硬骨头 bug 和性能回归的纪律化诊断循环
/code-review	双轴审查 diff：守没守规范，有没有忠实实现需求，并行子 agent 跑
/research	只查高可信一手来源，产出带引用的 md，后台 agent 跑
/domain-modeling	构建和打磨领域模型，拿术语表和边界场景压测
/codebase-design	深模块设计的共享词汇：小接口藏大行为、放在干净接缝、可测
/prototype	建一次性原型回答设计问题，可跑的终端 app 或多套 UI 变体
/resolving-merge-conflicts	逐 hunk 解 merge/rebase 冲突，按意图溯源，绝不 --abort

生产力类，不限代码

user-invoked 有四个：/grill-me 纯拷问对齐、/handoff 把对话压缩成交接文档给下一个 agent、/teach 多会话教你一个概念、/writing-great-skills 是写 skill 的参考。

model-invoked 一个：/grilling，拷问循环的本体，grill-me 和 grill-with-docs 背后复用的就是它。

杂项

/git-guardrails-claude-code 装 hook 拦危险 git 命令（push、reset --hard、clean、branch -D 这些）、/setup-pre-commit 配 Husky + lint-staged + 类型检查 + 测试、/migrate-to-shoehorn、/scaffold-exercises。

其它，谨慎用

personal：/edit-article、/obsidian-vault，Matt 个人写作和笔记用的

in-progress 实验性：/loop-me、/wizard、/claude-handoff、/batch-grill-me、/to-questionnaire、/writing-*、/setup-ts-deep-modules

deprecated 别用：/qa、/ubiquitous-language、/design-an-interface、/request-refactor-plan

常见场景速查

你想干嘛	用这个
开始一个新功能，需求还很模糊	/grill-me 或 /grill-with-docs
讨论完了，固化成正式规格	/to-spec 然后 /to-tickets
有 spec 或 ticket，开始写	/implement，内部会用 /tdd
想测试先行地写代码	/tdd
有个诡异 bug 或变慢了	/diagnosing-bugs
提 PR 前自查	/code-review
感觉代码越来越难改	/improve-codebase-architecture
活太大一个会话装不下	/wayfinder
不知道该用哪个	/ask-matt
会话要结束，交给下一个 agent	/handoff

注意事项

刚装完的会话里 skills 可能还没加载，下次启动才完全生效。

新仓库先跑 /setup-matt-pocock-skills，不然工程类 skills 缺 tracker 和文档配置。

token 开销：整套常驻大约 1.4k tokens 每会话，单个 skill 被调用时另算，diagnosing-bugs 约 2.8k，triage 约 2.2k。claude plugin details mattpocock-skills@mattpocock 能看明细，不用的可以 claude plugin disable 关掉。