来源：obra/superpowers（Jesse Vincent / Prime Radiant）
是什么
Superpowers 是一套面向 AI coding agent 的软件开发方法论，以可组合的 skills 形式实现。它不是代码库或框架——它是一组过程性文档，教 AI agent 如何以系统化的方式开发软件。
核心理念：AI agent 跟人类初级工程师一样——有能力，但缺乏纪律。Superpowers 提供纪律。
完整开发生命周期
用户想法
↓
[brainstorming] ← 探索需求，生成设计文档
↓
[using-git-worktrees] ← 创建隔离工作区
↓
[writing-plans] ← 将设计拆解为 2-5 分钟的原子任务
↓
[subagent-driven-development] ← 每个任务派一个全新 subagent 执行
├── [test-driven-development] ← 每个 subagent 必须先写测试
├── [requesting-code-review] ← 两阶段 review
└── [verification-before-completion] ← 执行验证，不允许口头声明完成
↓
[finishing-a-development-branch] ← 验证测试 → 合并/PR/丢弃设计哲学
对 AI 的不信任是一种美德
Superpowers 的整个设计基于一个前提：AI agent 会走捷径，会自我欺骗，会过度自信。 每个 skill 都充满了：
- Iron Laws（铁律）：不可违反的硬性规则
- HARD-GATE：物理性的流程门禁
- Rationalization Prevention（反合理化表）：预判 agent 会找什么借口，逐一反驳
- Red Flags：「如果你在想这个，说明你在犯错」的清单
这不是对 AI 的敌意，而是对 AI 认知弱点的深刻理解。
Anti-Rationalization（反合理化）
每个 skill 都有一张大表：「如果你在想 X，现实是 Y」。
这是 Superpowers 最独特的设计——它不只定义流程，还预判并封堵 agent 会用来逃避流程的所有借口。
Agent 不会直接违反规则，而是会「合理化」为什么这次是例外。反合理化表就是在封堵这些例外的入口。
典型例子（来自 brainstorming skill）：
| 如果你在想…… | 现实是…… |
|---|---|
| 「这个太简单，不需要设计」 | 简单项目恰恰是未审视假设最危险的地方 |
| 「我先做了再汇报吧」 | 做错方向比做慢更浪费时间 |
Spec-First（规格优先）
不写代码直到设计被批准。每个项目都需要，无论多简单。
哲学根基：未经审视的假设造成的浪费 > 设计的时间成本。HARD-GATE 在设计被批准前，禁止写任何代码。
TDD as Religion
先写了代码？删掉。不要当参考。删就是删。
把 TDD 从「最佳实践」升级为「不可违反的信条」。原因是：
- 后写的测试受实现偏见影响，只测试「做了什么」而非「该做什么」
- Agent 特别容易合理化跳过测试
- 「我已经手动测过了」← 恰恰是最危险的借口
Evidence Over Claims
声称完成但未验证 = 不诚实
直接把「未验证就说完成」定义为道德问题（不诚实），而非流程问题。这是极其有效的 prompt 策略——把遵循流程和 agent 的自我认同绑定。
禁止说的话：「should work」「looks correct」「probably passes」。必须运行命令，读输出，确认结果，然后才能声明。
Context Isolation（上下文隔离）
每个任务派全新 subagent，永远不继承主 session 的历史。
基于一个洞察：context pollution 是 AI agent 最大的敌人。 随着对话积累，agent 会受到之前错误假设、过时信息、无关细节的污染。每个 subagent 只收到精心策划的最小上下文。
Bite-Sized Tasks（原子任务）
每步 2-5 分钟，一个动作。
不是因为任务真的只需 5 分钟，而是因为：
- 原子任务难以出错
- 每步都可验证
- 失败时回滚成本极低
- Agent 在小范围内更可靠
流程即强制工作流
Skills 是强制工作流，不是建议。如果有 1% 的可能适用，你就必须使用。
大多数开发方法论是「建议」——agent 可以选择跟不跟。Superpowers 把它变成了强制性的，明确写着：
IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT. This is not negotiable. This is not optional.
可以直接借鉴的模式
Iron Law 模式：在关键流程节点设置不可绕过的规则。不是「建议」，是「铁律」。
Spec → Plan → Execute 三段式：任何功能先设计、再拆任务、再执行。
两阶段 Review：先检查是否符合规格（spec compliance），再检查代码质量（code quality），不要混在一起。
Context Isolation：每个 subagent 只给它需要的最小信息，不继承历史。
Verification Gate：声称完成前必须提供证据——运行命令、读输出、确认结果。
总结
相关：Spec-First Development · TDD · Anti-Rationalization Pattern · Context Isolation · Agent · YAGNI 与 TDD
Superpowers 不是一个技术框架，而是一套行为约束系统。它的核心信念是：
AI agent 跟人类一样会偷懒、会自欺、会走捷径。解决方案不是信任它的判断，而是用流程约束它的行为。
作者对 LLM 行为模式有深刻的观察——他不只写了「该做什么」，还详细列出了「agent 会怎么逃避做这件事」。这种双重设计（正面流程 + 反面封堵）是 Superpowers 真正的创新。