- name
- superpowers-verification
- description
- Use when about to claim any work is complete, fixed, passing, or successful - requires running fresh verification commands and reading actual output before making any success claims; evidence before assertions always
Superpowers Verification - 证据先行原则
核心准则
声称工作完成前必须运行验证命令。未运行验证就声称成功 = 说谎，不是效率。
在声称任何状态之前：
1. 识别：哪个命令能证明这个说法？
2. 运行：执行完整命令（全新、完整）
3. 读取：完整输出，检查退出码，统计失败数
4. 验证：输出是否证实了说法？
- 如果否：给出实际状态 + 证据
- 如果是：给出说法 + 证据
5. 只有这时：才能做出声称
跳过任何步骤 = 说谎，不是验证常见验证要求
| 声称 | 需要 | 不够 |
|---|---|---|
| 测试通过 | 测试命令输出：0 failures | 之前运行过、"应该能过" |
| Linter 干净 | Linter 输出：0 errors | 部分检查、推测 |
| 构建成功 | 构建命令：exit 0 | Linter 通过、日志看起来正常 |
| Bug 修复 | 原始症状测试：通过 | 代码改了、假定修复了 |
| 回归测试正常 | 红绿循环验证过 | 测试通过了一次 |
| Agent 完成了 | VCS diff 显示变更 | Agent 报告"成功" |
| 需求满足 | 逐项检查清单 | 测试通过、阶段完成 |
红绿验证循环（Regression Test）
✅ 写测试 → 运行（通过）→ 回滚修复 → 运行（必须失败）→ 恢复 → 运行（通过）
❌ "我写了回归测试"（没有红绿验证）禁止的措辞
以下措辞出现说明还没有验证：
- 使用 "应该"、"大概"、"看起来"
- 表达满意之前："很好！"、"完美！"、"完成了！"等
- 即将 commit/push/PR 但没有验证
- 信任 agent 的成功报告
- 依赖部分验证
验证检查表（完成工作前必须打勾）
- [ ] 运行了完整的测试命令
- [ ] 读取了完整输出
- [ ] 确认 0 failures / exit 0
- [ ] 其他相关测试仍然通过
- [ ] 报告包含实际证据（命令 + 输出摘要）
不能全部打勾？说明跳过了 TDD。从头开始。
为什么这很重要
从 24 个失败记忆中：
- 主人说"我不信你"——信任崩塌
- 未定义的函数被发出去——会崩溃
- 未完成的需求被发出去——功能缺失
- 虚假完成浪费时间 → 重新导向 → 返工
何时应用
永远在此之前：
- 任何成功/完成说法的变体
- 任何表达满意
- 任何正面工作状态描述
- Commit、PR 创建、任务完成
- 转向下一个任务
- 委托给 agents
规则适用于：
- 精确措辞
- 释义和同义词
- 成功/正确的任何暗示