SuperAPI AI 工具集

evidence-gate

编程与开发

查看项目

更新于 11-04 18:08

技能介绍

Evidence Gate 是一个用于约束 AI 编码代理行为的工作流技能,核心原则是“证据先于状态”。它要求在对外宣称某项工作状态之前,必须先提供针对该声明的、当前轮次内的验证证据。

用途 它主要解决代理在未实际验证的情况下过早宣称“完成”“已修复”“测试通过”“已提交”“PR 就绪”或“可交接”的问题,通过强制核验来减少虚假完成声明。

主要能力 技能给出六步门控流程:1)陈述即将做出的声明;2)找出能证明该声明的最小命令或检查;3)完整运行命令或检查所需产物;4)读取输出与退出码;5)将结果与声明对比;6)报告确切证据,或说明阻塞原因。同时提供证据矩阵,将常见声明与所需证据对应:测试通过需测试命令退出码为 0 且无失败;Lint 干净需 Lint 命令退出码为 0 且无警告;类型检查/构建通过需对应命令退出码为 0;缺陷修复需原始复现或回归检查通过;需求满足需按请求范围核对清单而非仅看测试;提交就绪需审阅 git diff --cached 并完成相关检查;推送就绪需核实分支、提交与远程目标;PR 就绪需验证命令、PR 标题/正文与差异范围;交接就绪需当前状态、变更文件与验证结果。

使用方式 在最终回复或交接中使用规定格式:Verification 下列出通过或失败的命令及原因,Not run 下说明未运行的命令及原因;若检查失败,不得弱化结果,应说明失败与下一步动作。技能适用于声明任务完成或修复前、提交或推送前、创建或更新 PR 前、将问题标记为可审查或完成前、把工作交给其他代理或人之前,以及代理、工具或 CI 任务报告成功之后。

适用场景 适用于需要严格质量门控的编码代理工作流,尤其是多代理协作、CI 结果采信、提交与 PR 流程以及任务交接环节。

限制 资料未提供具体安装方式、平台依赖、配置项或与其他工具的集成细节,暂未提供。