用途
grill-with-docs 是一个面向方案评审与领域建模的智能体技能。它的核心目标是在动手实施之前，通过持续提问，让用户与智能体对计划达成“共同理解”。它强调：决策属于用户，智能体负责提问、查证和记录。
主要能力
- 逐条提问：一次只问一个问题，等待用户反馈后再继续，避免一次性抛出多个问题造成混乱。
- 自行查证事实：如果某个事实可以通过探索代码库得到，就自行查找，而不是询问用户；但涉及决策的问题必须交由用户拍板。
- 领域感知：在探索代码库时，同时查找已有文档，包括 CONTEXT.md、CONTEXT-MAP.md 以及 docs/adr/ 下的 ADR 文件。
- 挑战术语表：当用户使用的术语与 CONTEXT.md 中已有语言冲突时，立即指出并请用户澄清。
- 收敛模糊语言：当用户使用含糊或含义过载的术语时，提出精确的规范术语建议。
- 具体场景压力测试：讨论领域关系时，用具体场景（包括边界情况）检验概念边界，迫使用户精确表达。
- 与代码交叉验证：当用户描述某功能如何工作时，检查代码是否一致；若发现矛盾，向用户指出。
- 即时更新 CONTEXT.md：术语一旦确定，立即写入 CONTEXT.md，不批量积压。CONTEXT.md 只作为术语表，不包含实现细节，也不是规格或草稿本。
- 谨慎建议 ADR：仅当决策同时满足“难以逆转”“缺乏上下文会令人困惑”“属于真实权衡”三个条件时，才建议创建 ADR。
使用方式
该技能以对话方式运行。用户提出一个计划后，智能体会围绕该计划逐条提问，沿着设计树的每个分支推进，逐一解决决策之间的依赖关系。每个问题都会附带智能体推荐的答案。在用户确认达成共同理解之前，不会执行该计划。
关于文件结构，资料给出了两种典型布局：
单一上下文的仓库：
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
多上下文的仓库（根目录存在 CONTEXT-MAP.md）：
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← system-wide decisions
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← context-specific decisions
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
文件按需惰性创建：若不存在 CONTEXT.md，在第一个术语确定时创建；若不存在 docs/adr/，在需要第一个 ADR 时创建。CONTEXT.md 使用 CONTEXT-FORMAT.md 中的格式，ADR 使用 ADR-FORMAT.md 中的格式。
适用场景
- 在开始实现前，需要把模糊的计划梳理清楚。
- 需要统一团队或项目中的领域术语。
- 需要让方案与现有领域模型、代码保持一致。
- 需要沉淀术语表和架构决策记录。
限制
- 在用户确认达成共同理解之前，不会执行计划。
- CONTEXT.md 仅作为术语表，不承载实现细节或规格内容。
- ADR 只在满足三个条件时才建议创建，否则跳过。
- 资料未提供该技能的安装命令、收费方式、支持平台等具体信息。