SuperAPI AI 工具集

verification-before-completion

编程与开发

查看项目

更新于 10-16 06:10

技能介绍

用途

Verification Before Completion 是一个用于约束 AI 编程助手行为的技能,目的是防止在没有实际验证的情况下声称工作已完成、已修复或已通过测试。它的核心立场是:未经核实的完成声明是不诚实的,而不是高效。

核心原则

该技能提出一条“铁律”:没有新鲜的验证证据,不得做出任何完成声明。如果在本条消息中没有运行过验证命令,就不能声称它通过了。

门控流程

在声称任何状态或表达满意之前,必须依次执行以下步骤:

  1. 识别:哪条命令能证明这个声明?
  2. 运行:执行完整命令(新鲜、完整)。
  3. 读取:查看完整输出,检查退出码,统计失败数。
  4. 核对:输出是否确认了声明?如果否,则陈述实际状态并附证据;如果是,则附证据陈述声明。
  5. 只有到这一步,才能做出声明。

跳过任何一步都等于撒谎,而不是验证。

常见失败与所需证据

技能列举了若干典型声明及其所需的证据,并指出哪些是不够的:

  • 测试通过:需要测试命令输出 0 失败;上一次运行或“应该会通过”不够。
  • Linter 干净:需要 Linter 输出 0 错误;部分检查或外推不够。
  • 构建成功:需要构建命令退出码 0;Linter 通过或日志看起来不错不够。
  • Bug 已修复:需要测试原始症状并通过;仅改代码并假设修复不够。
  • 回归测试有效:需要验证红-绿循环;测试只通过一次不够。
  • Agent 已完成:需要版本控制差异显示变更;Agent 报告“成功”不够。
  • 需求满足:需要逐行检查清单;测试通过不够。

红旗信号

出现以下情况应立即停止:使用“应该”“大概”“似乎”等措辞;在验证前表达满意(如“太好了”“完美”“完成”);未验证就准备提交、推送或创建 PR;信任 Agent 的成功报告;依赖部分验证;想着“就这一次”;因为疲惫而想尽快结束;任何暗示成功但未运行验证的表述。

防止合理化

技能提供了一组对照,用于反驳常见的自我辩解:

  • “现在应该能用了” → 去运行验证。
  • “我有信心” → 信心不等于证据。
  • “就这一次” → 没有例外。
  • “Linter 通过了” → Linter 不等于编译器。
  • “Agent 说成功了” → 独立验证。
  • “我累了” → 疲惫不是借口。
  • “部分检查就够了” → 部分检查证明不了任何事。
  • “换个说法规则就不适用” → 精神重于字面。

关键模式

技能给出了正确与错误做法的示例:

  • 测试:正确做法是运行测试命令并看到 34/34 通过,然后说“所有测试通过”;错误做法是说“现在应该通过了”或“看起来正确”。
  • 回归测试(TDD 红-绿):正确做法是编写 → 运行(通过)→ 撤销修复 → 运行(必须失败)→ 恢复 → 运行(通过);错误做法是只说“我写了回归测试”而没有红-绿验证。
  • 构建:正确做法是运行构建并看到退出码 0,然后说“构建通过”;错误做法是说“Linter 通过了”。
  • 需求:正确做法是重读计划 → 创建清单 → 逐项验证 → 报告缺口或完成;错误做法是说“测试通过,阶段完成”。
  • Agent 委派:正确做法是 Agent 报告成功 → 检查版本控制差异 → 验证变更 → 报告实际状态;错误做法是直接信任 Agent 报告。

为什么重要

技能引用 24 条失败记忆说明后果:人类伙伴说“我不相信你”,信任被破坏;未定义的函数被发布,会导致崩溃;缺失的需求被发布,功能不完整;因虚假完成而浪费时间,导致重定向和返工。技能指出这违反了“诚实是核心价值,如果撒谎就会被替换”的原则。

适用时机

该技能要求始终在以下情况之前应用:任何形式的成功或完成声明;任何满意表达;任何关于工作状态的正面陈述;提交、创建 PR、任务完成;进入下一任务;委派给 Agent。规则适用于确切措辞、转述和同义词、成功的暗示,以及任何暗示完成或正确的沟通。

限制

该技能本身不提供具体的验证命令或工具,具体命令取决于项目环境。资料中未提供安装方式、平台支持、收费信息或与其他工具的集成细节。