verification-before-completion

完成前验证

没有最新验证证据，不得声称已完成

核心准则

始终先提供证据，再作出声明。如果你没有在此消息中运行验证命令，就不能声称验证通过。

BEFORE any completion claim:
1. IDENTIFY: What verification 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?
   - NO → State actual status with evidence
   - YES → State claim WITH evidence
5. ONLY THEN: Make the claim

命令选择

存在多个验证选项时（单体仓库、多个测试套件）：

• 运行覆盖变更代码的最具体命令
• 无法确定时，运行范围最广的命令（完整测试套件 > 单个文件）
• Lint ≠ 构建 ≠ 测试——每项验证的声明各不相同

证据格式

✅ Ran: npm test
   Exit: 0
   Result: 47 passed, 0 failed
   "All tests pass."

❌ "Tests should pass now" (no command output)

不同类型声明的验证要求

声明	所需证据	不充分的证据
测试通过	测试输出：0 个失败	先前的运行结果、“应该能通过”
Linter 无问题	Linter 输出：0 个错误	部分检查、推断
构建成功	构建退出代码：0	Linter 通过
Bug 已修复	原始症状测试通过	代码已更改
回归测试	已验证红绿循环	仅显示绿色
Agent 已完成	VCS diff 显示变更	Agent 的“成功”报告
满足要求	逐行检查清单	测试通过

危险信号——立即停止

• 用词：“应该”“可能”“看起来”
• 验证前就表示满意：“太好了！”“完美！”“完成了！”
• 准备在未经验证的情况下提交、推送或创建 PR
• 轻信 Agent 的成功报告
• 验证不完整
• 任何暗示成功却没有验证输出的措辞

防止自我合理化

借口	应对
“现在应该能用了”	运行验证
“我有信心”	信心 ≠ 证据
“就这一次”	没有例外
“Linter 通过了”	Linter ≠ 构建
“Agent 说成功了”	独立验证
“部分检查就够了”	部分检查不能证明任何事情

关键模式

测试：

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

回归（TDD）：

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "Wrote regression test" (no red-green)

要求：

✅ Re-read plan → Checklist each item → Report gaps or completion
❌ "Tests pass, phase complete"

Agent 委派：

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