grill-me 完整指南:5 步把模糊想法勘探成可辩护的图纸
【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills
grill-me 是 skills 仓库(Skills for Real Engineers)里的一个手动访谈技能:拿你手里一个边界说不清的粗糙想法,按固定协议分轮提问,最后让你把每个分支都落成敢负责的选择。读完这篇,你能独立跑完一场完整的 grill-me 会话、判断它何时该收手、以及该把接力棒交给哪个兄弟工具。
grill-me 解决什么问题:想法还停在草稿阶段
这一节回答:什么情况下你需要它,它又明确不做什么。
你脑子里的想法是一张未勘探的草稿:很多分支你根本没意识到存在,边界也没画。grill-me 的活儿就是把这些分支一个个逼到台面上。它不写文件、不留工作区,唯一产出是你脑子里更清楚的那个版本——无状态这一点写死在 docs/productivity/grill-me.md 里。整套勘探协议沉淀在 grilling 技能 中,grill-me 只是它的手动开关:skills/productivity/grill-me/SKILL.md 的 frontmatter 里标了disable-model-invocation: true,模型永远不会替你触发,只能你亲手敲。
勘探怎么推进:5 个关键术语
这一节回答:一场会话内部到底按什么规则往前走。
- 设计树:agent 把讨论画成一棵树,每个决定是一个分叉,依赖它的后续问题挂在分叉后面。
- 前沿:前提已全部敲定、现在就能问的那批问题,一问不多、一问不少。
- 轮次:整个前沿算一轮,整轮问完才等你作答。每题编号、附 agent 的推荐答案,你答完这轮它才算下一轮。
- 事实分工:能查的环境事实由 agent 派子代理去查,不问你;该拍的决定摆到你面前等。查不到的事实只卡住它的下游问题,不卡全场。
- 封口:前沿清空即封口,会话自然结束;agent 还要等你确认理解一致才允许动手。
以上行为全部定义在 skills/productivity/grilling/SKILL.md。
跑通 grill-me 的最小 3 步
这一节回答:不装任何东西,怎么最快跑起来。
前置检查:
- 开一个新对话,不在已有讨论或已有计划上叠加勘探
- 关掉 plan mode——它推 agent 直奔产出计划,与勘探节奏相反
- 只需一个想法,不要求有代码库,想法越模糊越好
步骤:
- 输入
/grill-me,把想法原样说出去。为什么:模糊是原料,不是障碍,会话存在的目的就是消除它。 - 每轮对编号问题逐题作答。每题三选一:采纳推荐答案、推翻它、或顶回去让它换一种问法。为什么:至少顶回一次,你才算真的做了决定。
- 前沿清空时结束。若产物是软件需求,就在同一段对话里直接调 to-spec 综合成规格。为什么:这段会话刚建好的上下文本身就是价值,换新对话反而浪费。
怎么判断勘探是好的:4 条信号与 3 个误区
这一节回答:会话结束后,拿什么标准验收。
四条信号,中 3 条即为合格:
- 你至少推回过一次推荐答案——说明真做了决定,不是走过场
- 问题分批到达,后几轮明显建立在你前几轮的回答上——说明设计树在推进,不是题海在倾倒
- 出现了你没想过的隐性假设被顶上台面——说明勘探够到了你没预料的位置
- 你能把每个选择逐条讲给一个不在场的人听——说明图纸是你的,不是 agent 的文案
误区与正解:
- ❌ 误区:每题都点头,收一份 agent 写的、你点头的计划 ✅ 正解:问得太粗就让它换问法重问,至少顶回一次才算数
- ❌ 误区:在 agent 已经写好的计划上启动勘探 ✅ 正解:已成型的东西不需要勘探,只从毛边想法开磨
- ❌ 误区:遇到答不出的问题继续猜 ✅ 正解:直说"不知道",它通常提示你该去搭原型,而不是继续猜
什么时候选 grill-me,什么时候别选
这一节回答:想法处于什么状态时该换工具。
| 场景 | 工具 | 一句话区别 |
|---|---|---|
| 任何想法,无代码库 | grill-me | 无状态,不写文件 |
| 要对齐现有代码库 | grill-with-docs | 同样的访谈,但读代码,沉淀进 GLOSSARY.md 与 ADR |
| 大到一轮会话装不下 | wayfinder | 在 issue tracker 上画决策票地图,每次会话只解一张票 |
| "长什么样 / 什么感觉" | prototype | 用能亲眼看的一次性原型回答,胜过再问一百轮 |
| 想法已说得清清楚楚 | to-spec | 不访谈,只把你已说过的东西综合成规格 |
拿不准走哪条流程,用 ask-matt 分流,别硬选。
grill-me 高频答疑
这一节回答:跑过几次之后最常撞上的 5 个问题。
预期有多少问题?按轮数算,不按题数。一轮四六个问题、总共四轮是普通规模,前沿清空即结束。
问个不停怎么收场?范围太大。先让 agent 把整块工作拆小,再逐块勘探。超长会话还会塞满上下文窗口、拖垮提问质量,别陪跑。
能改回一次一问吗?能。全局 CLAUDE.md 加一行:When grilling, ask one question at a time.。这是仓库支持的正式设置,不是偏方。
真不知道答案怎么办?直说。"不知道"是真实答案,它通常提示你该去搭原型,而不是继续猜。
写规格前要开新对话吗?不要。这段会话的价值就是刚建好的上下文,直接交给 to-spec。
勘探仪只是借给你的,最终图纸画得准不准,由你每一轮的作答决定。没勘探透的决定,别带进下一步。
【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考