Reference · User-invoked · Router

ask-matt 速查

22 个 skill 的路由器口袋版:处境 → 该去哪。完整教学见 Lesson 0019; 原文见 SKILL.md(地图权威原文)、 agents/openai.yamldocs 叙事版

一句话

你描述处境,它告诉你哪个 skill、哪条 flow、从哪一步进。 它只定向、不执行:不面试、不写文档、不改代码,跑完什么都不留下。 它存在是因为 user-invoked skill 没人替你触发——ask-matt 是你外包出去的记忆力。

何时伸手 / 何时跳过

路由器词汇

Flow
一条穿过多个 skill 的路线;单个 skill 只是路上的点。
Main flow
默认路线 idea → ship:grill → spec → tickets → implement → review。
On-ramp
半路入口:一种产生工作、再并上主流程的起始处境(triage / diagnosing-bugs / wayfinder)。可选,非必经。
Codebase health
保养而非功能开发;常驻习惯,只有 improve-codebase-architecture 一格。
Vocabulary underneath
词汇地板:domain-modeling(领域语言)+ codebase-design(模块形状),各自词汇的唯一权威出处。
Crossing sessions
跨会话:/handoff 换窗口搬文件(fork);/compact 同窗口摘要(continue),阶段中途禁用。
Standalone
完全在主流程之外:grill-me / prototype / research / teach / writing-great-skills。
Precondition
第一条工程流程前先跑 /setup-matt-pocock-skills;自定义工单系统也支持。
Smart zone
模型推理仍敏锐的窗口(约 120k token);逼近就别硬推,/handoff 换线程。

主流程卡(idea → ship)

  1. /grill-with-docs 磨想法(有代码库;留 CONTEXT/ADR)。没代码库 → /grill-me
  2. 分支①:嘴说不清?→ /handoff 出 →(新会话)/prototype/handoff 带回答案
  3. 分支②:多会话大活?是 → /to-spec/to-tickets(曳光弹票 + 阻塞边)→ 每票清上下文 /implement;否 → 同窗口直接 /implement
  4. /implement 内部驱动 /tdd(红绿片),收尾 /code-review(Standards + Spec 两轴),然后 commit
  5. 单用出口:/tdd 做一个小行为;/code-review 对着固定点审分支/PR

上下文卫生

  1. grill → spec → tickets:同一个不中断窗口,/to-tickets 之前不 compact
  2. 每次 /implement 新开干净会话,只带一张票
  3. 逼近 smart zone 还在 tickets 之前 → /handoff,别在降级状态硬推

半路入口与保养

处境入口并线点
别人提的 bug/需求堆起来了/triage产出 agent-ready issue → /implement。自己的 to-tickets 票不要再过它
难缠的 bug(看不透/间歇/回归)/diagnosing-bugs先要有「一条已经变红的命令」;修完发现没好接缝 → 复盘移交 /improve-codebase-architecture
大到雾到一个会话装不下/wayfinder画决策票地图,产出决策不是交付;雾散移交不建造 → 默认 /to-spec,别直接 implement
一有空,保养代码库/improve-codebase-architecture勘察找加深候选;挑中一个 = 新想法 → /grill-with-docs。勘察是 survey,codebase-design 是 bench

独立工具

不在地图上

resolving-merge-conflicts 在 0001 名册里、不在这张地图上—— 地图是路由指南,不是完整名册;名册看 .claude-plugin/plugin.json 与 0001。

副作用

什么都不改,只在对话里指路。 不写文件、不动工单系统、不产生 commit。痕迹由它指到的那个 skill 留下。

下一步

微调入口