SuperAPI AI 工具集

verification-before-completion

编程与开发

查看项目

更新于 10-16 14:20

技能介绍

概述

该技能围绕一个核心主张:未经验证就声称工作已完成,是不诚实,而不是高效。其核心原则是“证据先于声明,始终如此”。技能指出,违反这一规则的文字即违反其精神。

铁律

技能的“铁律”是:没有新鲜的验证证据,就不得作出完成声明。如果未在当前消息中运行验证命令,就不能声称其通过。

关卡函数

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

  1. 识别:什么命令能证明该声明?
  2. 运行:执行完整命令(新鲜、完整)。
  3. 读取:读取完整输出,检查退出码,统计失败数。
  4. 验证:输出是否确认了该声明?若否,则用证据陈述实际状态;若是,则连同证据一起陈述声明。
  5. 只有到这一步之后,才作出声明。

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

常见失败

技能以对照形式列出若干常见失败:声称测试通过,需要测试命令输出为 0 失败,而之前的运行或“应该能过”并不充分;声称 linter 干净,需要 linter 输出 0 错误,部分检查或外推不充分;声称构建成功,需要构建命令退出码为 0,linter 通过或日志看起来正常不充分;声称缺陷已修复,需要测试原始症状并通过,仅代码改动或假设已修复不充分;声称回归测试有效,需要验证红绿循环,测试只通过一次不充分;声称智能体已完成,需要版本控制差异显示改动,智能体报告“成功”不充分;声称需求已满足,需要逐行核对清单,测试通过不充分。

红旗信号——停止

技能列出需要停止的信号:使用“应该”“可能”“似乎”等措辞;在验证前表达满意(如“太好了”“完美”“完成”等);未经验证就准备提交、推送或创建 PR;信任智能体的成功报告;依赖部分验证;认为“就这一次”;疲惫并想尽快结束工作;任何暗示成功但未运行验证的措辞。

防止合理化

技能以对照表防止自我合理化:借口“现在应该能用了”,现实是去运行验证;借口“我有信心”,现实是信心不等于证据;借口“就这一次”,现实是没有例外;借口“linter 通过了”,现实是 linter 不等于编译器;借口“智能体说成功了”,现实是需独立验证;借口“我累了”,现实是疲惫不是借口;借口“部分检查就够了”,现实是部分证明不了什么;借口“换个说法规则就不适用”,现实是精神重于文字。

关键模式

技能给出若干关键模式:测试方面,正确做法是运行测试命令、看到 34/34 通过,然后说“所有测试通过”;错误做法是说“现在应该能过”或“看起来正确”。回归测试(TDD 红绿)方面,正确做法是编写、运行(通过)、回退修复、运行(必须失败)、恢复、运行(通过);错误做法是仅声称“我已写好回归测试”而未验证红绿循环。构建方面,正确做法是运行构建、看到退出码 0,然后说“构建通过”;错误做法是“linter 通过了”(linter 不检查编译)。需求方面,正确做法是重读计划、创建清单、逐项验证、报告缺口或完成;错误做法是“测试通过,阶段完成”。智能体委派方面,正确做法是智能体报告成功、检查版本控制差异、验证改动、报告实际状态;错误做法是信任智能体报告。

为何重要

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

何时应用

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

底线

技能总结:验证没有捷径。运行命令,阅读输出,然后才声明结果。这一点不可协商。