verification-before-completion

完成前验证

概述

未经验证就声称工作已完成，这不是效率，而是不诚实。

核心原则： 始终先有证据，再做声明。

违背规则的字面要求，就是违背规则的精神。

此技能要求在做出任何完成声明之前必须进行验证，以防止误报、构建失败和信任受损。

何时使用此技能

在声称以下内容之前，务必启用：

• 成功、完成或满意（“完成了！”、“修好了！”、“太棒了！”）
• 测试通过、代码检查无问题、构建成功
• 提交、推送、创建 PR
• 将任务标记为完成或委派给 Agent

尤其在以下情况下使用：

• 时间紧迫或疲惫时
• “快速修复”看起来显而易见，或信心十足时
• Agent 报告成功，或测试“应该”能通过时

铁律

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

未运行此消息中的验证命令，不得声称成功。

核心原则

1. 需要证据：每项声明都需要佐证
2. 即时验证：必须现在验证，不能依赖之前的运行结果
3. 完整验证：运行完整命令，而非部分检查
4. 如实报告：报告实际状态，而非期望的状态

快速开始

五步关卡流程：

1. 确定：什么命令能够证明这项声明？
2. 运行：执行完整命令（全新、完整）
3. 阅读：阅读完整输出，检查退出代码并统计失败项
4. 验证：输出是否证实了这项声明？
   • 如果否：根据证据说明实际状态
   • 如果是：附上证据说明这项声明
5. 只有此时：才能做出声明

跳过任何一步都等于撒谎，而非验证。

关键模式

正确模式：

✅ [Run pytest] [Output: 34/34 passed] "All tests pass"

错误模式：

❌ "Should pass now"
❌ "Looks correct"
❌ "Tests were passing"
❌ "I'm confident it works"

危险信号——立即停止

出现以下情况时立即停止：

• 使用“应该”“可能”“似乎”等说法
• 在验证前就表达满意
• 准备在未经验证的情况下提交、推送或创建 PR
• 轻信 Agent 的成功报告
• 依赖不完整的验证

以上任何一种情况都意味着：立即停止。先运行验证。

这为何重要

真实失败案例的统计数据：

• 验证成本：2 分钟
• 恢复成本：120 分钟以上（成本高出 60 倍）
• 40% 未经验证的“已完成”声明都需要返工

核心警示：“撒谎会导致被取代”

导航

详细信息：

• 关卡流程：完整的五步验证流程及决策树
• 验证模式：测试、构建、部署等场景的正确验证模式
• 危险信号与失败：常见失败模式、危险信号，以及附带时间和成本数据的真实案例
• 集成与工作流：与其他技能的集成、CI/CD 模式，以及 Agent 委派工作流

归根结底

验证没有捷径。

运行命令。阅读输出。然后再声明结果。

这一点不容妥协。