SuperAPI AI 工具集

verify-before-done

测试与质量

查看项目

更新于 10-16 17:28

技能介绍

Verify Before Done 是一个用于约束 AI 代理或开发者行为的技能,核心是“没有验证证据,绝对禁止声称完成”。

用途 该技能用于在代理或人做出任何完成、成功、提交、推送、PR 或状态报告之前,强制插入验证环节,防止无证据的完成声明带来的信任破坏、未定义函数被部署、需求遗漏、虚假完成导致返工与时间浪费等问题。

主要能力

  1. 门禁函数:在所有完成/成功声明前执行四步:识别——证明该声明需要什么命令;执行——现在运行该命令(不能使用之前的结果);读取——检查完整输出、退出码和失败数;验证——输出是否确认该声明;若不确认,则报告实际状态并附证据;若确认,才可附证据声明完成。
  2. 主张与证据对照表:明确每类主张所需的证据与不充分证据。例如“测试通过”需要测试命令输出 0 failures,之前的运行或“应该会通过”不充分;“linter 干净”需要 linter 输出 0 errors,部分检查或推测不充分;“构建成功”需要构建命令 exit 0,linter 通过或日志看起来正常不充分;“bug 已修复”需要原始症状测试通过,仅改了代码或推测已修复不充分;“满足需求”需要逐项检查清单,仅测试通过不充分。
  3. 危险词监控:列出出现时应立即停止的词语,如“应该会”“大概”“大体上”“好耶!”“完美!”“结束了!”(验证前)“好像已经……”“我手动确认过了”“代理说成功了”等。
  4. 委派任务同样适用:子代理报告“成功”后,必须独立验证,检查 VCS diff 确认变更确实存在,亲自运行测试确认确实通过,不可盲信代理报告。
  5. 防止合理化:针对常见借口给出反驳,例如“现在应该能正常工作”应去运行验证;“我确信”确信不等于证据;“就这一次”没有例外;“linter 通过了”linter 不等于编译器也不等于运行时;“我累了”疲劳不构成豁免;“部分确认就够了”部分确认不能证明任何事。

使用方式 在每次准备声明完成、提交、推送、PR 或状态报告之前,按照门禁函数的四步执行;识别所需命令,立即运行,完整读取输出,判断输出是否支持声明;若支持则附带证据声明完成,若不支持则报告实际状态及证据。该技能为行为规范型技能,具体安装命令与集成方式在现有资料中暂未提供。

适用场景 适用于任何需要可靠完成声明的 AI 代理工作流或开发流程,包括代码修改、测试、构建、bug 修复、需求交付、提交、推送、PR 以及状态报告等环节。

限制 现有资料未提供其具体安装步骤、支持平台、价格或收费方式、运行环境要求等信息,均暂未提供。