sweep-verification

最终检查：完成前验证

概述

未经验证就声称工作已完成，不是效率高，而是无效。

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

违反规则的字面要求，就是违背规则的本意。

铁律

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

如果你没有运行本消息中的验证命令，就不能声称验证通过。这是沉默法则 3——真相法则。

关卡

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 = invalid, not verification

常见失败

声明	所需证据	不足以证明
测试通过	测试命令输出：0 个失败	之前的运行结果、“应该能通过”
代码检查干净	代码检查输出：0 个错误	部分检查、推断
构建成功	构建命令：退出码为 0	代码检查通过、日志看起来没问题
Bug 已修复	测试原始症状：通过	代码已更改、假定已修复
回归测试有效	已验证红绿循环	测试只通过一次
Agent 已完成	VCS 差异显示有更改	Agent 报告“成功”
满足要求	逐行检查清单	测试通过

危险信号——停止

• 使用“应该”“可能”“似乎”等说法
• 验证前就表达满意（“太棒了！”“完美！”“完成了！”等）
• 准备在未验证的情况下提交、推送或创建 PR
• 轻信 Agent 的成功报告
• 依赖不完整的验证
• 心想“就这一次”
• 任何暗示成功、但尚未运行验证的措辞

防止找借口

借口	事实
“现在应该能用了”	运行验证
“我有信心”	信心 ≠ 证据
“就这一次”	没有例外
“代码检查通过了”	代码检查 ≠ 编译器
“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 at face value

适用时机

在以下情况前，务必验证：

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

规则适用于：

• 原话
• 改述和同义表达
• 暗示成功的说法
• 任何暗示工作已完成或正确的沟通

沉默法则合规检查

• 真相法则：每项声明都有最新命令输出作为依据
• 可用性法则：验证输出已保留在对话中