obra/superpowers 不仅仅是一个工具,更是一套专门为 AI Agent 打造的软件开发方法论。它可以极大地提升 Claude Code 在处理中大型项目时的可靠性,避免 AI “一听需求就瞎写代码”的问题。
为什么需要 Superpowers?
通常情况下,当你在 Claude Code 中提出一个复杂的开发需求时,AI 往往会跳过思考阶段,直接开始大段大段地输出代码或修改文件。这会导致几个严重问题:缺少全局规划、改漏文件、引入 Bug 以及忽略测试。
Superpowers 的作用就是“强行踩刹车”:它通过一套系统化的工作流(Skills),强制要求 Claude 在写第一行代码前,必须先与你进行头脑风暴、编写设计文档、制定详细的执行计划,并在写代码时严格遵循测试驱动开发(TDD)。
核心功能与工作流
安装 Superpowers 后,你的 Claude Code 将具备以下“超能力”:
- 强制计划(Planning):面对新需求,AI 会逐一提问,与你探讨架构和权衡,直到梳理出完美的方案,并将其保存为 Markdown 文档(通常在
docs/plans/目录下)。 - 任务拆解(Task Breakdown):将复杂项目拆解为包含具体文件路径、代码结构和验证步骤的“微任务”(每个任务对应 2-5 分钟的开发量)。
- 测试驱动开发(TDD 强制执行):严格遵循
红-绿-重构(RED-GREEN-REFACTOR)原则。它会强迫 AI 先写一个会报错的测试用例,再写最少量的业务代码使其通过,最后再提交。 - 系统化调试(Systematic Debugging):当遇到 Bug 时,阻止 AI “盲猜修复”,强制要求它按照 4 步走:分析根本原因 -> 模式分析 -> 提出假设 -> 实施修复代码。
如何安装
由于它是 Claude Code 的第三方插件市场,你需要通过 Claude Code 的命令行进行安装:
第一步:在 Claude Code 中添加市场
/plugin marketplace add obra/superpowers-marketplace第二步:安装核心 Superpowers 插件
/plugin install superpowers@superpowers-marketplace(注:随着其大受欢迎,核心的 superpowers 插件目前也已经被收录进了 Claude 官方插件市场 claude-plugins-official 中。)
除了核心插件,该市场还提供其他高阶工具,例如允许 Claude 直接控制 Chrome 浏览器进行自动化端到端测试的插件:
/plugin install superpowers-chrome@superpowers-marketplace如何使用?
模式一:全自动接管(推荐)
Superpowers 最棒的一点是**“零配置”**。安装完毕并重启 Claude Code 后,插件会自动通过 session-start-hook 注入系统提示词。当你正常用自然语言描述需求(例如:“我要重构现有的用户鉴权逻辑”),Claude 会自动感知到这是一个复杂任务,主动停止直接写代码的行为,并开始引导你进行方案设计。
模式二:通过斜杠指令(Slash Commands)手动调用 你可以使用特定的内置指令来强制触发特定的工作流:
/superpowers:brainstorming [你的需求]:启动头脑风暴。AI 会向你提问并最终生成一份设计文档。/superpowers:write-plan:当设计方案确认后,使用此命令让 AI 将设计转化为具体的步骤执行计划。/superpowers:execute-plan:让 AI 按照刚写好的计划,一步一步或分批次(Batches)执行代码编写和测试。
示例
请帮我分析一下这个项目的结构
用户注册时有问题,注册后没有发送欢迎邮件,帮我修复
/superpowers:brainstorming 我有一个旧的 OAuth2 项目需要重构。目标是让架构设计更加合理(解耦授权与资源服务),补全遗漏的核心功能(如 PKCE、Refresh Token 轮转),并排查现有的逻辑和安全错误。请先审查当前代码库并与我确认设计方案。
执行测试时遇到了 Token Invalid 错误。请使用你的 root-cause-tracing 技能找出根本原因。适用场景建议
- 长线项目开发:配合持久化文档(如将其计划输出在
docs/下),即使几天后重新打开 Claude Code,只要让它阅读计划文档,它就能瞬间找回之前的开发进度和上下文。 - 重构与大范围迁移:比如更换 UI 库或数据库框架。Superpowers 会先让 AI 找出所有受影响的文件,再逐一修改,防止遗漏。
总之,obra/superpowers 将 AI 编程助手从一个“手脚很快但粗心大意的初级程序员”变成了一个“自带系统化工程素养的架构师”。对于任何希望使用 Claude Code 进行严肃软件开发的工程师来说,这几乎是必装的插件。