Superpowers 是一个专为 AI 编程代理设计的组合式技能框架与软件开发方法论。它通过强制执行严格的工程工作流（如 TDD、设计先行、子代理协作），将 AI 从简单的代码生成器转变为能够进行系统规划、测试驱动开发和自我审查的虚拟工程师，显著提升 AI 编码项目的质量与可维护性。
一分钟了解#
Superpowers 是一套让 Claude、Codex 或 OpenCode 等编程代理"学会"正规软件工程流程的插件系统。
它不仅仅是一个工具集，更是一种开发范式。它通过在代码编写前强制执行"头脑风暴"和"计划制定"，并在开发中强制执行"红绿重构"的 TDD 流程，解决了 AI 容易产生幻觉代码、缺乏全局观且难以维护大型项目的痛点。
核心价值：通过约束和引导 AI 的行为，将 AI 编码从"随意拼凑"提升为"工程化落地"。
快速上手#
安装难度：低 - 需要特定的 AI 编程环境支持。
Superpowers 提供了针对不同 AI 客户端的安装方式，最便捷的是在 Claude Code 中通过插件市场安装：
# 1. 注册市场
/plugin marketplace add obra/superpowers-marketplace
# 2. 安装插件
/plugin install superpowers@superpowers-marketplace
# 3. 验证安装
/help
# 应该能看到 /superpowers:brainstorm, /superpowers:write-plan 等命令
适合我的场景吗？
- ✅ AI 辅助复杂开发：当你使用 AI 编写超过 100 行代码或包含多文件逻辑的项目时。
- ✅ 追求代码质量：如果你厌倦了 AI 生成的代码缺乏测试或难以通过 CI/CD。
- ✅ 团队协作规范：需要 AI 遵循特定的 Git 工作流和代码审查标准。
- ❌ 简单脚本生成：如果只是写一个简单的 10 行 Python 脚本，此框架可能过于繁琐。
核心能力#
1. 头脑风暴与设计 - 拒绝盲目编码#
在 AI 动手写代码之前，Superpowers 会强制激活"头脑风暴"技能。它会通过苏格拉底式的提问引导你明确需求，探索替代方案，并将最终设计切分为易于阅读的章节供你确认。 实际价值：避免 AI 在理解模糊需求时产生错误的假设，确保方向正确。
2. 测试驱动开发 (TDD) - 强制红绿重构#
这是 Superpowers 的核心机制。AI 被强制遵循"先写失败的测试 -> 观察失败 -> 编写最小代码 -> 观察通过"的循环。如果 AI 试图在测试之前编写实现代码，系统会自动拦截并纠正。 实际价值：从根本上保证代码的健壮性，并为未来的重构提供安全网。
3. 子代理驱动开发 - 并行与审查#
将宏大的开发计划拆解为 2-5 分钟的小任务，并分发给不同的"子代理"并行处理。每个子代理的工作都会经过"规格符合度"和"代码质量"的两轮审查。 实际价值：实现高度的自主化，AI 可以像高级工程师一样连续工作数小时而不偏离轨道。
4. 系统化调试#
替代简单的"尝试修改"，提供了包含根因追溯、纵深防御和基于条件等待的 4 阶段调试流程。 实际价值：当 AI 遇到 Bug 时，不再是盲目猜测，而是进行逻辑严密的排查。
技术栈与集成#
开发语言：Shell, JavaScript, Python, TypeScript 主要依赖：依赖 Claude Code, Codex 或 OpenCode 等宿主环境。 集成方式：
- Claude Code: 通过内置插件市场集成。
- Codex/OpenCode: 通过读取远程 Markdown 指令集注入。
维护状态#
- 开发活跃度：活跃维护，拥有大量的提交记录和版本标签。
- 社区响应：拥有丰富的 Issue 和 PR 讨论，文档完善。
- 扩展性：支持用户编写自定义 Skills，项目本身包含"如何编写技能"的元技能。