Lesson 0003 · 一组配合使用的 skill · 主流程入口

grilling 与两个薄入口

「grill」在这里是「追着你面试、把模糊想法一点点问清楚」的意思。当你的计划还很糊、想被问清楚了再动手时，就会用到这一组 skill： grilling 装着面试规则的全文（AI 可以自己加载它）； grill-me 和 grill-with-docs 是给你按的入口，正文各只有一行，区别只有一个——聊完要不要把术语和决策写进仓库。 一个 skill 跑完会在仓库或工单系统里改动什么，这件事本课程叫它的副作用（side effects）。 学完这节课，你要能背出面试的几条规矩、三个 skill 各自的副作用、谁在调用谁，以及想改行为时去改哪个文件的哪一段。

1. 为什么一个 grill 要拆成三个 skill

假设你想给这套系统加一个「面试我」的功能。光看功能，好像一个 /grill 命令就够了， 实际却拆成了三个文件。这不是作者喜欢多建文件夹，而是被一条硬规则逼出来的。 0001 讲过这条规则，原文在 .agents/invocation.md： 每个 skill 的文件头部有一块配置区（frontmatter），写着谁能启动它—— 要么只能人手动启动（user-invoked），要么人和 AI 都能启动（model-invoked）； 而「只能人启动」的 skill，别的 skill 一律不许调用它。

这里出现两个本课会反复用的说法。prose 调用：在正文里写一句自然语言 「Run the /xxx skill」就算完成调用，不是代码层面的 import（0001 讲过）。 薄 wrapper（薄外壳）：grill-me 这种正文只有一行、自己不装任何规则、 只把真正的 skill 包一层给人用的入口。「入口薄、规则厚」是这套系统的固定拆法。

依赖的表达方式：用自然语言的 /skill 调用，禁止用 ../ 路径跨目录直接链接别的 skill 的正文来复用逻辑 （invocation.md 的 Dependencies 一节）。

你按的入口（User）         被复用的基本功（Model）
─────────────────        ───────────────────────
/grill-me            →   /grilling
/grill-with-docs     →   /grilling  +  /domain-modeling

别的完整流程（也是人启动）也直接调用基本功，而不是再包一层入口：
/triage （需要时）     →   /grilling  +  /domain-modeling
/wayfinder           →   /grilling  +  /domain-modeling  （画地图和拿不准的决策都用它）
/improve-codebase-architecture （选定候选后） → /grilling；写文件交给 /domain-modeling

2. grilling：面试规则的全文在这里

skills/productivity/grilling/SKILL.md 短得出奇——这是故意的： 整套系统里关于「怎么面试」的规则只写在这一个地方（single source of truth，唯一说了算的原文）， 别处需要就调用它，不各自抄一份。下面逐条拆读；解释对照 docs 和原文，不发明新规则。

Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.

面试的终点不是「问完 N 个问题」，而是达成 shared understanding（互相理解： 你和 AI 对同一份计划有了共识）。docs 给的心智模型是：一份计划就是一棵决策树—— 一个决定会牵出下一个问题，像树一样分叉；提问要按依赖顺序一个节点一个节点往下走， 因为先回答的父决策会改变后面该问什么。整棵树走完，你脑子里没说出口的假设也就被摆到明面上了。

Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.

「一次只问一题」不是礼貌，是让讨论能收敛的机制：如果一次性甩出一张问卷让你全答， 问题之间的依赖关系就丢了——你的前一个答案本来会改变后面的问题，现在改不了了。 典型的搞砸方式见 第 11 节。

3. 三条具体规矩：事实自己查 · 每题给建议 · 没对齐不动手

3.1 事实自己查，决策才问你

If a fact can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The decisions, though, are mine — put each one to me and wait for my answer.

这条和 domain-modeling 的「拿你说的话对照代码找矛盾」正好互补： 事实层面先去环境里查清楚，决策层面再坐下来谈取舍（trade-off：有得必有失、需要权衡的选择）。

3.2 每个问题都附上推荐答案

原文：For each question, provide your recommended answer。 docs（grill-me 篇）解释了为什么：有推荐答案时，你是在对一个提案做反应—— 说「行」「不行」「改成 X」就行——而不是对着一个空白问题从零开始想。 推荐答案可以被否决，但它先给了你一个默认起点，省掉冷启动的负担。

3.3 没确认互相理解之前，不许动手

Do not act on it until I confirm we have reached a shared understanding.

这里的「act（动手）」指的是开始实施计划：写实现代码、改动业务行为之类。 为了查事实而读文件不算「动手」，一直是允许的。 它和 to-spec 的分工是：grilling 负责把人对齐； to-spec 明确写着 Do NOT interview（禁止再面试）——只综合已经谈过的内容。 如果没有真正对齐就跑去 to-spec，写出来的需求文档就是一份「假共识」——看着像对齐了，其实没有。

4. grill-me：只有一行的入口

假设你还没有代码库，只是在琢磨一个点子，想被 AI 追着问清楚——这就是 grill-me 的位置。 它的 SKILL.md 正文（除了头部的 frontmatter 配置）实际上只有一行：

Run a `/grilling` session.

grill-me/SKILL.md · docs/productivity/grill-me.md · ask-matt 的 Standalone 一节

5. grill-with-docs：面试之外，顺手把结论写进仓库

再假设你已经有代码库了，脑子里一个 feature 还很糊。你想被问清楚，而且希望讨论出的术语和决策留在仓库里， 以后任何人（包括下一个 AI 会话）都能查到。这就是主流程的第一步。它的完整正文同样只有一行：

Run a `/grilling` session, using the `/domain-modeling` skill.

提问的部分还是 grilling 那套，一字不改；区别在答案落到哪里（docs/grill-with-docs）： 讨论清楚的术语当场写进术语表（glossary，也就是 CONTEXT.md）， 难回头的决策逐条记成 ADR。 这样即使会话关了，对齐出来的结论也还在仓库里活着。

它在主流程上的位置（docs）：

grill-with-docs → to-spec → to-tickets → implement → code-review

ask-matt 补充的分支：对齐之后，如果有问题必须「看见东西跑起来」才答得了，就走 /handoff → /prototype → /handoff 带回答案再继续主线； 一个会话做不完 → to-spec → to-tickets → 每张票新开一个干净会话 implement； 一个会话能装下 → 在同一个会话里直接 implement。

6. 写记录这件事是谁干的：domain-modeling

grill-with-docs 名字里的「docs」不是另外一套写文件的指令，而是挂上一个现成的、 人和 AI 都能启动的技能： domain-modeling。 这节课只讲「它对 grill 意味着什么」；术语管理的完整细节在 0004。

6.1 主动改模型 vs 只是读一下

invocation.md 和 domain-modeling 正文划了一条线： 只是读一下 CONTEXT.md、借用里面的术语，是任何 skill 都可以顺手做的习惯， 不算在用 domain-modeling。 这个技能指的是动手改模型：挑战模糊用词、追问边角场景、写术语表、写决策记录。

6.2 会话里它具体做什么（摘要）

• Challenge against the glossary（拿术语表对照） — 你的用词和 CONTEXT.md 冲突时立刻喊停
• Sharpen fuzzy language（把模糊的词改精确） — 提出精确的规范词，比如 account 到底指 Customer 还是 User
• Discuss concrete scenarios（聊具体场景） — 用具体的例子逼出边界情况
• Cross-reference with code（和代码对照） — 你说的和代码实现矛盾时，摊开来问「哪个是对的」
• Update CONTEXT.md inline（当场更新 CONTEXT.md） — 术语一解决马上就写，不攒到最后一起写；只写术语，不塞实现细节
• Offer ADRs sparingly（克制地提议写 ADR） — 三个条件同时成立才写

6.3 写到仓库的哪个位置

• 项目只有一套语境：根目录一份 CONTEXT.md；决策放 docs/adr/NNNN-slug.md（编号加短名的格式）
• 大项目分多套语境：根目录放 CONTEXT-MAP.md 当总目录，指向各区域自己的 CONTEXT.md 和各区域的 ADR 分册（按区域分开存放的决策记录）；全系统级的决策可以放在根目录的 docs/adr/
• 格式文件：skill 目录里的 CONTEXT-FORMAT.md / ADR-FORMAT.md（ADR 可以短到只有一段）

7. 三个入口怎么选 · ask-matt 怎么指路

7.1 按情境查这张表

7.2 ask-matt 的指路原文（压缩版）

• 有代码库 → 从 /grill-with-docs 开始；没有代码库 → /grill-me。
• 两者跑的是同一个 /grilling 基本功；只有 with-docs 会在仓库里留下书面记录。
• 从 grill →（可选的原型岔路）→ to-spec / implement 这条路上，到 to-tickets 为止尽量在同一个会话窗口里做完，避免中途压缩会话（compact）把共享的推理细节丢掉。
• wayfinder 解决的是「一次面试装不下的巨大模糊」；模糊散尽之后默认走 /to-spec，不要默认直接 implement。

指路原文： ask-matt/SKILL.md （main flow · standalone · vocabulary · research · improve 各节）

8. 总表：谁会动你仓库里的什么

「会改什么」只认各 SKILL.md 和 docs 白纸黑字的承诺；不脑补它会去写工单系统或改业务代码。

9. 面试完了，下一步接什么

上下文卫生（context hygiene，0001 讲过的省上下文规矩，出自 ask-matt）： 第 1–3 步（grill → spec → 拆票）尽量不换会话、一气呵成； 每次 implement 都新开会话，只带那一张票进去。

10. 还有谁在调用 grilling

在已发布的 skill 里，除了两个人工入口，至少还有三处在正文里 prose 调用 /grilling。注意：它们调的都是 AI 也能启动的 /grilling， 没有一处去调 grill-me / grill-with-docs——人工入口别的 skill 根本调不动。 in-progress 目录里的草稿不在本课范围。

triage/SKILL.md 的 Grill 一节 · wayfinder/SKILL.md 的 Ticket Types / Chart / Work 各节 · improve-codebase-architecture/SKILL.md 的 Grilling loop 一节

11. 想调行为去哪改 · 常见搞砸方式

11.1 去哪改

11.2 常见搞砸方式（对照原文）

• 一次甩出一堆问题 — 违反 “bewildering” 那一条；问题之间的依赖顺序也断了。
• 没确认就动手 — 违反 “Do not act… until… shared understanding”；常见于 AI 急着写代码、急着改架构。
• 拿事实来问你 — 本来读文件、跑工具就能查到的事，拿来浪费你的时间和注意力。
• 不给推荐答案 — 把思考负担全推回给你，削弱了「让你对提案做反应」的设计。
• 入口调入口 — 比如在某个流程的正文里写 Run /grill-me：AI 根本启动不了它，这条路走不通；应该写 Run /grilling。
• 往 CONTEXT.md 塞实现细节 — 违反 domain-modeling 的规定：那里只放术语表。
• 把 ADR 写成日记 — 三个条件没凑齐也写，把 docs/adr/ 污染成流水账。
• wayfinder 的人答题被 agent 代答 — wayfinder 正文写明：grilling agent 自己回答自己的问题，就算违规（has broken this）。

12. 检索练习

先别往回翻表，凭记忆答。选项字数刻意对齐，不会从长度泄题。

13. 原始材料 · 课程位置

本课的主要一手材料（请打开原文读，不要只背本页摘要）：

• skills/productivity/grilling/SKILL.md —— 面试规则全文
• skills/productivity/grill-me/SKILL.md —— 只有一行的入口
• skills/engineering/grill-with-docs/SKILL.md —— 面试 + 写记录
• skills/engineering/domain-modeling/SKILL.md —— 「写记录」这件事的权威原文（附 CONTEXT / ADR 的格式文件）
• skills/engineering/ask-matt/SKILL.md —— 主流程和独立工具的指路原文
• .agents/invocation.md —— 「user 不能调 user」和 prose 调用的规则原文
• 给人看的 docs（同一内容的叙事版）： grilling · grill-me · grill-with-docs · domain-modeling
• 调用 grilling 的三处原文： triage · wayfinder · improve-codebase-architecture

课程位置： 0001 系统地图 → 0002 setup（配置层：给每个仓库写一次配置）→ 本课 0003：grill 家族怎么配合 → 0004 domain-modeling / codebase-design（术语与模块词汇的深课）。