SuperAPI AI 工具集

grill

写作与研究

查看项目

更新于 10-15 15:32

技能介绍

用途

grill 用于在模糊想法被写成规格之前,对其进行校准式盘问(calibrated interrogation)。它的目标是在任何 §T 行存在之前,把模糊之处拖入 §G(目标)或 §C(约束)。资料指出:先规划再执行会猜测模糊部分并造出错误的东西;在这里捕获一个错误假设只需一个问题,而在 §B 中捕获则要付出一个 bug 的代价。

何时使用

  • 想法只有一句话,且能感觉到其中的漏洞。
  • 目标存在多种解读,而你即将默默选择其中一种。
  • 在对任何非平凡任务执行 /spec new 之前。
  • 用户要求被挑战或压力测试。

对于拼写错误或一行修复,应跳过。资料称 grill 随不确定性伸缩,与自尊无关(⊥ to ego)。

先校准

开始前先做一次开场判断,而不是测验:

  • 用户对该领域的了解程度如何?(决定提问深度)
  • 想法有多锁定?(探索中 vs 已承诺)
  • 想要的压力:轻 / 正常 / 残酷。

要匹配用户状态。对半成形想法进行残酷盘问只会打击士气;对已承诺计划进行轻盘问则会错过承重缺陷。

问题阶梯

按顺序攀登。每一级只问一个问题,给出推荐答案,然后等待。

  1. 目标 — 代码必须做什么,用一行说明?(→ §G)
  2. 完成 — 我们怎么知道它有效?说出可观察项。(→ §C / 未来 §V)
  3. 边界 — 明确不在范围内的是什么?(→ §C)
  4. 锁定 — 什么技术/库/模式不可协商?什么被禁止?(→ §C)
  5. 表面 — 外部世界接触什么 — cmd、api、file、env?(→ §I)
  6. 边缘 — 破坏正常路径的那一个输入是什么?(→ 未来 §V)
  7. 未知 — 我们还有什么不知道?(→ 作为 ? §C 条目暂存)

一旦规格将变得无歧义,就停止攀登。不要条件反射地把七个问题全问一遍。

答案格式

每个问题都带有推荐答案,以便用户能咕哝一声“是”然后继续:

Q: auth — session cookie 还是 JWT? rec: JWT — 无状态,你把水平扩展列为 §C。 (a) JWT (b) cookie (c) 其他?

交接

完成后,输出一个紧凑块 — 目标行、约束条目、以 ? 呈现的已浮现未知 — 并交给 spec 技能来写 §G/§C。grill 只提议;spec 是唯一的修改者。绝不直接写 SPEC.md。

何时停止

当以下全部成立时完成:

  • §G 是一行、一种解读、零个“或者也许”。
  • §C 覆盖用户陈述或暗示的每一条不可协商项。
  • 每个阻塞性未知要么已回答,要么作为显式 ? 暂存。
  • 需要外部世界介入的未解决阻塞性未知 → 推荐 /research,而不是猜测。

边界

  • ⊥ 替用户做产品决策。只推荐,绝不决定。
  • ⊥ 写 SPEC.md。把结构化答案交给 spec。
  • ⊥ 批量提问。一个问题,一个推荐,等待。
  • ⊥ 盘问琐碎改动。要规模匹配,否则跳过。