SuperAPI AI 工具集

grill

办公与效率

查看项目

更新于 11-04 19:59

技能介绍

用途

grill 是一个决策支持技能,适用于用户手上只有一个松散的计划、设计、决策或想法、尚未写下任何内容的情况。它通过访谈(interview)的方式,对用户的计划、设计、决策或想法进行压力测试,直到没有重要决策被默默假设为止。当用户说“grill me”或希望某个想法被拷问时,即触发该技能。

该技能的核心目标是:在正式撰写或构建任何东西之前,与用户就某个计划、设计、决策或想法达成共识,使后续产出建立在用户真正做出的选择之上。

主要能力

  • 通过访谈而非直接撰写的方式,帮助用户澄清决策。
  • 输出一份决策记录(Decision Record),而非方案、规格或代码。
  • 采用决策访谈协议(Decision Interview protocol)来组织提问方式:事实由技能自己查找、先做简报、使用决策卡片、按依赖顺序分轮提问、最后回放确认。
  • 主要步骤包括:框定主题并收集事实 → 向用户做简报 → 构建决策树 → 分轮访谈 → 回放并记录 → 确认并命名下一步。

使用方式

该技能按阶段顺序执行,每个阶段前后更新待办跟踪,每个完成或跳过的阶段都需要简要证据或理由。

  • 阶段 0:框定主题并收集事实。用一两句话重述主题;完整阅读 $ARGUMENTS 指定的文件;读取项目配置、文档索引和经验文件(如存在),再读取主题涉及的参考文档、规格、已接受的决策和代码。所有事实性问题由技能自行回答;可用子代理进行广泛搜索。只有用户才能提供的未知信息才作为问题提出。
  • 阶段 1:向用户做简报。按协议进行简报,每条陈述都引用其背后的文件或证据。
  • 阶段 2:构建决策树。列出每个重要决策、静默默认值、假设和冲突,以及各自依赖的内容。探查领域包括:目标及其服务对象、范围与非目标、未采取的替代方案、数据与状态、失败/恢复/回滚、访问与安全、依赖与顺序、下一次变更的成本、如何测试与证明、什么会让用户在六个月后后悔这个选择。
  • 阶段 3:分轮访谈。先告诉用户将问多少个决策、分几轮、涉及哪些主题。通过 ask user question 工具在一轮中提出所有可问的决策,每次调用最多四个问题,每个问题以决策卡片形式呈现。每轮结束后重新计算决策树,告知用户还剩多少,继续下一轮,直到没有未决项或用户停止。当回答与先前回答或已发现事实矛盾时,指出并询问以哪个为准。
  • 阶段 4:回放并记录。回放答案,然后将决策记录写入 tmp/reports/grill-{YYMMDD-HHmm}-{slug}.md,包含主题、决策表、已发现事实、未确认假设、仍待解决项。
  • 阶段 5:确认并交接。提出一个收尾问题:回放是否与用户本意一致。然后一行内命名合适的下一步(如 $plan、$spec、$initiative、$wayfinder),并给出决策记录路径,但不启动该步骤。

适用场景

  • 用户有一个松散的计划、设计、决策或想法,尚未写下任何内容。
  • 用户希望某个想法在正式撰写或构建前被访谈式压力测试。
  • 用户明确说“grill me”。

当其他技能更合适时,应一行说明并让用户选择;但用户明确请求该技能时始终运行,来自其他技能的调用也始终运行。

限制

  • 绝不询问可以自己查到的事实;绝不为用户回答决策。
  • 必须询问每个重要决策,绝不编造决策。
  • 绝不从该技能开始规划、撰写规格或实现,只做交接。
  • 当被其他技能作为步骤调用时,跳过适配表,运行阶段 0 到 4 及阶段 5 的收尾问题,然后返回决策记录路径和决策,不命名下一步。
  • 子代理或无头运行无法进行访谈,应将简报和未决决策卡片作为待处理项返回给调用方,绝不自行回答。
  • 协议顺序除非用户批准偏离,否则保持不变。

输出

报告主题、轮次和问题数、带所选选项的决策、未确认假设、仍待解决项、决策记录路径和建议的下一步。