SuperAPI AI 工具集

clarify

智能体与模型

查看项目

更新于 10-23 02:40

技能介绍

clarify 是一个面向 AI 规划流程的澄清与细化技能,用于在最终确定分阶段计划之前,用一次有边界的澄清过程解决会改变计划的歧义。

用途:该技能主要用于多阶段计划类任务。在完成阶段划分(资料中称为 Step 6)之前运行本次澄清,以解决计划中遗留的 [?] 标记和会影响方案的模糊点。工作方式是从高层到细节逐步展开,并且被定位为唯一允许集中提问的环节,但它是有边界的,不是强制关卡。

运行时机:凡是会产出多阶段计划的任务,默认都应执行歧义扫描;扫描本身是一次静默的思维检查,而不是正式流程。对于单阶段或范围显而易见的小任务,例如“修这个错别字”“把版本号升到 X”“把 Y 重命名为 Z”,可以快速跳过。问题数量的 ≤5 是上限而非目标,问题越少越好。

两种交付模式:需要先判断当前处于哪种模式。子代理模式(由 Conductor 或其他代理派生)下不能直接向用户提问,应返回计划草案,并在末尾附加“## Open clarifying questions”问题块;直接调用模式(用户直接运行)下,则通过对话逐条提问,一次问一个、且该问题的答案会影响下一个问题时才这样逐个进行。若无法确定模式,按子代理模式处理并返回问题。

歧义扫描:在收集 [?] 标记之前,先对照常见歧义模式静默扫描任务,只在无法从用户提示或代码库中确定答案时才暴露问题。扫描维度包括:范围边界(哪些在范围内、哪些明确排除)、向后兼容(是否会改变既有使用方的行为)、错误与边界情况策略(大声失败还是优雅降级)、方案选择(存在多个可行方案时是否已定其一)、隐式依赖(未说明的顺序或环境假设)。如果扫描没有发现问题,直接进入阶段划分,不必报告“扫描干净”。

执行方式:优先收集会改变计划的歧义,优先沿用已有的 [?] 标记而非新增;最多提出 5 个针对性问题,影响最大者优先;当一个问题的答案会影响另一个问题时逐个提问,仅对互相独立的问题批量提问;一旦无歧义即提前停止,不强行凑满 5 个;记录每个答案并清除对应的 [?] 标记,然后定稿并保存。

子代理模式的问题块格式:在返回的计划草案之后附加如下区块:

Open clarifying questions

  1. [影响最大的问题] — affects: [计划的哪一部分]
  2. [下一个问题,若与 #1 独立]

记录格式(task.md):在阶段表定稿之前,于 Research Findings 下添加带日期的 ## Clarifications 小节:

Clarifications

YYYY-MM-DD

  • Q: [问题] → A: [用户回答]
  • Q: [推迟的问题] → Assumed: [所做假设],未给出回答

对于推迟或未回答的事项,必须明确记录所做假设;绝不静默猜测会改变计划的歧义,而应记录下来,让 Builder 和 Reviewer 能够看到。

适用场景与限制:适用于需要多阶段规划的 AI 代理工作流,尤其是存在变更范围、兼容性、错误处理策略或方案选择不确定性的任务。该技能本身不提供独立界面或自动问答能力,交互依赖调用方代理与用户;具体实现细节与集成方式暂未提供。