SuperAPI AI 工具集

clarify

通用与其它

查看项目

更新于 10-16 09:58

技能介绍

用途:把模糊意图收敛为可执行的确定性,产出落盘的草稿 spec(.issues/ 任务目录内的 spec.md),以及可选的发布产物(Issue / PR 描述)。落盘是多模型、多 harness 交叉 review 的前提,也是断点续作的工作记忆。本技能只由用户显式调用,环境里装有相近技能(grill-me、brainstorming 等)时互不接管。

主要能力与流程: Phase 0 就位:检测 git;有 git 且 .issues/ 未被忽略时,把 .issues/ 写入 .git/info/exclude(不改共享 .gitignore)并告知用户一句;无 git 则跳过忽略步骤。建任务目录 .issues/<YYYY-MM-DD-主题>/,草稿为其中的 spec.md。 Phase 1 事实自查:环境能查到的事实不问用户,先检索代码库、文档、配置;自查发现的未知项若影响决策,转为拷问问题或写进 spec 的「开放问题」节。 Phase 2 分诊:按 stakes 与不确定度两判据判断并声明档位。低 stakes 且低不确定走轻量模式(最多 5 问);其余走全量模式,高 stakes 行必问;拿不准按全量算。 Phase 3 拷问:一次只问一个问题;每问必附推荐答案;每确认一个决策立即追加进 spec.md。用户说「你看着办」视为委托决策但仍需落盘,失败判定一问不可跳过。问题从出题表取原型,如第一性原理、逆向、系统思维、偏差防火墙等,按对话状态取用。下限:开局 reframe 与逆向失败判定两问不可缺席;验收标准至少覆盖新行为正确与旧行为不回归,高 stakes 再加滥用维。例外:用户连续两次委托决策后,停止逐问,把剩余未决项汇总成一条确认消息。停止条件为决策树无未决分支、用户喊停或打包确认获批准。 Phase 4 定稿发布:读 references/publish.md 执行,探测出口(gh → glab → 仅 git → 无 git),询问去向,按白名单模板重写,完整文本经用户过目确认后才发布;无 git 场景草稿即终态。 Phase 5 收尾:一句沉淀引导,可选建议下一步。

限制与红线:拷问未收敛前不写实现代码;spec.md 没落盘不算收敛;发布文本永不复制草稿原文,只按 references/publish.md 的模板重写。具体阈值、命名等实现细节按推荐执行并在 spec.md 落盘标注。