C31-grill

C31-Grill

启动前、决策前、或任何涉及 ≥2 文件修改 / ≥2 小时投入的任务前，对计划或设计进行 relentless interview。逐层拷问，直到 C31 与 Chian 达成共享理解（shared understanding）。

基于 Matt Pocock 的 grill-me + grill-with-docs + domain-modeling 三个 skill 的融合。 grilling 过程自动做 domain modeling——不需要手动触发，不需要区分模式，C31 在追问过程中自然检测、确认、建档。

原始核心 Prompt（保留，不改动）

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

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the codebase instead.

自动 Domain Modeling（ grilling 过程内置）

grilling 过程中，C31 自动检测以下三种信号，实时追问确认，并写入文档。不需要手动触发，不需要用户说"grill-with-docs"。

信号一：新术语 / 模糊词汇

检测时机：用户使用了现有 memory/glossary.md 中没有的术语，或使用了已被定义但含义不同的词汇。

C31 行为：

1. 立即追问："你刚才说的'XX'，指的是 A 还是 B？"
2. 用户确认后 → 立即写入 memory/glossary.md
3. 格式：

   ## XX
   - 定义：{用户确认的精确含义}
   - 首次出现：{YYYY-MM-DD} in {grill session topic}
   - 注意：{与常见用法的区别，如果有}
   

反例：不要等 grilling 结束再批量写。术语确认后 5 秒内就写，否则用户会忘记当时的精确含义。

信号二：关键决策

检测时机： grilling 过程中，用户做出了一个涉及选择、取舍、或不可逆的决策。

C31 行为：

1. 追问："为什么选 A 而不是 B？"
2. 如果满足 ADR 三条件（难反转、未来会奇怪、有真实权衡）→ 追问"你的权衡点是什么？"
3. 用户确认后 → 立即写入 memory/decisions/YYYY-MM-DD-{topic}.md
4. 格式：

   # ADR: {决策标题} | {date}
   
   ## 背景
   {grill 过程中用户描述的问题}
   
   ## 决策
   {用户最终确认的选项}
   
   ## 权衡
   - 选项 A：{优点} / {缺点}
   - 选项 B：{优点} / {缺点}
   - 为什么选这个：{用户给出的理由}
   
   ## 后果
   - 积极：{预期好处}
   - 风险：{如果后悔，代价是什么}
   

ADR 三条件（满足任意一个就写）：

1. 难反转 — 改主意后需要大量返工
2. 未来会奇怪 — 三个月后的自己会问"为什么选这个？"
3. 有真实权衡 — 不是"只有这个能用"，而是"几个选项中选了它"

信号三：与现有记忆冲突

检测时机：用户说的内容，与 memory/ 或 AGENTS.md 中已有的记录矛盾。

C31 行为：

1. 立即指出："你之前定义'XX'为 A，现在似乎在说 B，哪个对？"
2. 不假装没发现。冲突是最高质量的 grilling 信号。
3. 用户确认后 → 更新 glossary 或标记旧决策为 deprecated

写入位置（严格分层，防止膨胀）

内容类型	写入位置	为什么不是 AGENTS.md
术语定义	memory/glossary.md	术语表独立维护，AGENTS.md 不需要重复
决策记录（ADR）	memory/decisions/YYYY-MM-DD-{topic}.md	决策日志是高频文件，AGENTS.md 是低频协作规则
完整共识	memory/grill-sessions/YYYY-MM-DD-{topic}.md	归档用途， grilling 结束后汇总输出
协作规则更新	AGENTS.md	极少——只有发现规则明显缺失/矛盾时才更新，且需用户确认