关于 deep-grill
deep-grill 是一款通过证据和分支决策审视想法或计划的交互式技能,帮助用户明确产品需求或检验既定方案,并输出确认后的 Product Brief 或审计结论。
主要功能
- 01发现与审计模式
- 02基于证据调查决策分支
- 03按优先级组织用户决策
- 04输出 Product Brief 或审计结论
- 05支持原生提问或文本提问
适用场景
- 01梳理初步产品构想
- 02审视已形成的设计或计划
- 03处理依赖用户优先级的决策
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nxxxsooo/ deep-grill --skill deep-grill安装后在 Claude Code 中输入/deep-grill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.gitignoreREADME.zh-CN.mdTHIRD_PARTY_NOTICES.mdNOTICEREADME.mdagents/openai.yamlreferences/grilling-upstream.mdscripts/check-readme-sync.py详细介绍
Deep Grill
在发现模式或审计模式下运行一个以证据为依据的分支循环。事实由 Agent 掌握;目标、优先级、风险承受度、偏好和决策权则属于用户。
选择模式
当输入是一个未经梳理的想法、用户要求接受访谈或澄清、loop 提供了尚无现成产品简报的工作,或不同方案取决于由用户决定的决策树时,使用发现模式。其输出是一份经确认的产品简报。
当用户提供了成形的计划、设计、决策或隐含方案,并希望自主进行压力测试、给出结论或提出修订时,使用审计模式。其输出是一份审计结论。
如果一开始无法确定模式,就陈述并审计最小可行方案。只有在继续进行会擅自补充一项实质性的用户决策时,才切换到发现模式。发现模式可以在提问轮次之间使用审计轮次;两种模式共用同一棵决策树,不会将工作交给另一个审查技能。
保持会话持续
Deep Grill 启动后,将用户对提问轮次的每个回答都视为同一会话的延续。根据对话和产物重建当前分支树,应用回答并继续。用户无需再次调用 deep-grill 或 loop。
当用户确认产品简报或审计结论、要求停止、明确切换任务,或在 Deep Grill 完成后授权进入单独的下一阶段时,结束会话。
处理各个分支
按依赖顺序梳理重要分支。前沿是指所有前置条件均已确定的分支。
使用可用环境、来源、测试和有限实验调查事实分支。对于每个暂定答案,提出最有力的反对意见和具体失败情景,以决定保留、修订还是否决该答案。证据不足时,应标明并提供验证路径,而不是编造事实。尚未解决的事实核查只会阻塞依赖它的分支。
只向用户询问 Agent 无法自行决定的前沿决策。每次回答或证据变化后,重新计算前沿。按影响、确定性和可逆性确定优先级;当收益递减时停止。
使用原生提问方式
在提出第一个用户决策前,根据当前客户端的工具元数据,确定其原生提问界面目前是否可调用、在当前模式下是否不可用,或是否不受支持。
- 如果可以调用,则本轮使用一次原生提问调用,并尽可能纳入工具支持的所有前沿决策。
- 如果在当前模式下不可用或不受支持,则立即用简洁的本地化文本提出相同问题。保留待处理的前沿和推荐选项,然后根据普通回复继续。
- 如果用户明确选择使用文本,则以简洁的编号文本保留相同的前沿和推荐选项结构。
每个原生问题和文本备用问题都应询问一项决策,提供两个或三个互斥选项,将推荐选项放在首位并标明,用一句话说明其主要权衡,并保留自由填写的空间。成功进行原生提问后,不要再用 Markdown 重复提问。
发现模式输出
当所有重要的用户决策分支都已确定后,生成一份简洁的产品简报,包含适用字段:
Product / offer:
Target user and context:
Problem and desired outcome:
Constraints and must-preserve behavior:
Non-goals:
Confirmed decisions:
Evidence and assumptions:
Success scenarios:
Residual risks:
当原生提问界面可调用时,通过该界面请用户确认简报;否则按照相同模式规则,使用简洁的本地化文本备用方式。只有在用户确认后且没有未解决的根级产品决策时,简报才可交由 deep-design 处理。
审计输出
报告目标、判定结论、建议的修订、支持证据、最有力的反对意见、失败场景、证据局限、剩余风险、未解决事项以及未审查的范围。在审计中保留一到两个范围明确的用户选择,并遵循相同的原生提问和文字回退规则。如果出现决策树,请继续保持探索模式,而不是推荐另一个盘问技能。
在用户确认 Product Brief 或单独授权进入下一阶段之前,不要实施或以其他方式执行 Product Brief 或判定结论。
上游交互式盘问约定中纳入探索模式的部分保留在 references/grilling-upstream.md 中。