SuperAPI AI 工具集

grill

智能体与模型

查看项目

更新于 11-06 09:11

技能介绍

用途

grill 是一个决策支持技能,目标是在任何内容被撰写或构建之前,就某一计划、设计、决策或想法与用户达成共识。它通过访谈用户,直到没有任何重要决策被默默假设,从而使后续写下的方案或构建的产物建立在用户真正做出的选择之上。

主要能力

  • 访谈用户,而非撰写计划、规格或代码;输出物是一份决策记录(Decision Record)。
  • 采用 Decision Interview 协议:事实由 AI 自行查证,先做简报,使用决策卡片,按依赖顺序分轮提问,最后回放。
  • 主要步骤:框定主题并收集事实 → 向用户简报 → 构建决策树 → 分轮访谈 → 回放并记录 → 确认并指明下一步。
  • 关键规则:绝不询问可以自行查证的事实;绝不为用户回答决策;提出每一项重要决策,绝不虚构决策;绝不从本技能开始规划、撰写规格或实现,而是交接给其他技能。

使用方式

  • 当用户拥有一个尚未落笔的松散计划、设计、决策或想法时使用本技能。
  • 当用户想要对本次对话中此前给出的回答、建议或计划进行压力测试时也适用:该回答即主题,用户对其中每一项选择做决定。
  • 若已有保存的实现计划,应使用 $plan --mode=validate;若已有 Feature Spec 或测试用例集,应使用 $spec [mode=clarify];若原始产品想法需转化为 initiative,应使用 $initiative;若高风险、难以逆转的选择需要对抗性顾问,应使用 $llm-council;若需审查某产物的理由但不访谈用户,应使用 $why-review;若工作量过大、路线不清,应使用 $wayfinder。
  • 本技能与 $why-review 互补:本技能通过访谈把选择交给用户,$why-review 让智能体在不访谈用户的情况下批判理由。
  • 执行流程:Phase 0 框定主题并收集事实;Phase 1 向用户简报;Phase 2 构建决策树;Phase 3 分轮访谈;Phase 4 回放并记录;Phase 5 确认并交接。
  • 在 Phase 3 中,先告知用户将询问多少项决策、分几轮、涉及哪些主题;每轮通过提问工具提出所有可问决策,每次调用最多四个问题,每个问题以决策卡片形式呈现;每轮后重新计算决策树并告知剩余数量,直到没有未决项或用户停止。
  • 在 Phase 4 中,回放答案,然后将决策记录写入 tmp/reports/grill-{YYMMDD-HHmm}-{slug}.md,包含主题、决策表、已发现事实、未确认假设、仍待解决项。
  • 在 Phase 5 中,提出一个收尾问题确认回放是否符合用户本意;确认后,作为单独问题(非必需)提供一次简短压力测试,从需求与复用、成本与规模、迁移与回滚、日常运行四个角度进行,并将发现追加到同一决策记录。
  • 随后用一行指明合适的下一步(如 $plan、$spec、$initiative、$wayfinder),并给出决策记录路径,但不启动该步骤。

适用场景

  • 尚未落笔的松散计划、设计、决策或想法。
  • 此前对话中给出的回答、建议或计划,需要用户逐项拍板。
  • 需要用户明确做出重要选择、避免默默假设的场景。

限制

  • 本技能不撰写计划、规格或代码,只产出决策记录并交接。
  • 当被其他技能作为步骤调用时,跳过适用性表格,运行 Phase 0 至 4 及 Phase 5 的收尾问题,然后返回决策记录路径与决策,不指明下一步。
  • 子智能体或无头运行无法访谈,应将简报和未决决策卡片作为待处理项返回调用方,绝不自行回答。
  • 若某答案与先前答案或已发现事实矛盾,应指出并询问以哪个为准,不得围绕矛盾进行设计。
  • 未问到的决策记为未确认假设,并注明原因(证据明显或用户停止访谈)。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。