SuperAPI AI 工具集

verification-before-completion

编程与开发

查看项目

更新于 10-16 09:06

技能介绍

用途

「完成前验证」是一个面向 AI 编码代理的行为约束技能,用于在宣称工作完成、已修复或测试通过之前强制进行真实验证。它的核心主张是:在没有验证的情况下宣称工作完成,不是高效,而是不诚实;始终要用证据支撑结论。

主要能力

该技能提供了一套可执行的验证门控流程,在宣称任何状态或表达满意之前必须依次完成:

  1. 确定:什么命令能证明这个结论?
  2. 运行:执行完整命令(重新运行,完整执行)。
  3. 阅读:完整输出,检查退出码,统计失败数。
  4. 验证:输出是否支持这个结论?如果否,用证据说明实际状态;如果是,带证据陈述结论。
  5. 只有这时,才能做出结论。

技能强调跳过任何一步都等于说谎,而不是验证。

常见失败模式

技能列举了若干典型场景及其所需证据:

  • 测试通过:需要测试命令输出 0 failures,而不是之前的运行结果或「应该会通过」。
  • Linter 无报错:需要 linter 输出 0 errors,而不是部分检查或推断。
  • 构建成功:需要构建命令 exit 0,而不是 linter 通过或日志看起来没问题。
  • Bug 已修复:需要测试原始症状通过,而不是代码改了、假设已修复。
  • 回归测试有效:需要红-绿循环已验证,而不是测试只通过了一次。
  • 代理已完成:需要 VCS diff 显示变更,而不是代理报告「成功」。
  • 需求已满足:需要逐项核对清单,而不是测试通过。

红线信号

出现以下情况时应停下来:使用「应该」「大概」「似乎」;验证前就表达满意(如「太好了」「完美」「搞定」);即将提交、推送或创建 PR 却没有验证;信任代理的成功报告;依赖部分验证;想着「就这一次」;累了想赶紧收工;任何暗示成功但实际未运行验证的措辞。

防止合理化

技能针对常见借口给出反驳:

  • 「应该能行了」→ 运行验证命令。
  • 「我有信心」→ 信心不等于证据。
  • 「就这一次」→ 没有例外。
  • 「Linter 通过了」→ Linter 不等于编译器。
  • 「代理说成功了」→ 独立验证。
  • 「我累了」→ 疲劳不是借口。
  • 「部分检查就够了」→ 部分检查什么也证明不了。
  • 「换个说法这条规则就不适用了」→ 精神大于字面。

关键模式示例

  • 测试:运行测试命令并看到 34/34 pass 后说「全部测试通过」,而不是「应该能通过了」或「看起来对了」。
  • 回归测试(TDD 红-绿):编写 → 运行(通过)→ 回退修复 → 运行(必须失败)→ 恢复 → 运行(通过),而不是只说「我写了回归测试」。
  • 构建:运行构建并看到 exit 0 后说「构建通过」,而不是「Linter 通过了」。
  • 需求:重读计划 → 创建核对清单 → 逐项验证 → 报告缺口或完成,而不是「测试通过了,阶段完成」。
  • 代理委派:代理报告成功 → 检查 VCS diff → 验证变更 → 报告实际状态,而不是信任代理报告。

为什么重要

技能引用 24 次失败记录说明后果:搭档说「我不信你」,信任被破坏;未定义的函数被交付,会直接崩溃;遗漏需求被交付,功能不完整;虚假完成浪费时间,导致返工重做。技能同时指出这违反原则:「诚实是核心价值。如果你说谎,就会被替换。」

何时使用

以下情况之前必须使用:任何形式的成功或完成声明;任何满意的表达;任何关于工作状态的正面陈述;提交、创建 PR、标记任务完成;进入下一个任务;委派给代理。

该规则适用于准确措辞、同义词和换一种说法、暗示成功,以及任何传达完成或正确性的沟通。

限制

技能本身是一套行为规则,不提供具体的验证命令或工具实现;实际使用中需要使用者自行确定能证明结论的命令。资料未提供该技能的安装方式、平台支持范围或收费信息。