SuperAPI AI 工具集

spec-loop-clarify-task

智能体与模型

查看项目

更新于 10-15 21:12

技能介绍

用途:在 Spec Loop 工作中处理与用户的重要澄清。适用于任务创建与更新、计划、工作拆解、设计更新、实施检查点、ADR 工作、执行审批准备等场景,也用于强制决策筛查。若无任务文件、ADR 或调用方工作流,则仅作聊天式讨论。

主要能力:先检查现有证据(用户已确认的选择、当前讨论、任务材料、术语表、代码、文档)能否直接确定答案;能确定则直接解决并在有治理产物时记录。仅在证据不足、含糊、冲突时向用户提问。已确定决策用“Recorded:”确认;未确定决策分两类:可由代理提出明确选项的“决策批次”(每条决策编号 1 至 6),或必须用户先给出输入才能做选择的“澄清问题”(必须列备选方案)。

澄清问题格式:Question、Recommended option: <字母> (<百分比>)、Options(- <字母>. <摘要>)、空行、Reason。决策批次格式:Decision 1: ... (%)、Reason: ...,最多 6 条,之后请用户确认、质疑或反对并等待。

投入程度:若澄清预计超过两个实质步骤或决策空间较广,询问用户参与度(Low、Normal、High、Exhaustive,默认推荐 Normal),之后可要求调整;该设置仅对当前澄清轮次生效。

阶段与交接:澄清留在调用方工作流所在阶段(PLAN 留在 PLAN,ADR 工作留在 ADR,实施期澄清遵循 spec-loop-implementation-flow/SKILL.md);无调用方时留在聊天。PLAN 或 ADR 期间可就地修订治理产物,不允许可执行变更。结束时若有调用方则交还控制权,否则停止并说明已解决状态与遗留问题。

决策筛查结果:只能判定为已由确定证据解决、无需澄清(outside clarification)、待用户确认的决策批次、待用户回答的澄清问题、或因需 ADR/实施/研究等而被阻塞并交还调用方。仅前两种可立即写入依赖的最终内容。

存储:任务治理的澄清写入任务产物(Analysis 或 Scope),ADR 澄清写入 ADR(Context、Alternatives、Decision、Analysis 按 adr-format.md 规则),纯聊天澄清在用户指定位置前不创建持久存储。仅存最终解决内容,不存未决问题、置信值或临时笔记。