完成前验证

概览

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

违反此规则的字面含义就是违反此规则的精神。

铁律

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 失败 | 上一次运行、“应该通过” | | Linter 干净 | Linter 输出：0 错误 | 部分检查、外推 | | 构建成功 | 构建命令：exit 0 | Linter 通过、日志看起来不错 | | Bug 已修复 | 测试原始症状：通过 | 代码已改、假定已修复 | | 回归测试有效 | 红绿循环已验证 | 测试通过一次 | | Agent 已完成 | VCS diff 显示变更 | Agent 报告“success” | | 需求已满足 | 逐行检查清单 | 测试通过 |

危险信号 - 停止

• 使用“应该”、“大概”、“看起来”
• 在验证前表达满意（“太好了！”、“完美！”、“完成！”等）
• 未经验证就准备 commit/push/PR
• 信任 Agent 成功报告
• 依赖部分验证
• 想着“就这一次”
• 疲惫并希望工作结束
• 在未运行验证的情况下，任何暗示成功的措辞

防止合理化

| 借口 | 现实 | |--------|---------| | “现在应该能工作” | 运行验证 | | “我有信心” | 信心 ≠ 证据 | | “就这一次” | 没有例外 | | “Linter 通过了” | Linter ≠ 编译器 | | “Agent 说成功了” | 独立验证 | | “我累了” | 疲惫 ≠ 借口 | | “部分检查就够了” | 部分证明不了任何东西 | | “措辞不同，所以规则不适用” | 精神高于字面 |

关键模式

测试：

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

回归测试（TDD Red-Green）：

✅ 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

规则适用于：

• 确切措辞
• 改写和同义词
• 对成功的暗示
• 任何暗示完成/正确的沟通