
以设计树与前沿驱动的审问式访谈Nx 仓库 grill-me Skill 协议全解析【免费下载链接】nxThe Monorepo Platform that amplifies both developers and AI agents. Nx optimizes your builds, scales your CI, and fixes failed PRs automatically. Ship in half the time.项目地址: https://gitcode.com/GitHub_Trending/nx/nxgrill-me 是 Nx 仓库中随 Claude Code 分发的 AI 技能Skill它定义了一套可复用的交互协议围绕一个计划、设计、决策或一组评审发现AI 助手以轮次rounds为单位、沿着设计树design tree逐层向用户发问直到没有任何一个前提仍处于被默默假设的状态。本文以 .claude/skills/grill-me/SKILL.md 为骨架结合仓库内两个真实调用方review-pr 与 review-pending-pr-reviews的落地细节完整拆解其心智模型、提问格式、两条铁律与委托评审发现场景的三轮工作流让你既能复刻这套协议也能看懂 Nx 的 AI 代码评审流水线为何依赖它作为人机共识的最后一道闸门。技能定位grill-me 是什么、何时被调用技能文件的 YAML frontmatter 给出了它的身份定义name: grill-medescription对用户的计划、设计、决策或一组评审发现进行不懈的拷问按轮次推进决策树直到没有任何东西被默默假设。触发条件包括用户说grill me或其他技能如/review-pr把它的评审环节委托过来。allowed-toolsRead、Grep、Glob、受限的git/gh命令、Agent、AskUserQuestion、Edit、Write——注意它被明确授予了**派发子代理Agent**的权限这是事实由 AI 负责查证这一原则的基础。从调用关系看grill-me 不是孤立存在的玩具在 Nx 仓库的 AI 评审流水线中它被两处真实技能委托调用构成评审结果必须经过人确认的强制环节review-pr 的Step 8.5草稿写好后、沙箱销毁前调用/grill-me对每条发现逐条审问审问结论直接改写草稿与 verdictreview-pending-pr-reviews 的Step 3面向由 cron 批量产出的待发布草稿在发布前先 grill被该技能称为真正的评估闸门the real evaluation gate。也就是说grill-me 承担的是把AI 产出的判断转成用户亲口确认的共识这一关键转换——任何未经此环节的结论都不得进入下一步行动。核心心智模型设计树Design Tree与前沿Frontier文档开篇给出两个相互咬合的概念设计树把讨论对象映射为一棵决策树——每个决策都会分支展开为挂在其下的后续决策。计划、设计、评审发现都可以抽象成树根是主题枝是前置决策叶是依赖前置决策才能提出的问题。前沿frontier当前所有前置条件已经settled、可以现在就问的决策集合。前沿之外的问题是那些还依赖未决答案的问题——它们属于更晚的轮次不属于本轮。访谈按轮次推进一轮中把整个前沿一次问完每个问题编号并给出 AI 自己的推荐答案等待用户回答后才进入下一轮。每轮回答都会重塑决策树——已settled的决策把前沿向外推解锁之前被阻塞的问题然后重新计算前沿、再问下一轮。判定一个问题的答案依赖本轮中另一个仍未决的问题时它必须被归入更晚的轮次。循环终止条件是前沿为空每一条分支都被访问过、没有任何东西被默默假设。文档特别强调在用户确认达成共识之前不得基于讨论结果采取行动。标准问题格式每道问题必须按统一模板格式化编号 标题 正文可多段、包含可选方案 推荐答案❓ **Q1** - **question title**: question body, may be several paragraphs, including any choices ➡️ your recommended answer给出推荐答案不是可选项它强迫 AI 先亮出自己的立场用户只需确认或反驳从而把对话成本降到最低。事实是 AI 的职责决策是用户的职责文档用一句话划清了责任边界Finding facts is your job, never the users.找事实是你的工作永远不是用户的。当前沿问题需要环境中的事实时派发子代理去查这正是allowed-tools里Agent的用途绝不向用户询问你自己能查到的东西但不阻塞正在进行的探索是一个未settled的前置条件所以只有它下游的问题需要等待前沿的其余部分照常问完真正需要用户拍板的是决策——把每个决策放到用户面前然后等待。两条铁律无论调用方是谁都必须成立文档用专门的章节列出两条跨调用场景成立的规则它们是这套协议不沦为走过场的底线绝不替用户回答问题Never answer your own questions。如果一轮问题无人回答就停止并让讨论对象保持原样。一个自己编造答案的 grill 是在制造从未发生过的同意所有信任其结果的下游步骤都会继承这份伪造。沉默意味着停止而不是用显而易见的答案继续推进。跳过已经settled的问题Skip what is already settled。调用方自己的材料已经回答的问题再问就是噪音。协议的目的是消解真实的不确定性而不是机械地走检查清单。这两条规则的组合效应很微妙第 1 条让冷启动提问变得危险见下节第 2 条则保证 grill 不会变成无意义的冗长审问。场景一调用方委托一组评审发现Delegated Findings当 grill 的对象不是用户自己写的计划而是来自其他代理、用户从未读过的评审发现时文档给出了一套专门的流程——这是 review-pr 与 review-pending-pr-reviews 实际采用的形态。开场必须简报Brief before the first question与用户自己写的计划不同评审发现来自用户没读过的代理因此第一问之前必须先做简报说明评审了什么、按层级tier给出每条发现的一句话清单。随后每个问题都要内联重述它对应的那条发现而不是用编号指代——关于一个用户从未见过的缺陷的问题是不可回答的而按照铁律一一个未回答的问题会演变成全线停止。所以冷开场并不会让 grill 变得谨慎只会让它什么都产不出来。评审发现之间的树是浅而宽的评审发现彼此大多独立因此依赖关系不落在条目之间而是落在层级tier之间轮次结构因此固定为三层Round 1 —— 阻塞性发现blocking findings它们决定 verdict且彼此独立所以整个层级构成一个前沿一次问完。Round 2 —— 其余发现 Round 1 解锁的内容把某条发现判定为已存在pre-existing通常会把同文件或同模式下的兄弟发现牵扯进来而这些问题是 Round 1 落地之前无法提出的。Round 3 —— 后果consequences由幸存下来的发现推出的最终结论以及用户把推理推广成长期规则的部分。逐轮应用而非最后一次性行动每轮答案必须在问下一轮之前应用到草稿上而不是收集完所有答案再统一处理——这样用户可以在任意一轮之后停下并且保留已经决出的价值。对于评审发现每轮的应用就是丢弃drop、重新分层re-tier、或保留keep对应发现。收尾再简报Close by briefing again前沿为空时把开场简报对照 grill 之后的状态重新渲染一遍展示什么发生了变化——丢弃了哪些、重新分层了哪些、保留了哪些——然后询问这与你所做的决定是否一致。原因很实际答案是逐轮、逐条给出的没有人能在脑子里追踪六条答案的累积效果而且材料在过程中一直在被修改。收尾简报是确认confirmation而不是新一轮不得重新打开已settled的条目也不得提出 grill 从未问过的事。如果用户的回复确实打开了真正的新东西那才是一个新轮次——按正式流程重新 grill。场景二review-pr 的 Step 8.5 —— 沙箱尚存活时的交互式审问review-pr 在 Step 8.5 中对grill-me的调用展示了这套协议在真实评审流水线中的完整约束具有极强的可操作参考价值时机必须在 Step 9销毁沙箱之前运行因为 grill 的核心问题这真的是 pre-existing 吗需要读--ref base来回答而清理步骤会摧毁唯一的检出副本。副作用是沙箱要为访谈全程存活——如果维护者中途离开直接停止并照常执行清理磁盘上的草稿本身已经是有效的。跳过条件REVIEW_NONINTERACTIVE被无头调用方review-prs、评审 cron设置时整个 Step 8.5 被跳过——因为那里没有人来回答。开场简报模板PR 号与标题、改动的一句话描述、草稿 verdict 及其驱动因素如1 Critical无 Critical、6 Important、按层级列出每条发现每条一行file:line — claimPre-existing 与 Suggestions 只列出存在而不参与 grill。简报故意不重印草稿——有些草稿达数百 KB重印简报等于没有简报。每个问题自带证据每条发现内联重述其 claim、NET-NEW行、TRIGGER行以及一句为什么这条不确定。说不清某条发现哪里不确定就等于没有问题——那条发现已经settled不属于 grill。Step 8.5 为每条发现固定问三个问题Does it hold?它成立吗——缺陷是否如描述般真实而不只是貌似合理Is it this PRs?它是这个 PR 的吗——NET-NEW证据是否支撑还是 pre-existing /widensIs the tier right?层级对吗——Critical PR 现在产出的东西是错的Important 以后会错或未设防。事实问题自己答如果某轮争执于 base 是否真的行为不同直接读--ref base或派子代理去查而不是让维护者回忆——这是检出仍存在的最后一步。每轮后重算 verdict丢弃最后一条 Critical 会让 PR 从needs-changes变为lgtm——这正是这一步的全部意义。结果落盘每次 drop 与 re-tier 都要记录到草稿的## Grill区块DROPPED: reason/RETIERED critical→important: reason该区块是该技能评审标准的调优数据——某条理由在多个 PR 间反复出现就说明缺少一条校准应加入Nx 特有校准清单而不是每次重审。场景三review-pending-pr-reviews —— 沙箱已亡时的事后审问review-pending-pr-reviews 是/review-pr的发件箱草稿未经维护者在此确认永远不发布到 GitHub。它的 Step 3 与 Step 8.5 形成鲜明对照它是真正的评估闸门/review-pr大多数时候无头运行tmux 面板 夜间 cronStep 8.5 的 grill 在多数评审上被跳过因此这里的 grill 才是绝大多数草稿唯一经过的人类评估。跳过已 gril 的草稿frontmatter 已含## Grill区块的草稿说明 Step 8.5 已交互式 grill 过再 grill 浪费维护者时间直接进入展示环节。事实无法再查此时沙箱早已销毁无法重读--ref base。若某轮争执于事实而非判断明说并建议skip 重新跑/review-pr绝不基于未经核实的直觉丢弃发现——这是与 Step 8.5 最大的差异点。简报优先级更高这里打开的是 cron 几天前产出的草稿、关于一个维护者多半从未打开过的 PR冷提问的后果比 Step 8.5 更严重因此简报被称作not optional。协议背后的工程考量反幻觉设计把 grill-me 与两个调用方合起来看能提炼出这套协议反复出现的工程原则——它们共同服务于一个目标让 AI 的输出在进入真实世界之前必须经过人的亲口确认。防假共识铁律一绝不替用户回答在两个调用方中被反复强调措辞几乎一致——a grill that supplies the users answers manufactures agreement that was never givenlaunders agent output into apparent human review把代理的输出洗白成看似人工的评审。这是整套协议的反幻觉核心。防冷启动失效三个环节Step 8.5、Step 3、grill-me 本体都强制先简报、再提问、每条问题内联自带证据因为对不可见材料的提问必然得到沉默而沉默被定义为停止。防累积效应失控逐轮应用 收尾再简报解决的是人无法在脑中追踪多次逐条决定的累积结果这一认知局限。事实与决策分离事实永远由 AI 自己查Agent、--ref base、沙箱读取用户只做决策——这把访谈时长压到最低同时保证每个被问的问题都是真问题。在 Nx 仓库 AI 工作流中的位置从仓库整体看grill-me 是 .claude/skills/ 目录下十余个 Claude Code 技能之一与 review-pr深度 PR 评审、review-pending-pr-reviews待发布草稿发件箱、以及 .claude/agents/ 下的一众评审代理implementation-reviewer、verification-reviewer、alternative-approach、security-reviewer等共同构成无头评审 → 草稿落盘 → 人工 grill → 发布的流水线。权限与沙箱约束由 .claude/settings.json 定义草稿只写~/.nx-pr-reviews评审检出仅存在于沙箱而 CLAUDE.md 与 AGENTS.md 则规定了仓库通用的提交与验证规范。如果你希望在自己项目中复刻这套模式最小可行集合就是一个设计树 前沿 轮次的访谈协议、两条铁律、以及一份强制先行的简报模板——grill-me 的 SKILL.md 本身就是一份可以直接照抄的规范。从源码结构看该方法源自对社区skills/productivity/grilling的改编MIT 许可文档末尾有署名——其核心的 round/frontier 方法被完整继承并针对委托评审发现这一 Nx 特有场景扩展出了三层轮次结构与双简报流程。这意味着你不必将它视为 Nx 专属设施任何需要让 AI 的结论接受人审的工作流都可以按本文的协议骨架落地。【免费下载链接】nxThe Monorepo Platform that amplifies both developers and AI agents. Nx optimizes your builds, scales your CI, and fixes failed PRs automatically. Ship in half the time.项目地址: https://gitcode.com/GitHub_Trending/nx/nx创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考