Agent Skills 工程化实践 07：先装对、配对，再让 ask-matt 帮你选路

这三项解决的是“使用系统”本身

25 个 Skills 并不要求你背下 25 条命令。真正的入口只有三件事：选择一种安装方式，用 setup-matt-pocock-skills 把当前 repo 的约定写清楚，再由 ask-matt 在需要时给出路线。wait-what 则负责修复一个更基础的问题：Agent 的上一段解释没有真正传达给人。

这三项不直接交付功能，却决定后面的 Skills 能否知道 issue 在哪里、文档写到哪里，以及当前到底该采访、规划、实现还是调试。

安装：plugin 与文件复制只能选一种

Claude Code 可以从官方 marketplace 安装完整 plugin：

claude plugins install mattpocock-skills

Codex 和其他支持 Skills 的 Agent，可以使用 skills CLI：

npx skills@latest add mattpocock/skills

plugin 是由上游管理、随发布更新的只读 bundle；skills CLI 会把所选文件复制进你的环境，适合按需安装和自行修改。二者不要同时使用，否则同一个 Skill 会出现两份，Agent 可能加载到不同版本。选择性安装时，还要把 wrapper 依赖的 primitive 一起装上，例如 grill-with-docs 依赖 grilling 与 domain-modeling。

上游入口：README Installation

setup-matt-pocock-skills：一次 repo 级契约

触发方式：User-invoked。 在目标 repo 中显式运行：

/setup-matt-pocock-skills

它会探索现有 remote、instruction files 与 domain docs，然后请你确认三类配置：

1. issue tracker：GitHub、GitLab、local markdown，或你描述的其他 tracker；
2. triage labels：五种 canonical role 在当前 tracker 中对应什么字符串；
3. domain docs：CONTEXT.md、ADR 与多 context map 放在哪里。

它的关键输出不是隐藏配置，而是 repo 内可审阅、可提交的 Markdown：docs/agents/issue-tracker.md、docs/agents/domain.md，以及安装了 triage 时的 docs/agents/triage-labels.md。这些文件是后续 Skills 的运行时契约。

怎么判断成功： /to-tickets 不再追问 issue 存放位置；/triage 使用真实存在的标签；instruction file 中存在指向上述配置的短指针。setup 不应该修改任何 SKILL.md，也不会自动创建远端 labels。

常见误用： 把 local markdown 与 GitHub issues 叠加；假设 setup 会创建 labels；在 Codex 使用的 repo 中只更新 CLAUDE.md，却没有确认 AGENTS.md 是否才是当前 harness 读取的入口。

上游 Skill：setup-matt-pocock-skills

ask-matt：返回下一步，不替你执行

触发方式：User-invoked。 当你知道处境，却不知道应该走哪条 flow 时运行：

/ask-matt 我有一个跨多个 session 的迁移想法，但还有几项关键决策没定

它应该返回“下一步输入什么”和原因，然后停止。它不会自行开始 grilling、写 spec 或修改代码。它区分的是问题形状，而不是匹配关键词：

• 有 repo 的新想法通常从 /grill-with-docs 进入；
• 无 working directory 的想法使用 /grill-me；
• 外部进入的 bugs 与 requests 走 /triage；
• 已经发生的 hard bug 进入 diagnosing-bugs；
• 大到一个 session 装不下、路线仍模糊的 effort 先走 /wayfinder；
• 已有清晰 spec 或 tickets，才进入 /implement。

ask-matt 是手写 route map，不会扫描你安装的其他作者 Skills。它对另一个 Skill 做出关键断言时，最好要求 Agent 打开目标 SKILL.md 再确认；router 的摘要可能落后于实际规则。

上游 Skill：ask-matt

wait-what：修复表达，而不是假装听懂

触发方式：User-invoked。 当上一条消息没有建立理解时直接运行：

/wait-what

它要求 Agent 补上缺失 context，用 ASD-STE100 Simplified Technical English 重新表达，并优先采用 CONTEXT.md 中的 ubiquitous language。它不负责继续原任务，也不是“把内容说得更长”；目标是让你能够复述：现在发生了什么、为什么、下一步是什么。

它最适合在两个时刻使用：Agent 用陌生 jargon 跳过了因果链；或者结论看似明确，但你无法判断它与当前 repo 的 domain objects 有什么关系。解释重新落地之后，再决定继续还是切换 Skill。

上游 Skill：wait-what

一条可直接照做的启动顺序

选择一种安装方式
→ 在目标 repo 运行 /setup-matt-pocock-skills
→ 审阅并提交 docs/agents/* 与 instruction pointer
→ 不知道从哪开始时运行 /ask-matt
→ 听不懂解释时立即 /wait-what
→ 再进入真正的 delivery flow

这里最重要的不是多一层流程，而是尽早暴露配置错误和理解断层。一个 Skill 系统如果连自己从哪里读事实、把结果写到哪里都不清楚，后面的自动化只会更快地产生不可追踪的工作。

来源与版本

• 上游参考：README Reference
• Latest Release：v1.2.3
• 参考分支：main · 核验 commit：8b78b53 · 核验日期：2026-08-14