Superpowers 是一个专为 Claude Code 打造的完整软件开发工作流，让你的 AI Agent 像资深工程师一样思考、规划和编码。
Superpowers 是什么？
Superpowers 是一个完整的软件开发工作流，它建立在可组合的技能集合之上。与传统的一次性生成代码不同，Superpowers 采用了一种分阶段、多 Agent 协同的方式，让 AI Agent 能够像人类工程师一样思考、规划、执行和验证代码。
当你启动一个编码任务时，Superpowers 不会立即跳去写代码，而是会：
- 先停下来思考你真正想要什么
- 提出多个设计方案并进行比较
- 制定详细的实现计划
- 分步骤执行开发任务
- 每个阶段都进行代码审查和测试
这种工作流方式让 AI Agent 的输出更加可靠、可维护，也更符合最佳实践。
核心特点
1. 可组合的技能系统
Superpowers 构建在"技能"概念之上。每个技能都是一个小型的独立模块，专注于特定的开发任务。这些技能可以像积木一样组合使用，构建出完整的开发流程。
技能库包含了大量专业能力：
- 测试驱动开发技能
- 系统化调试技能
- 代码生成和审查技能
- 项目管理技能
- 文档生成技能
- 版本控制技能
这种模块化设计让开发者能够根据项目需求，灵活地选择和组合不同的工作流。
2. 分阶段开发流程
Superpowers 将软件开发过程分为多个明确的阶段，每个阶段都有专门的子 Agent 负责：
brainstorming - 头脑风暴
在开始编码之前，先进行创意发散。通过提问来理清想法，探索多种可能的实现方式，细化需求，避免在编码阶段迷失方向。
writing-plans - 编写计划
制定详细的实现计划，包括：
- 技术方案选择
- 文件结构规划
- 关键功能实现顺序
- 潜在风险和备选方案
这个计划会成为后续开发的基础。
using-git-worktrees - 使用 git 工作树
为每个任务创建独立的 git 工作树，这样可以：
- 并行处理多个任务
- 保持代码库的整洁
- 避免不同分支之间的相互干扰
- 每个任务有独立的提交历史
executing-plans - 执行计划
按照编写好的计划分步骤执行开发任务。每个步骤都有明确的：
- 开始条件
- 执行动作
- 完成标准
执行过程中会根据实际情况动态调整。
test-driven-development - 测试驱动开发
严格执行 TDD 流程：
- 先编写测试用例
- 再编写实现代码
- 运行测试验证
- 如果测试失败，修改代码直到通过
- 只在测试通过后才允许提交代码
requesting-code-review - 请求代码审查
在开发过程中，持续请求代码审查：
- 检查代码质量
- 发现潜在问题
- 确保符合项目规范
- 提出改进建议
receiving-code-review - 接收代码审查
处理来自其他 Agent 或开发者的代码审查反馈：
- 理解审查意见
- 根据反馈修改代码
- 确保所有问题都得到解决
finishing-a-development-branch - 完成开发分支
当所有任务完成后：
- 验证所有测试
- 合并到主分支
- 清理工作树
- 创建发布说明
3. 多 Agent 协同
Superpowers 的一个强大之处在于它能够并行协调多个子 Agent：
- 不同阶段可以由不同的 Agent 负责
- 同一阶段的多个任务可以并行执行
- Agent 之间可以相互交流和协作
- 有一个主 Agent 负责整体协调和决策
这种多 Agent 架构大幅提高了开发效率。
4. 强调最佳实践
Superpowers 内置了多项最佳实践：
测试驱动开发（TDD）
- 总是先写测试
- 测试驱动实现
- 失败时修复代码
- 成功后才继续
- 强制 RED-GREEN-REFACTOR 循环
系统性优于临时性
- 遵循既定的流程
- 使用标准化的工具和框架
- 避免临时性的解决方案
- 优先考虑长期的可维护性
复杂度简化
- 将大任务分解为小任务
- 每次只关注一个目标
- 避免一次性实现过多功能
- 逐步迭代，快速获得反馈
证据胜过声明
- 用测试结果验证假设
- 提供可复现的证据
- 避免主观臆断
- 确保代码行为符合预期
5. 严格的代码质量标准
Superpowers 对代码质量有极高的要求：
验证完成前必须修复
- 所有测试必须通过
- 所有代码审查意见必须解决
- 所有已知问题必须修复
- 否则不允许进入下一阶段
系统化的调试流程
- 采用四步根因分析法
- 条件式调试技术
- 防御性编程技巧
- 日志和跟踪机制
并行开发分支管理
- 使用 git 工作树隔离环境
- 每个功能在独立分支开发
- 确保可以独立测试和审查
- 完成后再合并
技能库概览
Superpowers 包含丰富的技能库，涵盖了软件开发的全生命周期：
| 技能类别 | 技能名称 | 主要功能 |
|---|---|---|
| 需求分析 | Requirements | 梳理用户需求，明确项目目标 |
| 架构设计 | Architect | 设计系统架构和技术方案 |
| 计划编写 | writing-plans | 制定详细的实现计划 |
| 代码生成 | generate | 根据计划生成代码 |
| 测试开发 | test-driven-development | TDD 流程，红绿重构 |
| 代码审查 | CodeReview | 检查代码质量，发现潜在问题 |
| 项目管理 | ProjectManager | 管理项目任务和里程碑 |
| 调试优化 | Debugger | 定位和修复代码问题 |
| 文档生成 | DocGen | 自动生成技术文档和说明 |
| 版本控制 | GitHelper | 管理 git 分支和版本合并 |
这些技能可以单独使用，也可以组合成完整的工作流。
安装方式
Claude Code（推荐）
Claude Code 有内置的 Superpowers 插件系统，安装非常简单：
- 在 Claude Code 中打开插件市场
- 搜索 “superpowers-marketplace”
- 点击安装插件
- 完成后，Superpowers 的命令就会自动可用
这是最简单和最直接的安装方式，推荐优先使用。
Codex
需要手动配置 Codex 以使用 Superpowers：
- 从 GitHub 下载最新的配置文件
- 按照 Codex 文档中的说明进行设置
- 配置完成后就可以使用 Superpowers 命令
OpenCode
OpenCode 也支持 Superpowers，但需要手动设置：
- 在 OpenCode 设置中添加技能目录
- 下载 Superpowers 技能定义文件
- 配置快捷键和触发条件
哲学理念
Superpowers 的设计基于以下核心理念：
测试驱动开发（TDD）
TDD 是 Superpowers 的核心哲学：
- 总是先写测试，再写实现代码
- 测试不仅是验证手段，更是设计工具
- 快速失败（Fail Fast）优于慢速成功
- 强制执行测试-编码-重构循环
系统性优于临时性
拒绝"先做再说"的方式，强调：
- 遵循既定的流程和规范
- 使用标准化的工具和框架
- 考虑长期的可维护性和扩展性
- 避免为了短期的便利牺牲代码质量
复杂度简化
通过模块化和分阶段的开发，降低认知负载：
- 每次只关注一个明确的目标
- 将大任务分解为小任务
- 快速迭代，频繁获得反馈
- 避免一次性处理过多复杂性
证据胜过声明
不依赖"应该没问题"的主观判断，而是：
- 用实际的测试结果说话
- 提供可复现的证据
- 确保行为符合预期和规范
为什么选择 Superpowers？
1. 让 AI Agent 更像人类工程师
传统的一次性代码生成往往缺乏：
- 思考过程的深度
- 对复杂系统的理解
- 对最佳实践的遵循
- 代码质量和可维护性的关注
Superpowers 通过分阶段、多 Agent 的工作流，让 AI Agent 能够像资深工程师一样思考、规划、执行和验证代码。
2. 提高代码质量和可靠性
Superpowers 内置的质量保证机制：
- 严格的测试要求
- 系统化的代码审查
- 强制修复所有已知问题
- 防止未经验证的代码进入生产环境
3. 加速开发迭代
通过并行化和自动化：
- 多个 Agent 同时工作
- 自动化的测试和审查
- 快速的迭代和反馈循环
- 缩短从想法到实现的时间
4. 降低维护成本
基于测试驱动开发和代码质量保证：
- 减少生产环境的 bug
- 提高代码的可读性和可维护性
- 降低后期修改和维护的成本
- 延长代码的生命周期
适用场景
1. 复杂 Agent 项目
对于需要长期维护和持续迭代的 Agent 项目，Superpowers 的系统化工作流能够：
- 保持代码库的整洁和有序
- 管理多个并行的开发分支
- 确保每个功能都经过充分测试和审查
- 提高团队的协作效率
2. 需要高质量代码的项目
对于代码质量要求极高的项目，Superpowers 的 TDD 哲学和严格的代码质量标准能够：
- 确保代码的可靠性和稳定性
- 减少潜在的安全风险
- 提高代码的性能和可维护性
- 满足严格的代码审查要求
3. 团队协作开发
在团队协作场景中，Superpowers 的多 Agent 架构和标准化的工作流能够：
- 统一开发标准和流程
- 协调不同开发者的工作
- 提高代码审查的效率
- 管理项目依赖和版本控制
4. 快速原型和验证
对于需要快速验证想法的项目，Superpowers 的快速迭代和测试驱动开发能够：
- 快速生成可运行的代码
- 通过测试验证假设
- 快速发现和修复问题
- 加速产品迭代周期
与传统方式的对比
传统一次性生成
- 优点：快速得到结果
- 缺点：缺乏思考深度，代码质量不稳定，难以维护
Superpowers 分阶段工作流
- 优点：质量高，可维护性强，符合最佳实践
- 缺点：需要更多时间和计算资源
Superpowers 选择了质量优先的策略，虽然会花费更多时间，但最终产出的代码更可靠、更易维护。
未来发展
Superpowers 作为一个活跃的开源项目，持续在发展和完善：
1. 更多技能的添加
技能库会不断扩展，添加更多专业化的技能，覆盖更多开发场景和工具。
2. 更好的 AI 集成
随着 AI 能力的提升，Superpowers 会更好地利用 AI 的推理和规划能力，提供更智能的开发建议。
3. 更强的工作流自动化
未来版本的 Superpowers 可能会更加自动化，减少人工干预的需求，实现真正的自主 Agent 开发。
4. 社区贡献
Superpowers 欢迎社区贡献：
- Fork 仓库
- 创建新技能并提交 PR
- 报告问题和建议
- 改进文档和示例
总结
Superpowers 是 Claude Code 生态中最重要的 Agent 开发工具之一。它通过分阶段、多 Agent 协同的方式，让 AI Agent 能够像资深工程师一样思考、规划和编码。
它的核心理念是质量优于速度，系统化优于临时性，证据胜过声明。通过严格的测试驱动开发、系统的代码审查和自动化流程，Superpowers 能够显著提高 AI Agent 生成代码的质量和可靠性。
对于追求高质量、可维护的 AI Agent 项目的开发者来说，Superpowers 是一个不可多得的强大工具。它不仅是一套工具，更是一种方法论，一种思维方式。
如果你正在使用 Claude Code 开发 AI Agent，强烈推荐安装 Superpowers，体验一下系统化工作流带来的好处。