grill-me 完整上手指南:把模糊想法拷问成敢拍板的决策
【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills
grill-me 是 Skills for Real Engineers 这个开源技能库里的生产力技能:吃进一个没想透的模糊想法,吐出一串你敢于拍板、能对外辩护的决策。写给有想法但缺经验的工程师和独立开发者。读完你能自己主持一整场拷问,并判断何时该收手、何时把活儿交给仓库里的兄弟模块。
先问三个问题,看是不是你的活
- 你手里有没有一个还说不清、一句话讲不明白的想法?
- 它的核心问题靠口头就能谈定,不需要一个能看见的东西来反应?
- 这个决定值得你日后向别人辩护?
三个都是否,别硬选。想法已经能让 agent 写出完整计划,直接进构建流程;问题是"长什么样、什么感觉"这类,属于不可拷问(ungrillable),去做原型;拿不准自己属于哪一类,用仓库里的 ask-matt,它就是干分流的。
开工前,把这几项勾掉
- 开一个全新对话。访谈要从空白上下文开始,在已有讨论上叠加,只会问些已经答过的事。
- 关掉 plan mode。它催促 agent 尽快产出一份计划,和"停留在探究状态"正好相反。
- 手动输入
/grill-me发起。skills/productivity/grill-me/SKILL.md 的 frontmatter 里写着disable-model-invocation: true,同目录 agents/openai.yaml 的 policy 块里 allow_implicit_invocation 也是 false。它只认手动发起,模型不会替你扣扳机。 - 想清楚你才是主持人。agent 只是提问的人,范围和拍板都在你手里。
完整跑一遍实录
我开了个新对话,把想法原样丢出去:"我想给 SaaS 加订阅计费,打算接 Stripe。"
第一轮问题很快就来了。每个问题带编号,后面跟着它的推荐答案。Q1 问价格档位怎么设计,它推荐两档月付加年付。我顶回了 Q1:先只做单档,别一上来就玩分层。
我答完这轮,它才放出下一轮。第二轮全是第一轮才解锁的问题:单档定价下,中途升级怎么处理、降级怎么折算。依赖本轮还没答完的问题,它不会现在问,留给后面的轮次。
第三轮它问续费失败重试几次、重试不动之后订单进什么状态。第二问我直说:不知道。它没逼我猜,我判断这属于拿实物验证更划算的问题,先记下,回头用原型确认。
有个细节值得记住。中途它问"现有用户数据库里有没有 billing 字段"这种事实性问题时,是它自己派子代理去查的,只卡住依赖这个事实的那几个问题,前沿其余部分照常推进。事实归它查,拍板归你做,这条分工线它全程没越过。
前沿被问空,访谈结束。它在结束前没动任何东西,等我确认没有异议,才算达成共识。整场四轮、四五十个问题,留下的是几个我能对外辩护的决策。紧接着我在同一段对话里调用 to-spec,它把刚讨论过的东西直接综合成规格,没再二次提问。
它为什么会这么问
grill-me 的 SKILL.md 本体只有一句话:调用 grilling 技能。真正的协议全在 grilling 协议本体 里,看懂下面三个词,你就能预判它下一步问什么。
- 设计树:你的想法是整体,每个决策后面都挂着依赖它的后续决策。像盖房子,承重墙定了,隔墙才有得谈。
- 前沿:前提条件全部敲定、现在就能问的那批问题。像攀岩,一轮只问你脚下踩稳的岩点,不让你提前够没到的地方。
- 轮次:一轮把整个前沿问完,答完才进下一轮。像棋局一轮一动,本轮只走当前能走的子。
和兄弟们怎么选
| 模块 | 适用场景 | 是否留存状态 | 前置依赖 |
|---|---|---|---|
| grill-me | 模糊想法,跟代码无关也行,任何地方能跑 | 无状态:不写文件、不留工作区 | 无,新对话里手动输入 /grill-me |
| grill-with-docs | 有代码库要对齐的同一场访谈 | 有状态:读代码,学到的沉淀进 GLOSSARY.md 和 ADR | 必须在一个工作目录里 |
| wayfinder | 工作量太大,一轮会话装不下 | 有状态:决策地图和决策票都挂在 issue tracker 上 | 需要 issue tracker,没配的话先跑 setup-matt-pocock-skills |
| prototype | "长什么样/什么感觉"类问题 | 一次性产物:单 HTML 文件逻辑演示或多个 UI 变体,验证完只把决策折回真代码 | 问题已明确到需要一个能跑的答案 |
| to-spec | 想法已经说得清,要落成规格 | 产出 spec 并发布到 issue tracker | 需要一段已经讨论过的对话上下文 |
它坚决不做的 3 件事
- 不为你写任何文件:grill-me 是无状态的,唯一产出是你脑子里更清晰的想法;要落地,把同一段对话交给 to-spec,别开新会话。
- 不替你回答不可拷问的问题:"长什么样、什么感觉"需要实物,再问也是空转,这里收手交给 prototype,验证完把结论一句话带回来。
- 不替你做决定:事实它自己查,决策它只摆到你面前等;一路点头,你拿到的是一份 agent 写的、你点头的计划,这场访谈就白开了。
用完后自查
- 我至少推回过一个推荐答案;一次推回都没有,说明这场访谈不该发生。
- 问题是分轮出现的,后几轮明显建立在我前面几轮的答复上,而不是一条长流。
- 我被问到了一个没预期过的位置,某个问题把我默默做出的隐性决策顶到了台面上。
- 结束时,我能把每个选择向一个不在场的人讲清楚理由。
- 它没动我任何文件,唯一产出是脑子里更锐利的想法和后续对话里的规格。
你多半会问的几个问题
我该预期多少个问题?
按轮数算,不按问题数算。官方文档的说法是,四轮四十六个问题就是普通规模。结束的标志是前沿清空:设计树每个分支都访问过,没有东西留在静默假设里。
模型选得好差有区别吗?
比大多数技能都有区别。拷问靠的是模型自己对"系统会在哪里坏掉"的直觉,用它最好的那个;写代码那类技能更多跟着上下文走,可以容忍更便宜的模型。
能改回一次只问一个问题吗?
能。在全局 CLAUDE.md 里加一行When grilling, ask one question at a time.,这是支持的设置,不是 workaround。
拷问完直接写 spec,要开新会话吗?
不要开新会话。这场会话的全部价值就是刚建好的上下文,to-spec 不做访谈、只综合已经讨论过的东西,同一段对话里直接调用即可。
一场访谈问了两个多小时还没完,正常吗?
不正常,通常是范围太大。先让 agent 把工作拆成更小的块,再逐个访谈,别陪它硬跑。超长会话还会把上下文窗口塞满,提问质量随之下滑。
模糊想法进去,敢拍板的决策出来,中间每一分产出质量都跟着你的回答质量走,而不是提问的数量——这才是 grill-me 没白开一场。
【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考