用 grilling 技能以设计树为骨架拷问你的方案把计划、决策与想法逐一过堂【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills导读本文讲解本仓库GitHub_Trending/skills13/skills一套面向真实工程师的 Agent Skills 集合中 productivity 分类下的核心原语级技能grilling。它以「设计树design tree 前沿frontier 轮次round」机制把一段拷问式访谈组织成可回答、可推进、可收敛的结构化对话专门用于在动手之前对计划、决策和想法做压力测试。读完本文你将掌握该技能的调用方式、轮次格式、事实与决策的职责切分以及它与grill-me、grill-with-docs、wayfinder、triage等技能的协作关系。grilling 是什么一次过堂式访谈grilling是一个**由模型自主调用model-invoked**的访谈循环用于在任何人真正动手之前对一个计划plan、一项决策decision或一个想法idea进行压力测试。其核心文档 skills/productivity/grilling/SKILL.md 开宗明义Interview the user relentlessly until you reach a shared understanding. Map this as adesign tree: every decision branches into the decisions that hang off it.即持续访谈用户直到双方达成共识把讨论对象建模为一棵设计树——每个决策都会分支挂出依赖它的后续决策。与逐条提问或一次性问完所有问题都不同它既不一问一答也不一次全问而是按**轮次rounds推进每一轮只问当前前沿frontier**上的全部问题——也就是所有前置条件都已确定的决策。两个问题若存在依赖关系绝不放进同一轮某个问题若依赖本轮尚未回答的答案则属于更晚的轮次。你的回答使决策落定前沿随之向外推移下一轮再问新解锁的问题。官方文档 docs/productivity/grilling.md 给出的典型效果是十三个问题通常落在约三轮里而不是十三轮。三个核心概念设计树、前沿与轮次grilling的整套机制由三个概念承载全部继承自原文档概念含义作用设计树design tree对讨论对象的建模决策之下再挂决策让被访谈的东西有结构可循避免漫无边际前沿frontier所有前置条件均已确定的决策集合决定现在能诚实地问哪些问题轮次round一次问完整条前沿、并等待全部回答的会话单元控制节奏不挤牙膏也不轰炸轮次内的问题有固定格式。每个问题都以❓开头、编号并给出标题随后是问题正文可多段、可含多个选项最后单独一行➡️给出 Agent 的推荐答案。完整模板如下来自 skills/productivity/grilling/SKILL.md❓ **Q1** - **问题标题**: 问题正文可为多段可含多个选项 ➡️ 你的推荐答案 --- ❓ **Q2** - **问题标题**: 问题正文可为多段可含多个选项 ➡️ 你的推荐答案这种编号 标题 正文 单独成行的推荐答案的固定形状使整个轮次可以用按编号作答的方式响应例如1 同意2 选第二个选项3 不同意原因如下而不是把问题原文逐字复述回去。这也是 docs/productivity/grilling.md 强调的整轮可按编号作答的关键设计。前沿的重算每一轮用户回答完毕已落定的决策就会把前沿向外推解锁原本依赖它们的下游问题Agent 需要重新计算前沿再问下一轮。某问题的答案依赖本轮仍在开放中的另一个问题就属于更晚的轮次而非本轮。官方文档也如实指出了前沿机制的边界前沿是 Agent 的判断而非计算出的图可能发生同一轮里两个问题其中一个答案本应改变另一个的粗糙边缘唯一的防线是用户当场指出下一轮重开受影响的分支。事实归 Agent决策归用户职责切分grilling的另一半设计是事实facts与决策decisions的严格分工这是 skills/productivity/grilling/SKILL.md 中反复强调的纪律寻找事实是 Agent 的本职绝不是用户的。当某个前沿问题需要环境中的事实文件系统、工具等时应派遣**子代理sub-agent**去查而不是问用户任何自己能查到的内容。探索不得阻塞轮次运行中的探索算未落定的前置条件只有依赖它的下游问题等待子代理回报前沿上的其余问题现在照问。决策属于用户每个决策都必须交由用户并等待其确认。一个运行grilling却自己替用户回答了决策的 Agent不是灵活诠释这个技能而是破坏了技能本身。会话结束条件当前沿为空时——设计树的每个分支都已访问、没有任何东西被静默假定——技能仍未结束必须等用户确认双方已达成共识才能据此行动。文档原话是Do not act on it until the user confirms you have reached a shared understanding.官方文档 docs/productivity/grilling.md 还解释了这个设计的由来曾经出现过 Agent自问自答的运行 bug这正是事实与决策被分离写入技能文本的原因。也正因如此该技能没有异步模式——有人曾要求一个读取 GitHub issue 后发布一份汇总决策备忘录的变体但文档明确回应那是另一个技能因为一场无人作答的 grilling 会话产出的只是 Agent 的观点而非你的决策。何时使用与调用方式触发方式多数时候不是你输入它在grilling家族中它是唯一由模型自主调用的技能frontmatter 中description声明 Use when the user wants to stress-test their thinking, or uses any grill trigger phrases见 skills/productivity/grilling/SKILL.md因此你很少会手动输入它——通常是你输入了另一个技能由那个技能替你运行它。其 Agent 配置 skills/productivity/grilling/agents/openai.yaml 中的描述为 Stress-test thinking a round of questions at a time可作为调用意图的快速判断依据。直接输入/grilling得到的是纯访谈仅此而已。需要更多时按场景选择包装技能表格来自 docs/productivity/grilling.md你的处境该用哪个不在某个工作目录下grill-me同样的会话但名字是 Agent 永远不会自行触发的在某个工作目录下grill-with-docs同样的会话并边进行边写CONTEXT.md和 ADR一个单次会话装不下的大工程wayfinder绘制路线图并在其中的决策票里运行 grilling靠谈话无法解决某事物应该长什么样/什么感觉prototype先做一次性原型再回来你自己的技能需要一次访谈直接调用/grilling而不是另写一套访谈各包装技能如何调用它grilling被定义为原语primitive访谈技术的唯一事实来源集中存放使每个需要访谈的技能都来调用它而不是各自发明一套。从仓库源码可以看到它被引用的具体方式grill-me 整个技能只有一行实质内容Call the Skill tool with grilling。因此单独安装grill-me而不装grilling是什么都不会发生的——它需要一个带grilling的本体。grill-with-docs 则Call the Skill tool twice, for grilling and domain-modeling即同时加载访谈技能与领域建模技能。wayfinder 将工作绘制成 issue tracker 上的决策票地图其中Grilling 票HITL人在回路是其默认情况Always call the Skill tool twice, for grilling and domain-modeling并强调一个自己回答自己问题的 grilling Agent 已破坏此约定。triage 在处理模糊 issue 时也调用这两者call the Skill tool twice, for grilling and domain-modeling, and grill it into shape a round of questions at a time把一份含糊的报告盘问成可执行的形式并同步更新CONTEXT.md/ADR。improve-codebase-architecture 在用户选定一个架构深化候选后同样 call the Skill tool with grilling to walk the decision tree。另外需注意grilling的 frontmatter 没有disable-model-invocation: true与grill-me的 skills/productivity/grill-me/SKILL.md 中disable-model-invocation: true形成对比这正是它可由模型主动触发的配置体现也对应 skills/productivity/README.md 中将grilling归入Model-invoked模型或用户可达的分类。常见问题与已知边界来自官方 FAQ官方文档 docs/productivity/grilling.md 用一整节 FAQ 回答了实操中最常被问的问题以下内容均忠实继承可以退回一问一答吗可以而且相当一部分用户就这么做。在全局CLAUDE.md中加入一行即可When grilling, ask one question at a time.轮次式默认是确有争议的阅读慢的实践者、用第二语言工作的人、把顺序格式当专注脚手架的人都反馈一问一答的节奏更适合他们官方明确这是被支持而非被容忍的退出通道。/batch-grill-me去哪了并入了本技能。轮次式提问曾短暂作为独立技能发布随后移入grilling自身因此所有构建在该原语之上的技能grill-me、grill-with-docs、triage、wayfinder一次性全部获得该能力。现在既没有batch-grill-me可安装也没有独立的顺序式技能上面那行CLAUDE.md就是回到一问一答的途径。一次问完整轮不会丢失我前几个回答本该引发的问题吗这是对轮次设计最常见的质疑而前沿正是答案一轮只包含互不依赖的问题因此轮内任何答案都不会使同轮其他问题失效。答案仍会重塑下游一切——下一轮是重算的不是预先写好的。失去的东西小于一次性全问给人的印象也大于什么也没失去。它问完了问题就开始动手构建了。确认门槛confirmation gate正是为此而设前沿清空并不代表技能完成你说共识已达成才算完成。较弱、较快的模型仍会破坏这一点最常见于低投入或非前沿型模型——它们会把访谈至共识坍缩成两三个问题加一份大纲。可靠的修复是在你自己的AGENTS.md或CLAUDE.md里加一行未经许可不得实施。它替用户回答了自己的问题。这是运行中的 bug不是预期行为也正是技能文本把事实与决策分离的原因。它最常出现在另一个技能以解决这张票的框架运行grilling时——周围的任务读起来像是继续推进的许可证。这也解释了为何没有异步模式。可以限制问题数量吗不能上限被刻意排除在范围之外。有些计划需要三个问题有些需要五十个固定上限要么截断困难情形要么在简单情形显得武断。用自然语言指挥才是预期控制手段让它收尾或者就地停下接受现有计划。若会话拖得过长原因通常是范围太大——把工作拆开逐块拷问。单独安装了grill-me却毫无反应。因为grill-me是一个单行技能正文就是运行一场/grilling会话所以它同样需要安装grilling本体grill-with-docs同理且额外依赖 domain-modeling。整套安装可避免此问题选择性安装则必须连原语一起装。grill-with-docs运行了但从未加载grilling。这是一个真实且未修复的粗糙边缘在多种 harness 和模型上都有报告一个技能指名另一个技能并不保证后者会被可靠加载而grill-with-docs指名了两个grilling与domain-modeling。征兆是一次问完全部问题、且不附带任何推荐答案——那是模型即兴发挥的访谈而非本技能。直接问 Agent 是否加载了grilling和domain-modeling通常能恢复。成功判据如何知道 grilling 在正常工作官方文档给出了 7 条working判据可作为自查清单继承自 docs/productivity/grilling.md一轮以编号列表抵达每个问题都带独立➡️行的推荐答案且整轮可按编号作答轮内没有任何问题需要先回答同轮另一个问题后续轮次问出了第一轮不可能问的问题它主动去查事实读文件、派子代理而不是问你本可以自己查的东西后台运行的研究不会卡住轮次只有依赖它的问题才等待它会在最后停下请你确认共识已达成而不是直接开始干活问题总数保持高位而轮次数保持低位。从 docs/productivity/grill-me.md 还能得到一组互补的用户视角判据你会在某处与它意见不合一场没有来自你的反驳的会话是你本不需要的会话问题在几轮内抵达而非细水长流你最终到达了自己没预料到的地方某个问题暴露了你一直隐式做出的决策结束时你能为每个选择向不在场的人辩护。它在一个技能生态中的位置grilling是原语不是安排在流程里的某个步骤。整个技能生态的访谈能力都以它为单一事实来源两个用户触达前门grill-me无状态写零文件可在任何地方对任何事运行主题不必是代码与 grill-with-docs有状态读取代码库对齐把所学写进CONTEXT.md与 ADRgrill-with-docs又是主构建链的起点衔接 to-spec。被嵌入的大型流程wayfinder 用它解决决策票triage 用它把模糊报告盘问成可执行形态improve-codebase-architecture 用它走深候选方案的设计树。路由与配套不确定该用哪个入口时ask-matt 负责导流访谈中涉及术语澄清、CONTEXT.md更新与 ADR 记录时配套 domain-modeling 技能按需并行工作。如果你正在编写自己的技能且需要一次访谈正确的做法是直接调用/grilling而不是另写一套访谈逻辑——这正是原语设计的本意。小结grilling用一棵设计树、一条前沿和一轮轮按格式编号的提问把拷问一个想法从随意的头脑风暴变成了可复现、可收敛、职责清晰的工程流程事实由 Agent 与子代理负责查证决策必须交还用户前沿清空后还需用户确认共识才能行动。无论是直接输入/grilling还是经由grill-me、grill-with-docs、wayfinder、triage等包装技能被间接触发它都以同一套轮次机制工作是整个技能集中访谈能力的单一事实来源。对于想为自己的技能引入访谈环节的开发者掌握它的轮次格式、前沿纪律与事实/决策切分是让拷问真正产生价值的关键。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考