grill-with-docs：带文档的拷问式对齐

文档摘要

grill-with-docs：带文档的拷问式对齐 grill-with-docs 用一连串尖锐提问把你和 AI 代理的对齐做扎实，同时顺手建立项目的共享语言（领域模型），更新 CONTEXT.md 与架构决策记录。它是整个工程流程最值得用的入口。动手前先被「拷问」一遍：把需求聊透，顺带沉淀出项目专属的共享语言与架构决策。它解决什么问题你和 AI 代理之间存在沟通鸿沟——你以为它懂了，结果它做出的东西完全偏题。更糟的是，代理进项目后靠猜术语，二十个字能说清的偏要用一堆废话。

grill-with-docs：带文档的拷问式对齐

grill-with-docs 用一连串尖锐提问把你和 AI 代理的对齐做扎实，同时顺手建立项目的共享语言（领域模型），更新 CONTEXT.md 与架构决策记录。它是整个工程流程最值得用的入口。

动手前先被「拷问」一遍：把需求聊透，顺带沉淀出项目专属的共享语言与架构决策。

它解决什么问题

你和 AI 代理之间存在沟通鸿沟——你以为它懂了，结果它做出的东西完全偏题。更糟的是，代理进项目后靠猜术语，二十个字能说清的偏要用一堆废话。

何时使用

开始任何有实质改动的任务之前
项目里还没有统一的领域术语，代理经常用词漂移
要做一些难以解释的架构决策，需要留痕

核心工作流

关键原则与反模式

对齐先于实现：没聊透就不动手
共享语言能极大压缩后续沟通的 token 成本，变量、函数、文件命名都跟着统一
难以解释的决策写成架构决策记录（ADR），让后人知道「为什么这么定」
这是整个仓库里最值得反复使用的技能，没有之一

与其他技能的配合

grill-with-docs 是工程主链路的起点。对齐完成后，通常接 to-spec 把对话收敛成规格，再走 to-tickets、implement。它的「共享语言」能力也是 domain-modeling 的前置。

常见问题

grill-with-docs 和 grill-me 有什么不同？

grill-me 是通用版（非代码场景也能用）；grill-with-docs 在 grill 的基础上额外帮你建立领域模型、更新 CONTEXT.md 并写 ADR，更适合工程场景。

CONTEXT.md 和 ADR 是什么？

CONTEXT.md 是项目的「共享语言词典」，让代理一眼读懂术语；ADR 是架构决策记录，记下重要且难解释的设计决定及其理由。

返回章节：工程技能完全指南