mattpocock/skills 系列(1):先设置项目规则,再用 ask-matt 找下一步
第一次使用 mattpocock/skills,不必先记住 25 个 skill。本文说明安装方式、setup-matt-pocock-skills 会替项目留下哪些设置,以及如何用 ask-matt 找出下一步。
你准备替现有的订阅服务加入按席位计费,却不确定该先厘清需求、写规格、补测试,还是直接动手写代码。听说 mattpocock/skills 能让 AI 编程助手把这类工作做得更有条理,打开清单却看到 25 个 skill 名称。难道要先把每一个都搞懂才能开始?
不必全部看懂。第一次使用只需要两步:
- 用
setup-matt-pocock-skills把项目的工作规则记下来。 - 用
ask-matt描述你遇到的问题,让它建议下一个该用的 skill。
在我看来,ask-matt 比较像服务台,不是会自动跑完整套流程的总管。它只告诉你下一步该用哪个 skill,实际启动仍要由你来做。
mattpocock/skills 系列|第 1 篇
- 下一篇(第 2 篇):把模糊需求问清楚,留下共用词汇
- 系列导读:这套 skill 是什么、六篇该怎么读
这篇我以
1.2.3版为准。官方插件的plugin.json收录 25 个 skill。代码库里另有 9 个仍在试验中、4 个目前不主动推广的项目,分别列在in-progress/README.md和misc/README.md。本系列只讨论官方插件收录的 25 个。
2026-10-04 发布的
1.3.0和1.3.1,把官方插件从 25 个 skill 变为 27 个(2026-10-19 核实):
- 移除了
resolving-merge-conflicts。- 新增
implement-spec、pr、retro,ask-matt也会推荐这三个新 skill。- 项目词汇表从
CONTEXT.md改名为GLOSSARY.md。新版 skill 只认新文件名,旧文件要用git mv改名。这个系列我之后会按新版全面更新。
我把 skill 理解成一份告诉 AI 编程助手如何完成特定工作的操作说明,例如怎么访谈需求,或者怎么把规格拆成一项项工作。AI 编程助手指的是 Claude Code、Codex 这类能读写项目文件、帮你写代码的工具。mattpocock/skills 则是 Matt Pocock 公开的一整套 skill。
安装与启动是两个问题
安装方式决定 skill 文件放在哪里、由谁负责更新。启动方式则决定谁能叫某个 skill 开始工作。
第一次使用的完整路径:选择安装方式、运行 setup,再由 ask-matt 建议下一个 skill。
选一种安装方式
mattpocock/skills 以 .agents/install-block.md作为安装说明的唯一依据。依你使用的工具选择:
| 使用情况 | 安装方式 | 之后怎么维护 |
|---|---|---|
| 使用 Claude Code,不打算修改内容 | 官方插件 | 自动更新,内容不能修改 |
| 使用 Claude Code,想自行修改内容 | skills.sh | 文件复制进项目,由你自行修改与更新 |
| 使用 Codex 或其他支持 skill 的工具 | skills.sh | 文件复制进项目,由你自行修改与更新 |
我建议两种方式任选其一。同时使用的话,每个 skill 会各出现两份。
Claude Code 是 Anthropic 推出的 AI 编程助手,Codex 则来自 OpenAI。Claude Code 的官方插件安装命令是:
1
claude plugins install mattpocock-skills
也可以在 Claude Code 里直接输入:
1
/plugin install mattpocock-skills
想自行修改内容,或使用 Codex 等其他工具时,改用 skills.sh 这个安装工具:
1
npx skills@latest add mattpocock/skills
skills.sh 会让你勾选要安装哪些 skill,以及要装给哪些 AI 编程助手使用。一定要选入 setup-matt-pocock-skills,想照本文使用 ask-matt 的话也要选入它。之后 ask-matt 建议的其他 skill,同样要先安装才能使用。
使用 skills.sh 时,更新单一 skill 的命令是:
1
npx skills@latest update <name>
看懂谁能启动 skill
mattpocock/skills 依“谁能启动”把 skill 分成两类:
| 原文名称 | 谁能启动 |
|---|---|
| user-invoked | 只能由人输入名称启动 |
| model-invoked | 人可以启动,AI 也能依工作内容自行采用 |
只能由人启动的 skill,可以再调用 AI 能自行采用的 skill,但不能调用另一个只能由人启动的 skill。完整限制记在启动方式规范。
setup-matt-pocock-skills 与 ask-matt 都只能由人启动,你必须主动输入名称。Claude Code 和 Codex 的输入方式不同:
| 工具 | 输入示例 |
|---|---|
| Claude Code | /setup-matt-pocock-skills |
| Codex | $setup-matt-pocock-skills |
在 Codex 中,可以先输入 $ 再从清单选择 skill,也可以直接输入 $skill-name。这项语法可在 OpenAI 的 Codex skills 文档核对。其他 AI 编程助手,请依各自的 skill 菜单或输入方式操作。
我认为这项限制也说明了 ask-matt 为什么只能提出建议。例如它常推荐的 grill-with-docs 同样只能由人启动,所以你得自己输入。它也不会自动一路往下执行 to-spec、to-tickets 和 implement。
setup 先检查、再询问,最后才写入
每个项目第一次使用偏重软件开发的 skill 之前,要先运行一次 setup-matt-pocock-skills。因为这些 skill(原文归在 engineering 类)需要知道项目的一些基本信息。它不是固定不变的安装程序,而是一段先检查、再询问、最后才写入文件的流程:
flowchart TD
A[查看项目现状] --> B[确认工作跟踪工具]
B --> C{装了 triage?}
C -->|是| D[确认分类标签]
C -->|否| E{由多个子项目组成?}
D --> E
E -->|否| F[词汇表与决策记录集中放一份]
E -->|是| G[问是否每个子项目各放一份]
F --> H[展示草稿给你修改]
G --> H
H --> I[你确认后才写入]
一开始,它会查看项目的这些现状:
- 代码放在哪个平台,例如 GitHub。
- 项目里是否已有给 AI 看的说明文件(
AGENTS.md或CLAUDE.md)。 - 词汇表与决策记录。
- 先前留下的配置文件。
- 项目是否由多个子项目组成(原文称 monorepo)。
词汇表(CONTEXT.md)记录项目专用名词的定义,决策记录(ADR)则记录重要技术选择的理由,下一篇我会详细介绍。
工作跟踪工具(原文称 issue tracker)是团队记录待办事项的地方。代码放在 GitHub 时,setup 默认建议 GitHub Issues;放在 GitLab 时,则建议 GitLab Issues。
你也可以直接用项目文件夹里的 Markdown 文件记录。若使用 Jira、Linear 等其他工具,则由你用一段文字说明操作方式。
分类标签是给整理外部反馈的 triage 使用的,所以只有安装了 triage 才会询问。
确认后,它会修改或创建以下文件:
| 位置 | 写入内容 | 条件 |
|---|---|---|
CLAUDE.md 或 AGENTS.md | ## Agent skills 段落,指向下列各份配置文件 | 有 CLAUDE.md 就改它,否则改 AGENTS.md |
docs/agents/issue-tracker.md | 工作跟踪工具的位置与操作方式 | 一定会创建或更新 |
docs/agents/domain.md | 词汇表与决策记录的存放方式 | 一定会创建或更新 |
docs/agents/triage-labels.md | 分类标签的名称 | 只在安装了 triage 时创建或更新 |
如果项目里两份说明文件都没有,它会先问你要创建哪一份,不会自行决定。如果文件里已经有 ## Agent skills 段落,它会直接更新该段落,不会重复添加。
setup 只把标签名称写进 docs/agents/triage-labels.md,原始流程里没有到 GitHub 或 GitLab 创建标签的步骤。所以开始分类之前,我会先确认工作跟踪工具里的标签名称与配置文件一致。
写入前,它必须先展示草稿,包含 ## Agent skills 段落与各份配置文件,让你修改和确认。完成后,这些文件就是一般的项目文档,之后可以直接编辑。只有想更换工作跟踪工具或从头设置时,才需要再运行一次。
ask-matt 按你的状况建议起点
ask-matt 不要求你先记住所有 skill。你只要描述目前的状况,它就会建议从哪个 skill 开始。常见的起点如下:
| 目前状况 | 建议起点 |
|---|---|
| 在项目里,想把一个还不完整的想法谈清楚 | grill-with-docs |
| 没有项目文件夹,只想把想法谈清楚 | grill-me |
| 要整理别人送进来的问题反馈与需求 | triage |
| 遇到难以复现、时有时无,或最近才出现的错误 | diagnosing-bugs |
| 工作范围模糊,而且一次对话谈不完 | wayfinder |
一般功能开发的主线,是先用 grill-with-docs 通过访谈厘清需求。有些问题得先做出能实际操作的东西才答得出来,例如界面该长什么样子,这时流程会暂时岔出去:
flowchart TD
A[grill-with-docs 访谈需求] --> B{要先做出东西才答得出?}
B -->|否| F[需求谈清楚,往下走]
B -->|是| C[handoff 把进度写成交接文档]
C --> D[新对话用 prototype 做原型]
D --> E[handoff 把结果带回]
E --> A
prototype 做的是用完即丢的原型。
确定这项工作要分成好几次对话才做得完时,接着用 to-spec 整理规格、用 to-tickets 把规格切成一张张工作单。最后每张工作单各开一次新的对话,用 implement 实现。
implement 会在内部用 tdd(先写测试、再写代码的开发方式)完成功能,并在提交修改前用 code-review 检查一遍。
从需求访谈到 to-tickets,都应该留在同一段对话里,让后面的步骤接续前面的讨论。工作单创建好之后,才给每张工作单各开新的对话;因为工作单已写明所需信息,不必依赖先前的对话内容。完整规则位于 ask-matt/SKILL.md。
模拟场景:替现有服务加入按席位计费
这一节是我依 1.2.3 版的原始规则推演的。假设项目由几个子项目组成,代码放在 GitHub,工作也用 GitHub Issues 跟踪。
以 Codex 为例,先用 skills.sh 安装需要的 skill,这里假设后文提到的 skill 都已选入。接着输入:
1
$setup-matt-pocock-skills
setup 发现代码放在 GitHub,会建议沿用 GitHub Issues。它也会从文件夹结构看出项目由多个子项目组成,因此询问词汇表要共用一份,还是每个子项目各放一份。
如果也安装了 triage,setup 还会询问是否沿用五个默认标签:
1
2
3
4
5
needs-triage
needs-info
ready-for-agent
ready-for-human
wontfix
这五个标签依次代表“等待评估”“等待补充信息”“可以交给 AI 处理”“需要由人处理”与“决定不处理”。如果团队的工作跟踪工具早已使用别的标签名称,也可以改成对应的名称,避免出现重复的标签。
你确认这些选择后,AI 编程助手会先展示要写入的内容。你同意后,它才修改 CLAUDE.md 或 AGENTS.md,并在 docs/agents/ 创建配置文件。
设置完成后,再描述目前卡住的工作:
1
$ask-matt 需要替现有订阅系统加入按席位计费。目前只有一段需求描述;需求应该能在一次对话中谈清楚,但实现会分好几次进行。
依照 ask-matt 的规则,它会建议先用 grill-with-docs 把几个问题谈清楚:价格怎么算、席位何时开始与停止使用、账单周期,以及旧客户如何迁移。流程不会自动往下跑,你要自己输入:
1
$grill-with-docs
需求谈清楚后,继续在同一段对话里依次输入:
1
2
$to-spec
$to-tickets
to-tickets 会把规格切成较小的工作单,并标明哪些工作单要先完成、哪些要等前面的做完才能开始。
工作单创建好之后,每张工作单各开一次新的对话,再输入:
1
$implement <工作单链接或编号>
这套流程只负责安排工作顺序,不会替团队决定价格规则、席位怎么计算,或旧数据怎么迁移。这些产品与技术上的选择,仍要在厘清需求时由团队确认。
第一次使用时怎么选
flowchart TD
A{一次性、不在项目文件夹里?} -->|是| B[不必创建整套项目设置]
A -->|否| C[选一种安装方式]
C --> D[给项目运行一次 setup]
D --> E{知道下一个 skill?}
E -->|是| F[跳过 ask-matt,直接启动]
E -->|否| G[问 ask-matt]
就算已经知道下一个 skill,需要读取工作跟踪工具或词汇表设置的 skill,仍要先完成 setup。
这篇我核对的是 1.2.3 版的设计与操作方式,不代表这套流程一定能缩短开发时间。我认为它直接带来的好处,是把项目惯例写成文档,并在你不确定下一步时建议合适的 skill。下一篇会接着讨论如何把需求问清楚,并建立团队共用的词汇。
延伸阅读
README.md:核对官方安装方式与第一次设置的说明。- 启动方式规范:了解哪些 skill 只能由人启动。
setup-matt-pocock-skills:查看它读取与写入哪些文件。ask-matt:查看不同状况各自适合哪个下一步。- OpenAI Codex skills:核对 Codex 的 skill 选择与启动方式。

