📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★★☆☆☆
    🧪 测试★★★★☆★★☆☆☆
    📦 产品★★★★☆★★★☆☆

    🎯 学习产出： 掌握带文档的访谈流程，能把模糊想法磨成清晰决策并留下 CONTEXT.md 和 ADR 纸面痕迹

    🚀 AI 能力提升： 需求澄清、领域建模

    /grill-with-docs

    预计阅读时间: 3 分钟

    带文档的访谈。对计划或设计进行不留情面的追问，同时构建项目的领域模型：每解决一个术语就写入 CONTEXT.md，每落定一个难逆转的决策就写 ADR。它是主流程的第一步——从想法到交付的入口。

    概述

    它是 /grill-me 的"留痕"版本：同样跑 /grilling 访谈引擎，但额外驱动 domain-modeling 把访谈结晶写下来。只要有仓库在，就用它——纸面痕迹让访谈的成果跨会话存活。

    日常使用

    /grill-with-docs 我想做一个会员订阅系统
/grill-with-docs 我们想支持部分取消订单

    它内部调用两个技能：

    • grilling — 访谈引擎：把决策映射成设计树，按轮次推进，一轮问完整个前沿，每个问题附推荐答案
    • domain-modeling — 领域建模：挑战术语、精化模糊语言、就地更新 CONTEXT.md 和 ADR

    实战

    > /grill-with-docs 我们要支持"部分取消订单"

❓ Q1 - 取消语义: 订单部分取消后，剩余部分继续履行吗？
➡️ 是——把"取消"建模为订单行的操作，而不是整个订单

❓ Q2 - 术语冲突: 你的 CONTEXT.md 里"cancellation"定义为整单取消，
    现在却说部分取消，哪个对？
➡️ 建议精化术语：整单取消 = "cancellation"，部分取消 = "line cancellation"

    访谈中每落定一个术语，CONTEXT.md 当场更新（词汇表只收领域语言，不掺实现细节）；遇到难逆转、无上下文会困惑、真实取舍的决策，agent 会提议记成 ADR。

    结束条件：设计树的前沿为空——每个分支都被访问过，没有东西被默默假设。用户确认达成共识之前不动手。

    与其它技能的关系

    • 上游：主流程第一步，后续走 /to-spec（合成规格）或直接 /implement
    • 并行：需要可运行的答案时绕道 /handoff → /prototype → /handoff
    • 底层：grilling（引擎）+ domain-modeling（建模）
    • 无仓库替代：/grill-me（无状态版）