SuperAPI AI 工具集

verification-before-completion

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:该技能用于约束“完成声明”的时机。当准备说工作已完成、Bug 已修复、测试已通过,或要提交代码、创建 PR、进入下一任务、委派给 agent 前后,都先应用此规则。核心原则是:始终先有证据,再做断言;没有在本次消息中运行验证命令,就不能声称通过。

主要能力:提供一套门禁式检查流程。一是识别:哪条命令能证明该声明;二是运行:完整、新鲜地执行该命令;三是阅读:查看完整输出、检查退出码、统计失败数;四是验证:输出是否支持声明,若不支持则按证据说明实际状态,若支持则连同证据一起陈述;最后才做声明。跳过任一步即视为未验证。文档还列出常见失败对照,例如“测试通过”需要测试命令输出 0 个失败,而非之前跑过或“应该通过”;“构建成功”需要构建命令 exit 0,而非仅 Linter 通过;“Bug 已修复”需要原始症状测试通过;“回归测试有效”需要 red-green 循环已验证;“需求已满足”需要逐行核对清单。

使用方式:按上述五步流程执行,并对照危险信号自查,如使用“应该”“可能”“看起来”、在验证前表达满意、未验证就 commit/push/PR、直接信任 agent 的成功报告、依赖局部验证、想着“就这一次”或因疲惫想收尾。文档同时给出关键模式示例:测试需运行测试命令看到 34/34 通过;构建需运行构建命令看到 exit 0;需求完成需重读计划、建清单、逐项验证;委派 agent 需检查 VCS diff 并独立验证后再报告真实状态。

适用场景与限制:适用于任何形式的成功或完成声明、正面状态陈述,以及提交、PR、任务收尾和 agent 委派等节点。规则覆盖精确短语、改写同义表达及任何暗示完成的沟通。限制方面,资料未提供其安装方式、支持平台、具体命令名称、与何种工具链集成,也未说明是否存在自动化实现或收费模式,这些信息暂未提供;实践时应结合自身项目的实际验证命令执行。