verification-before-completion

完成前验证

概述

核心原则： 任何声明之前，始终先有证据。

违反本规则的字面要求，就是违反其精神。

铁律

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

如果你没有在本条消息中运行验证命令，就不能声称它通过。

关卡函数

BEFORE claiming any status or expressing satisfaction:

1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
   - If NO: State actual status with evidence
   - If YES: State claim WITH evidence
5. ONLY THEN: Make the claim

Skip any step = lying, not verifying

常见失败情形

声明	需要	不充分的依据
测试通过	测试命令输出：0 个失败	之前的运行结果、"应该能通过"
Lint 检查通过	Linter 输出：0 个错误	部分检查、以偏概全的推断
构建成功	构建命令：退出码 0	Linter 通过、日志看起来正常
Bug 已修复	针对原始症状的测试：通过	代码已修改、假定已修复
回归测试有效	已验证红-绿循环	测试只通过一次
Agent 已完成	VCS diff 显示有变更	Agent 报告"成功"
需求已满足	逐条核对的清单	测试通过

危险信号 - 立即停止

• 使用"应该"、"可能"、"似乎"
• 在验证之前表达满意（"太好了！"、"完美！"、"完成！"等）
• 未经验证就准备提交、推送或创建 PR
• 轻信 Agent 的成功报告
• 依赖部分验证
• 想着"就这一次"
• 疲惫，想尽快结束工作
• 任何在未运行验证的情况下暗示成功的措辞

防止自我合理化

借口	事实
"现在应该能用了"	运行验证
"我很有把握"	信心 ≠ 证据
"就这一次"	没有例外
"Linter 通过了"	Linter ≠ 编译器
"Agent 说成功了"	独立验证
"我累了"	疲惫不是借口
"部分检查就够了"	部分检查证明不了什么
"换个说法，规则就不适用了"	精神高于字面

关键模式

测试：

✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"

回归测试（TDD 红-绿）：

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)

构建：

✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)

需求：

✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"

Agent 委派：

✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report

适用时机

以下情况之前必须执行：

• 任何形式的成功/完成声明
• 任何表达满意的言语
• 任何关于工作状态的正面陈述
• 提交、创建 PR、完成任务
• 进入下一个任务
• 委派给 Agent

本规则适用于：

• 原文表述
• 改写与近义表达
• 暗示成功的内容
• 任何暗示完成或正确性的沟通