SuperAPI AI 工具集

specifying-gates

智能体与模型

查看项目

更新于 10-16 03:17

技能介绍

用途:在任务执行流程中,当某个用户门控任务的验证机制不明确时,用本技能把“如何验证”固定下来。触发条件为三者之一:任务 json:metadata 中 requiresUserSpecification 为 true;代理运行“do I know HOW?”自检后认为验证机制含糊;用户手动执行 /specify-gate <task-id>。若 verifyCommand 已具体且每条 acceptanceCriteria 都有可观察证据,则直接执行门控,不调用本技能。

主要能力:通过 AskUserQuestion 逐条提问,确定四类信息——可观察结果(acceptanceCriteria,须具体到传感器、HTTP 状态、日志行、文件存在等,模糊表述会被追问)、证明机制(CLI 命令、REST/API 调用、带简报的子代理、直接检查)、范围(once、per-target、one-then-all 或自定义)、失败策略(stop-plan、reopen-continue、log-continue)。若选择子代理,则追加第五问,记录 subagentBrief(文本或文件路径)。

使用方式:先用 TaskGet 加载目标任务并解析 json:metadata;按 brainstorming 规则一次只问一个问题;回答完成后重写 json:metadata,加入 verifyCommand、acceptanceCriteria、userGate、tags、gateScope、failurePolicy、subagentBrief 等字段,移除 requiresUserSpecification,并在人类可读部分追加 Specification 小节,同步 .tasks.json 与 lastUpdated。

限制:本技能只做规格说明,不运行验证命令、不关闭任务、不重新头脑风暴;不调用 ExitPlanMode/EnterPlanMode;除任务描述与 .tasks.json 外不写任何文件;问题不超过 4-5 个。完成后控制权交回 executing-plans,由后者执行 verifyCommand 或派发子代理并逐条记录证据。