SuperAPI AI 工具集

verification-before-completion

编程与开发

查看项目

更新于 11-13 11:12

技能介绍

用途 该技能用于约束 AI 编码助手在做出“已完成”“已修复”“已通过”等状态声明之前的行为,防止在缺乏验证的情况下宣称成功。其定位是编码工作流中的质量门控纪律,而非具体代码工具。

核心原则 文档强调“先证据,后声明,始终如此”。声称工作完成却不验证被视为不诚实而非高效,违反规则的字面要求即违反其精神。

铁律与门控流程 铁律:没有新鲜的验证证据,不得做出完成声明。如果本轮消息中没有运行验证命令,就不能声称其通过。 门控流程共五步:

  1. 识别:哪条命令能证明该声明?
  2. 运行:执行完整命令(新鲜、完整)。
  3. 读取:查看完整输出,检查退出码,统计失败数。
  4. 核对:输出是否确认声明?若否,带证据说明实际状态;若是,带证据陈述声明。
  5. 只有在此之后才做出声明。 跳过任一步即视为说谎而非验证。

常见失败与所需证据 文档以对照方式列出声明与所需证据:

  • 测试通过:需要测试命令输出显示 0 失败;此前的运行结果或“应该能过”不足。
  • Lint 干净:需要 Lint 输出 0 错误;部分检查或外推不足。
  • 构建成功:需要构建命令退出码为 0;Lint 通过或日志好看不足。
  • Bug 已修复:需要针对原始症状的测试通过;仅改代码并假定修复不足。
  • 回归测试有效:需要验证红绿循环;测试仅通过一次不足。
  • 需求满足:需要逐行核对清单;测试通过不足。

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

借口反驳 文档逐条反驳常见借口:“现在应该能用了”——去运行验证;“我很有信心”——信心不等于证据;“就这一次”——没有例外;“Lint 通过了”——Lint 不等于编译器;“我累了”——疲惫不是理由;“部分检查够了”——部分检查证明不了什么。

关键模式示例

  • 测试:先运行测试命令,看到 34/34 通过,再声明“所有测试通过”;而不是“现在应该能过”或“看起来没问题”。
  • 回归测试(TDD 红绿):编写 → 运行(通过)→ 回退修复 → 运行(必须失败)→ 恢复 → 运行(通过);而不是仅声明“我写了回归测试”。
  • 构建:运行构建,看到退出码 0,再声明构建通过;而不是以 Lint 通过代替。
  • 需求:重读计划 → 创建清单 → 逐项验证 → 报告缺口或完成;而不是“测试通过,阶段完成”。

适用场景 始终在以下情况之前使用:任何形式的成功/完成声明;任何表达满意;任何关于工作状态的正面陈述;提交、创建 PR、任务完成;转入下一任务;委托给智能体。

限制 该页面为行为规范类技能文档,未提供具体安装命令、代码示例、收费或平台支持信息,相关内容暂未提供。