“Verification Before Completion”是一个围绕实现完成阶段的纪律型技能,核心主张是“证据先于声称,永远如此;没有最新验证,就不作完成声明”。它要解决的问题是:在未验证的情况下宣称工作已完成,会破坏信任并浪费时间;而“应该能跑通”并不构成验证。
该技能首先提出铁律:任何完成声明都必须由你刚刚观察到的证据支撑,不能是早些时候的结果,也不能是预期中的结果。为此它设计了五步门禁。第一步是识别:先问“哪条命令能证明我的声明”,例如声称“测试通过”就对应项目测试命令,声称“构建成功”就对应构建命令,声称“缺陷已修复”就对应此前失败的复现步骤。第二步是现场运行:立即执行命令,不读缓存、不凭记忆,并等待其完成后再继续。第三步是完整阅读输出:包括退出码(0 为成功)、全部输出行而不只是最后一行、所有警告以及摘要统计。第四步是核对:确认输出确实支持该声明,例如退出码为 0、出现“X tests passed”、无失败项,或原先前置失败不再出现。第五步才是声称:只有此时才可以说测试通过、构建成功或实现完成。
技能还按场景列出常见失败模式与核对要点。测试方面要确认退出码为 0、全部测试通过而非仅“跑了一些”、没有非预期的跳过测试、没有测试警告;Lint 方面要确认退出码为 0、无错误、与基线相比无新增警告;构建方面要确认退出码为 0、产物已生成、无编译错误和类型错误;缺陷修复方面要确认原复现步骤不再触发问题、相关功能仍正常、回归测试已添加并通过;对于委派给智能体的工作,要独立验证其声称的输出确实存在且正确,避免被静默失败掩盖。
技能还给出“合理化危险信号”对照表,逐条驳斥“应该能过”“我有信心”“我之前跑过”“改动很小”“稍后再验”“智能体说通过了”“在我机器上是好的”“跑测试跑累了”等想法,强调信心不是证据、小改动也可能破坏功能、必须在目标环境运行、疲劳不能成为跳过验证的理由。
在使用方式上,它作为实现阶段的最后一道门禁:计划步骤完成前先跑步骤验证,阶段完成前先跑阶段验证,实现完成前跑全部验证。提交前应确保全部测试通过、Lint 干净、构建成功、类型检查通过(如适用);创建 PR 前还应确认分支与基线同步、无合并冲突、CI 在本地模拟可通过;声称“已修复”前要确认复现步骤不再触发、回归测试已添加并通过、相关功能与其余测试仍正常。技能还按项目类型给出验证命令示例:Node.js/JavaScript 用 npm test、npm run lint、npm run build、npm run typecheck(或 tsc --noEmit);Python 用 pytest、ruff check . 或 flake8、mypy .、ruff format --check . 或 black --check .;Ruby 用 bundle exec rspec、bundle exec rubocop;Go 用 go test ./...、golangci-lint run、go build ./...;Rust 用 cargo test、cargo clippy、cargo build、cargo fmt --check。
此外,它列出应避免的反模式:只运行改动过的测试文件而非全量测试;信任缓存或过往结果;因自信而跳过验证;轻信智能体的通过声称;临近结束时赶进度而省略验证。最后给出完成前核对清单:已识别验证命令、已现场执行、已读完输出、退出码确认成功、输出符合预期、未忽略警告或错误、证据支持所要作出的具体声明。该技能本身是流程与纪律规范,不提供额外的运行时工具或自动化能力。