关于 grill
grill 是用于在编写规格前澄清模糊想法的 Agent skill。它会逐个提出经过校准的问题并给出建议答案,再将约束和未知项整理后交给 spec skill。
主要功能
- 01一次只问一个问题
- 02按情况调整提问深度
- 03七步问题阶梯
- 04提供建议答案
- 05结构化交接给 spec
适用场景
- 01澄清模糊的项目想法
- 02解决目标的多种解读
- 03准备非简单规格
- 04在编写规格前检验想法
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ juliusbrussee/ cavekit --skill grill安装后在 Claude Code 中输入/grill确认已加载。
详细介绍
grill — 在编写规范前打磨想法
每次只问一个问题。每个答案都归入某个 §,或暂存为 ?。绝不凭空臆造约束。
先规划再执行会猜测模糊之处,最终做出错误的东西。 Grill 会在出现第一条 §T 之前,就把模糊之处拖进 §G/§C。 在这里发现错误假设,只需问一个问题;等到 §B 才发现,就会变成一个 bug。
何时进行 Grill
- 想法只有一句话,而且你能感觉到其中的漏洞。
- 目标存在多种解读,而你正准备默默选一种。
- 在对任何非简单事项运行
/spec new之前。 - 用户要求你提出质疑/进行压力测试。
拼写错误或一行就能修好的问题,跳过。Grill 的力度应与不确定性相称,⊥ 与自尊无关。
先校准
先做一次初步判断,而不是盘问:
- 用户对这个领域了解多少?(决定问题的深度)
- 想法有多确定?(还在探索还是已经决定)
- 希望施加多大压力:轻度/正常/严厉。
据此调整。对尚未成形的想法严厉拷问,只会打击士气;对已经确定的计划轻轻带过,则会错过关键缺陷。
问题阶梯
按顺序逐级推进。每一级只问 一个 问题,推荐一个答案,然后等待。
- 目标 — 代码必须 做什么,用一句话说明?(→ §G)
- 完成标准 — 如何确认它有效?说出可观察的指标。(→ §C/未来的 §V)
- 边界 — 明确不在范围内的是什么?(→ §C)
- 锁定项 — 哪些技术/库/模式不可妥协?有哪些禁用项?(→ §C)
- 接口面 — 外部世界会接触什么——命令、API、文件、环境变量?(→ §I)
- 边界情况 — 哪种输入会打破正常流程?(→ 未来的 §V)
- 未知项 — 还有哪些事情 尚不清楚?(→ 将其作为
?暂存到 §C 条目中)
一旦规范足够明确、不会产生歧义,就停止提问。不要习惯性地问完七个问题。
回答格式
每个问题都附带一个推荐答案,方便用户简单回复“是”:
Q:身份验证——会话 Cookie 还是 JWT? rec:JWT——它是无状态的,而且你在 §C 中提到了水平扩展。 (a) JWT (b) Cookie (c) 其他?
交接
完成后,输出一个精简的内容块——目标一行、约束条目,以及标记为 ? 的待确认事项——然后交给 spec 技能编写 §G/§C。Grill 只提出建议;只有 spec 可以修改。绝不直接编写 SPEC.md。
何时停止
满足以下所有条件即可完成:
- §G 只有一行、一种解读,不含“或者也许”。
- §C 涵盖用户明示或暗示的所有不可妥协事项。
- 每个阻塞性未知项都已得到回答,或明确以
?暂存。
如果有需要外部信息才能解决的阻塞性未知项,建议运行 /research,不要猜测。
边界
- ⊥ 替用户做产品决策。只提出建议,绝不替用户决定。
- ⊥ 编写 SPEC.md。将结构化答案交给 spec。
- ⊥ 一次提出多个问题。每次只问一个问题,给出一项建议,然后等待。
- ⊥ 盘问无关紧要的改动。按实际情况调整力度,或直接跳过。
评论
支持 Markdown