mcpField
G
grill

grill

github.com/juliusbrusseeAgent 工作流1.2k786 次安装11 周前更新
代码仓库

关于 grill

grill 是用于在编写规格前澄清模糊想法的 Agent skill。它会逐个提出经过校准的问题并给出建议答案,再将约束和未知项整理后交给 spec skill。

主要功能

  1. 01一次只问一个问题
  2. 02按情况调整提问深度
  3. 03七步问题阶梯
  4. 04提供建议答案
  5. 05结构化交接给 spec

适用场景

  1. 01澄清模糊的项目想法
  2. 02解决目标的多种解读
  3. 03准备非简单规格
  4. 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 的力度应与不确定性相称,⊥ 与自尊无关。

先校准

先做一次初步判断,而不是盘问:

  1. 用户对这个领域了解多少?(决定问题的深度)
  2. 想法有多确定?(还在探索还是已经决定)
  3. 希望施加多大压力:轻度/正常/严厉。

据此调整。对尚未成形的想法严厉拷问,只会打击士气;对已经确定的计划轻轻带过,则会错过关键缺陷。

问题阶梯

按顺序逐级推进。每一级只问 一个 问题,推荐一个答案,然后等待。

  1. 目标 — 代码必须 做什么,用一句话说明?(→ §G)
  2. 完成标准 — 如何确认它有效?说出可观察的指标。(→ §C/未来的 §V)
  3. 边界 — 明确不在范围内的是什么?(→ §C)
  4. 锁定项 — 哪些技术/库/模式不可妥协?有哪些禁用项?(→ §C)
  5. 接口面 — 外部世界会接触什么——命令、API、文件、环境变量?(→ §I)
  6. 边界情况 — 哪种输入会打破正常流程?(→ 未来的 §V)
  7. 未知项 — 还有哪些事情 尚不清楚?(→ 将其作为 ? 暂存到 §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