入门 约 20 分钟 2026-10-16 02:39:47 · 24 阅读

ask-matt 技能地图实操:三十多个斜杠命令,先学会问路

三十多个斜杠命令装进编程代理之后,第一个真实问题不是命令不好用,而是不知道该用哪个。ask-matt 是 mattpocock/skills 仓库里的路由技能:SKILL.md 第一句就写明立场——"You don't remember every skill, so ask."(你记不住每个技能,所以问。)它把全仓库的技能组织成一张地图,主线、匝道、词汇层、独立区各归各位。这篇把这张地图逐区拆开讲,所有命令与描述都依据仓库原文(2026-10-16 拉取),配图为依据原文绘制。

本篇依据 mattpocock/skills 仓库 skills/engineering/ask-matt/SKILL.md 与 PHASE-BOUNDARIES.md 整理,系列总纲见 dbyun 教程中心。

ask-matt 是个路由器,不是又一项新功能

装完 Matt Pocock 全家桶,代理多出 /grill-with-docs、/implement-spec、/triage 等几十个命令。哪个场景走哪条链路,靠脑子记是记不住的,ask-matt 的 description 只有一句:"Ask which skill or flow fits your situation. A router over the skills in this repo."——问哪个技能或流程适合你的处境,本仓库技能的路由器。

路由的骨架是一个概念分层:flow(流)是穿过若干技能的一条路径;大多数路径沿着同一条 main flow(主线)走;两条 on-ramps(匝道)从不同起点汇入主线;其余技能是独立的,或者跑在底下的词汇层。SKILL.md 还给使用者立了一条规矩:

Before stating what a skill does or recommending a step be skipped, read that skill's SKILL.md: the summaries here are for orientation only.(在断言某个技能是干什么的、或建议跳过某步之前,先读那个技能的 SKILL.md:这里的摘要只用于定向。)

这句对人也适用——下面各区概述都只是定向,动手前请回原文核对。

ask-matt 技能地图:主线、匝道、词汇层三层结构

图 1 ask-matt 地图全貌:一条主线(idea → ship)、三条汇入匝道、一层词汇与前置(据 SKILL.md 各节绘制)

主线:从想法到上线的四步

"The main flow: idea → ship. The route most work travels."——主线就是大多数工作走的路。四步如下。

第一步 /grill-with-docs 打磨想法。这是个拷问式访谈技能,起点规则只有一条:只要你在工作目录里干活就选它,因为有状态——学到的东西会沉淀进 GLOSSARY.md 和 ADR。没有工作目录(比如打磨一份计划、一篇文稿)才用无状态的 /grill-me,两者跑的是同一个 /grilling 访谈原语,原文说 grill-with-docs 会留下纸面记录,所以只要有仓库在,就严格更好。

第二步 分流:这问题聊得拢吗?如果某个问题需要跑起来才能回答(原文列举:状态、业务逻辑、必须亲眼看的 UI),就走原型支线:/handoff 写出一份可携带的 markdown → 对着那份文件开新会话 → /prototype 用一次性代码回答问题 → /handoff 把答案带回原线程。原型住在自己的目录里,这正是 /handoff 存在的意义。

第三步 分流:多会话工程吗?是,就 /to-spec 把线程变成规格,/to-tickets 拆成"曳光弹"工单(tracer-bullet tickets,每张声明自己的阻塞边)。之后二选一:逐张 /implement,每张之间 /clear;或整包 /implement-spec——把工单当任务图(task graph),在就绪的 frontier 上并行跑实现子代理,全部落在一条集成分支上收口。不是多会话工程,就直接 /implement 原地干。

第四步 /retro 收口。复盘的对象是环境而不是代码:导航指针、自动化检查、code-review 强制的编码规范、steering 文件、工具链。原文的两个转化很提气——机械性错误变成确定性检查项,判断题变成编码规范,下一个项目从更好的环境起步。

无论走哪条施工路线,代码本身都由 /tdd(一次一个红绿切片)盖出来,收尾过 /code-review(Standards 与 Spec 双轴审 diff);工作要以 PR 形式提交时,/pr 负责塑形 PR 描述:展示变更的最小视觉、before/after 证据、一次单向门还是双向门的判断。

主线还有一条上下文卫生规则值得单独抄出来:第 1~3 步保持在同一个不断开的上下文窗口里(/to-tickets 之前别 compact 也别 clear),让拷问、规格、工单建立在同一段思考上;每个 /implement 则从工单出发、全新开始。逼近 smart zone(原文定义:最先进模型上约 150k tokens 的窗口,模型在其中仍然推理敏锐)时不要硬撑降级状态,在最近的阶段边界 /compact 后继续。

匝道:三种起跑姿势汇入主线

匝道(on-ramps)的定义是"一个生成工作的起点处境,随后汇入主线"。三条各对应一种处境。

/triage 对应 bug 和需求堆积。它把 issue 推过分拣角色,产出 agent-ready issues 供 /implement 后续拾取。原文划了条硬线:分拣只针对不是你自己建的 issue——bug 报告、外部功能请求、任何以原始状态抵达的东西;/to-tickets 产出的工单本来就是 agent-ready 的,别再分拣它们。

/diagnosing-bugs 对应东西坏了。为难的 bug 服务:第一眼看不动的那种、间歇性抖动、两个已知良好状态之间爬进来的回归。它在拿到一条紧反馈回路(一条对本 bug 就会红的命令)之前拒绝提出理论,修完配回归测试;修完还建议在同会话跑 /retro,若真正的发现是"没有好接缝把它锁住",那是 /improve-codebase-architecture 的活。(这个技能本站已单独成篇:diagnosing-bugs 实操。)

/wayfinder 对应大雾工程:绿地项目或巨型特性,一个会话装不下。它画一张由决策票构成的共享地图,一次解决一张,产出决策而非交付物,直到雾被推干净。原文的收尾规则是"it hands off, it doesn't build"(它移交,它不施工):雾清后从 /to-spec 汇入主线,把地图里链接的决策坍缩成可施工的计划;直接拿地图怼 /implement 会丢掉链接细节,只有工程量确实小才允许直连。它是这里认知负担最重的流程,留给你确实装不下的想法——原文明确说"never a well-scoped feature",范围清晰的功能别动它。

词汇层与代码库健康

两个 model-invoked 参考技能跑在其它技能底下,各自是某套词汇的唯一事实来源。当你发现问题是词而不是流程时直接用它们:

/domain-modeling 管领域语言:挑战一个含糊的词、拆解一个身兼三职的词(原文例:"account" doing three jobs)、把一个难以逆转的决策记成 ADR。它是 /grill-with-docs 驱动着去保持 GLOSSARY.md 干净的那门主动纪律。

/codebase-design 管深模块词汇(module、interface、depth、seam、adapter、leverage、locality),为模块定形状用:小接口背后大量行为,放在干净的接缝处。/tdd 和 /improve-codebase-architecture 都说这门语言。(本站已单独成篇:domain-modeling 实操、diagnosing-bugs 实操。codebase-design 见姊妹篇。)

代码库健康区只有 /improve-codebase-architecture:闲时保养,找出加深机会(deepening opportunities),选中的那个会生成一个想法带回主线 /grill-with-docs。原文的分工说得很清楚——它是找出候选者的勘察,/codebase-design 是你对选中者做设计的那张工作台。它俩加上 /implement-spec、improve-codebase-architecture 的写法已在本站 improve-codebase-architecture 实操、implement-spec 实操 两篇里展开。

ask-matt SKILL.md 七个分区一览表

图 2 SKILL.md 的七个分区与各分区命令清单(分区名即原文节标题)

阶段边界:五个问题,从上往下问

会话管理是 ask-matt 地图里最容易被轻视的一段。phase(阶段)是会话内的一块工作:拷问、实现、QA;阶段边界是两个阶段之间的缝隙,也是唯一该做会话决策的地方——阶段中途没有决策可做:继续,或者把剩下的活切给子代理。中途 compact 会让代理丢线。

边界上有五个选项,决策树是一棵有序问题树,第一个"是"生效:

1. 这个会话里能继续吗?两种情况答"能":下一阶段需要本阶段当一手源(primary source),或者 smart zone 余量还够装下一阶段。拷问 → 实现是标准的"能"——实现要的是推理过程的逐字原文,不是它的摘要。Continue 零成本零损失,先排除它再谈别的。

2. 上下文对接下来无关吗?探索、决策、死胡同全都可以丢,就 /clear。它是棋盘上最便宜的一步:不花时间,还回整个窗口。clear 也不是终点站——旧会话仍可恢复。原文警告这步弄反的代价是单向的:clear 掉一个相关上下文,你失去的是"为什么这么建"的 why,读多少遍 diff 都换不回来。

3. 需要移交吗?/handoff 的适用面很窄,仅四种:换 harness(Claude → Codex)、换目录或仓库、交给同事、阶段中途 fork 支线任务。这份清单就是全部条款——买到的是可移植性(一个能旅行的文件),没有东西在旅行就不需要它。

4. 任务能 AFK 干完吗?范围收得够紧、不需要你盯方向盘,就送子代理,拿报告回来,本会话不动。自动审查是标准场景:代理读 diff 并汇报,期间不需要你。

5. 以上都不是,/compact。上下文相关、同 harness、同目录、人还得在环上——树落在这里,而且落得很勤。给它带句指令(原文例:"/compact we're going to QA this area"),让摘要保住下一阶段需要的东西。

除 Continue 外的每一步都在把一手源变二手源:

阶段边界五问决策树与一二手源对比表

图 3 五问决策树(第一个"是"生效)与一手/二手源的损耗对比(据 PHASE-BOUNDARIES.md 绘制)

这张权衡表是决策树的第一问排在最前的原因:你只在"留下来的代价高于省下的"时才付这份损耗。/compact 是默认落点,不是第一触手——它坐在树底,因为上面四问都比它更便宜或更精准。原文点名的失败模式:从 compact 起步的人,拿到的是一个对某项被摘要压平的决策"自信地错"的新会话。决策树的最后一句也值得抄:这些问题不是客观题,每道都有品味,同一条边界两天可以走两条路,价值在于按顺序、在边界上问它们。

独立区与前置:地图的边角

Standalone 区是九个不在主线上的技能,挑常用的几个:/grill-me 无仓库时的拷问(有仓库就 strictly better 用 /grill-with-docs);/grilling 裸访谈原语,/triage、/wayfinder、/improve-codebase-architecture 内部都在跑它;/research 把阅读跑腿派给后台代理,对着一手源调查问题,产出带引用的 markdown 文件留在仓库里——你可以继续干活,它在读;/to-questionnaire 卡住你的东西既不在你脑子里也不在代码库里、而在别人那里时,替你给对方写问卷;/wizard 专管只有人能点的步骤(配基础设施、设凭据或 CI secret、点陌生后台、跑一次性迁移),生成一个交互式 bash 脚本:逐个打开 URL、捕获值、写进 .env 和 GitHub secrets——代理能自己做的它不该管,这个技能只为人真正在环上的时刻而设;/wait-what 是消息没听懂时的重述按钮,可在任何技能中途用,用 GLOSSARY.md 的词汇把刚说的话重新讲一遍。

Precondition 区是 /setup-matt-pocock-skills:第一个工程流程之前跑一次,配置其它技能都默认的三样东西——issue 跟踪器(GitHub、GitLab、本地文件,或任何你能描述的东西)、triage 用的标签、文档落盘位置。

装进你的代理

仓库根 README 的 Installation 节按代理给了不同安装通道(30-second setup):Claude Code 用 claude plugin install mattpocock-skills@claude-plugins-official(默认自更新);Codex 走 plugin marketplace 两连;GitHub Copilot 装完还要在 ~/.copilot/settings.json 里加一段 marketplace 配置;Gemini CLI 用 gemini skills install 指定 --path,手动重跑更新;其余代理(cursor、opencode、devin、windsurf、amp、pi)走 npx skills@latest add mattpocock/skills -a <agent>,安装器问带哪些技能时记得包含 setup-matt-pocock-skills,更新用 npx skills@latest update 再重跑 add。README 明确警告二选一:plugin 通道自更新,skills.sh 通道把可编辑文件拷进项目手动维护,两个都装会得到 every skill twice(每个技能装两遍)。

边界与实话

ask-matt 自己开着 disable-model-invocation: true——frontmatter 白纸黑字,意思是它不能被模型自动调用,必须由你显式喊它。agents/openai.yaml 里的接口元数据同样写着 allow_implicit_invocation: false,显示名 "Ask Matt"、短描述 "Find the right skill or workflow"。这不是缺陷,是路由器的本分:它管指路,不抢方向盘。

图 1 地图的结构同样别当真理用。SKILL.md 开头那句"the summaries here are for orientation only"已经说了:摘要只管定向,动手前读目标技能的 SKILL.md。另外仓库处于活跃迭代中——本文写作时仓库 star 数 292,542(GitHub API 实查),而本周早些时候入库的快照还停在 282,647,三天涨了近一万,命令清单与各技能定位以仓库最新版为准。它又是一张地图而非方法论:主线四步背后的拷问、规格、红绿施工各有整个技能支撑,单靠背下这张图写不出好软件——那是其余三十多个技能和它们各自文档的事。

本站同仓库系列已上线四篇:improve-codebase-architecture、implement-spec、domain-modeling、diagnosing-bugs,可按需跳读。

本文步骤与配图依据 mattpocock/skills 仓库 ask-matt/SKILL.md、PHASE-BOUNDARIES.md 及根 README 整理(2026-10-16 GitHub API 拉取),版权归原作者所有。

评论 (0)