SuperAPI AI 工具集

verification-before-completion

智能体与模型

查看项目

更新于 10-30 16:18

技能介绍

用途

该技能用于约束 AI 编程助手在声明工作状态时的行为。其核心原则是“证据先于声明”,铁律为:没有新鲜的验证证据,不得做出任何完成声明。只要尚未在本次消息中运行验证命令,就不能声称某项检查通过。

主要能力

  • 门禁流程:在做出任何状态声明或表达满意之前,依次执行识别(哪条命令能证明该声明)、运行(完整、新鲜地执行)、读取(查看完整输出、退出码与失败计数)、验证(输出是否支持声明)、再做声明五个步骤;跳过任一步即视为未验证。
  • 常见失败对照:列出“测试通过”“Lint 干净”“构建成功”“Bug 已修”“回归测试有效”“Agent 已完成”“需求已满足”“看起来对”“应用可用”“进程正常退出”“事实为最新”等声明所需的证据,以及不足为凭的替代物(如上次运行结果、“应该能过”、局部检查、Agent 自报成功、早期截图)。
  • 新鲜性要求:证据必须产生于最后一次相关改动之后;最终 CSS 修改前的截图或最后一次提交前的测试运行,都不算证据。改动后需重新采集。
  • 危险信号:使用“应该”“大概”“似乎”、在验证前表达满意、未验证就提交/推送/开 PR、轻信 Agent 成功报告、依赖局部验证、“就这一次”心态、因疲惫而想尽快收工等。
  • 借口预防:逐条反驳“应该能用了”“我有信心”“Lint 过了”“Agent 说成功”“局部检查够了”等常见辩解,强调信心不等于证据、Lint 不等于编译、部分检查不能证明任何事。

使用方式

作为技能规则在 AI 工作流中加载执行。适用于任何成功/完成声明的变体、任何满意表达、任何关于工作状态的正向陈述,以及提交、创建 PR、任务完成、进入下一任务、委托给 Agent 等节点。规则覆盖原话、转述、同义词及任何暗示完成或正确的沟通。

适用场景与示例

  • 测试:运行测试命令并看到 34/34 通过后再声明“全部测试通过”;不得说“现在应该能过”。
  • 回归测试:按红绿循环验证——编写→运行(通过)→撤销修复→运行(必须失败)→恢复→运行(通过)。
  • 构建:运行构建并看到 exit 0 再声明构建通过;Lint 通过不能替代编译检查。
  • 需求核对:重读计划、建立逐项清单、逐条验证后再报告完成或缺口。
  • Agent 委托:Agent 报告成功后,检查版本控制差异、独立验证改动,再报告真实状态。

边界与限制

该技能只负责“声明前存在新鲜证据”这道门禁:视觉外观由 visual-verification 负责,运行时产物由 artifact-proof 负责,进程清理由 process-lifecycle-cleanup 负责,当前外部事实由 research-verification 负责。