SuperAPI AI 工具集

verification-before-completion

测试与质量

查看项目

更新于 10-15 09:58

技能介绍

用途

该技能的核心用途是约束开发者在声称工作“完成”“已修复”或“通过测试”之前,必须先运行验证命令并确认输出。资料明确指出:未经验证就声称工作完成是“不诚实的,而不是高效”。

它适用于任何形式的成功或完成声明,包括:提交代码、创建 PR、任务完成、进入下一个任务、向代理委托任务,以及任何表达满意或暗示成功/正确的沟通。

主要能力

技能围绕一条“铁律”展开:没有全新的验证证据,不得声明完成。

它定义了“门控函数”,即在做出任何状态声明或表达满意之前必须执行的步骤:

  1. 识别:什么命令能证明这个声明?
  2. 运行:执行完整命令(全新的、完整的)
  3. 阅读:查看完整输出,检查退出码,统计失败数
  4. 验证:输出是否证实声明?如果否,用证据说明实际状态;如果是,带证据说明声明
  5. 只有完成以上步骤后:才做出声明

技能还列出了常见失败案例及其所需证据,例如:“测试通过”需要测试命令输出 0 失败,而之前的运行结果或“应该会通过”并不充分;“构建成功”需要构建命令退出码为 0,而 linter 通过或日志看起来正常并不充分;“缺陷已修复”需要测试原始症状并通过,而仅仅改动代码并假设已修复并不充分;“代理已完成”需要 VCS diff 显示变更,而代理报告“成功”并不充分。

使用方式

资料未提供具体的安装命令或代码调用方式,仅说明这是位于 skills.sh 上 ada20204/antigravity-sync-mcp 仓库中的技能。使用时应将其作为规则约束:在任何成功声明前执行识别、运行、阅读、验证、声明五步门控流程。

技能还提供了关键模式示例,例如测试场景应为“[运行测试命令] [看到:34/34 通过] ‘所有测试通过’”,而非“现在应该能通过了”;回归测试应验证红绿循环(写测试 → 运行通过 → 回退修复 → 运行必须失败 → 恢复 → 运行通过),而非仅仅写了一个回归测试。

适用场景

适用于任何需要声明工作状态、表达满意、提交代码、创建 PR、完成任务、进入下一任务或向代理委托任务的开发流程。技能强调规则适用于原句、改述、同义词以及任何暗示成功或完成的沟通。

限制

资料未提供关于该技能的具体平台、收费、价格或效果信息。技能本身不自动执行验证,而是要求使用者遵守流程。资料明确列出“红旗”信号需立即停止,包括使用“应该”“可能”“似乎”等措辞、在验证前表达满意、未验证就提交/推送/创建 PR、信任代理成功报告、依赖部分验证、认为“就这一次”、疲劳并希望工作结束,以及任何未经运行验证就暗示成功的措辞。