W
AI-Wiki
ENTITY

grill-me

定义

grill-me 是一个面向用户主动调用的技能,归属在 Productivity 分类下的 User-invoked skills。它的核心作用不是直接产出代码,而是对一个 plan 或 design 进行 relentlessly interviewed,即持续、密集地追问,直到 decision tree 的 every branch is resolved。

身份与归类

  • 分类:Productivity
  • 分组:User-invoked skills
  • 触发方式:由用户主动调用
  • 同类底层机制:它与 grilling 共享“持续追问直到所有决策分支被澄清”的访谈式循环

角色职责

grill-me 的职责,是在真正开始执行变更前,帮助用户与代理先完成对方案的对齐,并把原本隐含、模糊或未决的选择显式化。它关注的不是实现细节本身,而是:

  • 当前 plan 或 design 到底要解决什么问题
  • 还存在哪些未被回答的分支选择
  • 每个选择的边界、前提、例外与后果是什么
  • 是否已经把会影响后续执行的关键决策都讲清楚

文中对它的描述非常直接:它会“Get relentlessly interviewed about a plan or design until every branch of the decision tree is resolved.” 也就是说,只要决策树上还有悬而未决的分支,这个技能就会继续追问,而不会草率进入实现阶段。

关键作用

在动手前先对齐

原文强调,这类技能“help you align with the agent before you get started, and think deeply about the change you're making”,并建议在每次想做改动时都使用。这里体现出 grill-me 的定位:

  • 它服务于“开始之前”的对齐阶段
  • 它逼迫用户更深入地思考即将进行的改动
  • 它不把“差不多知道要做什么”视为足够,而是要求把分支决策尽量穷尽

穷尽决策树分支

grill-me 的成败标准不是“聊过这个方案”,而是“决策树每个分支都得到解决”。这意味着它特别适合处理:

  • 方案看似明确,但关键取舍尚未说清的情况
  • 设计中存在多条可选路径的情况
  • 一旦做错选择,后续返工成本较高的变更
  • 用户脑中已有方向,但尚未把约束和例外讲完整的任务

与 grill-with-docs 的关系

文中明确写到:/grill-with-docs/grill-me 相同,但“adds more goodies”。因此可以确定:

  • grill-with-docs 与 grill-me 在核心访谈机制上是同一种技能路线
  • grill-me 是基础形态,重点在于持续追问 plan 或 design
  • grill-with-docs 在此之上增加了额外能力,而不是换了另一套目标

原文还补充说,grill-with-docs 把这种 grilling session 与两类文档化工作结合在一起:

  • 帮助你与 AI 建立 共享语言
  • 记录难以解释的决策到 ADR 中

这也从侧面说明 grill-me 本体的重点更偏向“追问与澄清”,而不是文档增强。

适用场景

grill-me 适用于以下场景:

  • 你准备做某个改动,但还不确定方案是否真的闭环
  • 你有一个设计方向,希望在实现前先接受系统性盘问
  • 你担心代理会因为目标不清而在后续阶段跑偏
  • 你希望把模糊意图转化为明确、可执行、低歧义的决策集合

原文把这类技能称为“最受欢迎的技能”之一,并明确建议:“Use them every time you want to make a change.” 这意味着它并非仅用于重大架构设计,也适合日常变更前的方案压实。

细节与边界

它解决的是“前置决策不足”问题

grill-me 主要解决的是:在开始实施之前,用户和代理其实并未真正对齐,导致后续实现偏离预期。它通过高密度问答,把隐藏决策前置暴露出来。

它不是代码质量反馈循环本身

原文在相邻内容中把“前置对齐”与“代码实际运行效果”区分开来。即使你和代理已经对齐,代码仍可能写得很差;那时应该依赖反馈循环,例如:

  • 静态类型
  • 浏览器访问能力
  • 自动化测试
  • tdd 所强调的 red-green-refactor 循环
  • 调试用的诊断流程

因此,grill-me 不是 tddcode-review 或调试技能的替代品。它属于更早阶段:先把方案与设计分支问清楚,再进入实现、测试、审查和调试。

它偏通用工作流,而非代码专用

其归类在 Productivity 而不是工程专用组,说明它是 general workflow tool,而非仅限代码任务的技巧。只要任务存在 plan 或 design,并且需要把决策树分支穷尽,它就有用。

与相关条目的关系

  • Productivitygrill-me 所属的大类,表示它是通用工作流工具,而不是特定编程语言或框架能力。
  • User-invoked skillsgrill-me 位于该组,表示它需要用户显式发起。
  • grilling:可复用的底层追问循环;文中说明它是 grill-me 与 grill-with-docs 背后的 reusable loop。
  • grill-with-docs:与 grill-me 相同,但增加了额外内容,尤其包括 共享语言 与 ADR 记录能力。
  • 共享语言:虽然是 grill-with-docs 更完整覆盖的方向,但它解释了为什么“先问清楚再开工”能显著减少啰嗦和误解。
  • code-review:偏向对既有 diff 的双轴审查,检查是否符合标准与规格;它发生在实现之后,不替代 grill-me 的前置澄清。
  • tdd:处理实现阶段的反馈循环,通过先写失败测试再修复来提升代码可靠性;它与 grill-me 互补,而非重复。
  • mattpocock skills README 摘要grill-me 的定位、分类和与其他技能的关系可在该总览中得到统一理解。

总结

grill-me 是一个用户触发的前置澄清技能:它通过对 plan 或 design 的 relentless interview,把原本隐含的选择、分支与边界不断追问出来,直到整个 decision tree 的每个分支都得到解决。它属于 Productivity 下的 User-invoked skills,并与 grill-with-docs 共享同一核心机制;后者只是额外加入了文档化与共享语言等增强内容。