HomeBrowseUpload
← Back to registry
// Skill profile

Superpowers Verification - 证据先行原则

name: superpowers-verification

by axelhu · published 2026-04-01

自定义
Total installs
0
Stars
★ 0
Last updated
2026-04
// Install command
$ claw add gh:axelhu/axelhu-superpowers-verification
View on GitHub
// Full documentation

---

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
  • **规则适用于:**

  • 精确措辞
  • 释义和同义词
  • 成功/正确的任何暗示
  • // Comments
    Sign in with GitHub to leave a comment.
    // Related skills

    More tools from the same signal band