verification-before-completion

“完成前验证”(Verification Before Completion) 是一项关键的工程技能，旨在消除自动化软件开发中的假阳性与推测性的状态报告。它作为强制性的质量守门员，防止代理程序在未产生实证前就宣称任务完成。通过强制要求代理执行特定的验证指令并解析其输出——检查退出代码、测试成功次数或清理过的 linter 结果——此技能确保断言直接与当前的存储库状态挂钩，而非仅基于代理的信心或假设。此技能适用于在严格测试、回归验证与可靠交付至关重要的环境中运作的自主编码代理。典型使用案例包括验证 TDD 中的红绿重构周期、通过退出代码确认构建成功、针对原始征状验证特定错误修复，以及在创建拉取请求或提交代码前，通过清单检查确保满足所有需求。此技能防止了常见的失败，例如依赖局部检查、信任过时的成功报告，或在没有实证的情况下做出如“完成”或“完美”等过早的满意度声明。它作为一种行为保障措施，以维持开发者的信任度与系统稳定性。

• 执行“铁律”：没有最新的验证证据，不得声称工作完成。

• 要求在进行任何状态报告前，系统性地执行验证指令（测试、构建、linter）。

• 为每个开发任务实施识别、执行、验证、报告的强制性工作流程。

• 识别危险信号，例如推测性语言（“应该”、“可能”）与过早的满意度表达。

• 防止依赖代理程序的自我反思或外部摘要，而非实际的 CLI 工具输出。

• 标准化基于证据的报告，确保 PR、提交与任务转换在技术上是健全的。

• 代理在行动前必须始终识别证明该声明的特定指令。

• 要求代理阅读完整的工具输出，而非依赖被截断或推论的日志。

• 若缺乏明确的验证指令，即视为未达到技能协议标准。

• 适用于软件开发的每个阶段：实作、重构、除错与部署前准备。

• 明确禁止在未通过验证闸门前进行新任务、提交或推送代码。