Appearance
grill-with-docs 解决的是 AI 写代码前听不懂项目语言的问题。它不是普通追问需求，而是带着 CONTEXT.md、ADR 和现有代码一起追问：你说的词在项目里到底是什么意思，这次方案有没有和已有决策冲突。
AI 写代码前怎么把术语问清楚：grill-with-docs 怎么用
下载 grill-with-docs 中文版 Skill ZIP
很多 AI 编程翻车，不是因为模型不会写代码。
是因为它把你的词理解错了。
你说“账户”，项目里可能有 User、Customer、Billing Account。你说“取消”，代码里可能只有整单取消，没有部分取消。你说“同步数据”，历史 ADR 里可能已经决定不能做实时同步。
grill-with-docs 这个技能适合在动手前使用。它会让 AI 先读项目语言，再一轮一轮追问计划里的模糊点。
它和普通需求澄清不一样
普通需求澄清只围绕你刚说的话问问题。
grill-with-docs 会多看三类东西：
CONTEXT.md：项目里的领域词汇。docs/adr/：已经做过的架构决策。- 相关代码：确认你描述的流程和实际实现是否一致。
这会让问题更具体。
普通问法可能是：“这个功能有哪些边界？”
更好的问法是：“CONTEXT.md 里 Customer 和 User 是两个概念，你这次说的账户指哪一个？”
适合什么时候用
这个技能适合这些场景：
- 新功能会碰到多个领域概念。
- 需求里有很多口头词，比如账户、订单、任务、素材、配置。
- 你准备改已有系统，不确定历史决策。
- 你担心 AI 按自己的理解新造一套词。
不适合用在很小的改动上，比如改一个按钮文案、修一个 typo、补一个简单链接。
追问要一次一个问题
grill-with-docs 的节奏很重要。
它不是一次列出十几个问题让你填表，而是一次只问一个关键问题。每个问题解决以后，再继续往下走。
可以这样要求 AI：
md
在写代码前，先按 grill-with-docs 的方式审这个需求。
请先读取 CONTEXT.md 和相关 ADR。
如果我使用了和项目术语冲突的词，先指出冲突。
一次只问一个最关键的问题，并给出你的推荐答案。一次一个问题会慢一点，但能避免需求澄清变成另一份没人看的问卷。
什么时候写进 CONTEXT.md 或 ADR
这个技能还有一个价值：边问边沉淀。
如果只是本次任务里的临时选择，不需要写文档。
如果问出了一个未来还会反复遇到的术语，比如“素材”和“草稿”的区别，就适合写进 CONTEXT.md。
如果问出了一个难回头、未来读者会困惑的技术取舍，比如“为什么不用实时同步”，才适合写 ADR。
不要为了显得规范，把每个回答都写成 ADR。文档太多，后面 AI 也会读不动。
你可能还需要
同类技能：
如果这次需求里已经出现多个含糊词，先别让 AI 写代码。让它读项目文档，再把词问清楚。