让编程助手写代码,常常一上来就闷头敲,需求没对齐就出实现,返工不断。Superpowers 的思路不是再加一个工具,而是给助手注入一整套软件开发方法论:先头脑风暴对齐意图,再写计划,再派子代理逐任务实现并互相评审。它更像“流程纪律”,让任何编码助手都拥有资深工程师的工作节奏。

项目基本信息

信息项详情
项目名称superpowers
GitHub地址https://github.com/obra/superpowers
项目描述面向编程智能体的技能框架与软件开发方法论,让助手按纪律工作
作者obra
开源协议MIT License
开源状态公开
LanguagesShell
支持平台Windows / macOS / Linux
最后更新2026-10-23

一、项目介绍

Superpowers 是一套建立在可组合技能之上的完整软件开发方法论。它从你启动编码助手的那一刻介入:先不急着写代码,而是把真实意图聊清楚、产出设计文档、拆成可执行计划,再启动子代理驱动开发(subagent-driven development),强调真正的红绿 TDD、YAGNI、DRY。技能会自动触发,你无需特殊操作。

二、核心优势

  • 先对齐后实现:brainstorming 把需求聊透,再进入编码。
  • 计划驱动:writing-plans 把工作拆成 2–5 分钟的小任务,含文件路径与验证。
  • 子代理开发:每任务派新子代理,做完即评审,省心且不易跑偏。
  • 质量门禁:test-driven-development、requesting-code-review 等强制流程。
  • 跨 harness:Claude Code、Codex、Cursor、Gemini CLI、Copilot 等 15+ 工具通用。

三、适用场景

  • 用任意编程助手做中大型功能,想要可控、可回溯的流程。
  • 团队统一“应该如何写代码”的工程纪律。
  • 希望减少返工、提升一次成功率。
  • 把资深工程师的工作方式固化成可复用的技能。

四、安装教程

以 Claude Code 官方市场为例:

 /plugin install superpowers@claude-plugins-official

或通过 Superpowers 市场(多种 harness 各自有命令):

 /plugin marketplace add obra/superpowers-marketplace
 /plugin install superpowers@superpowers-marketplace

常见报错:不同 harness 安装命令不同,务必对照 README 里对应小节;部分 harness(如 Hermes)无压缩后钩子,超长会话可能丢失引导,需新开会话。

五、使用示例

安装后新建会话,直接说“帮我做个 React 待办列表”。正常工作的安装会在写任何代码前自动触发 brainstorming,先和你对齐需求,再产出设计文档,最后进入计划与实现。

 Let's make a react todo list

输出:会话依次经历头脑风暴 → 设计文档 → 计划 → 子代理实现 + 评审 → 代码评审 → 收尾,全程可审阅。

六、常见问题

  • 支持我的助手吗?已覆盖 Claude Code、Codex、Cursor、Gemini CLI、Copilot、Qwen Code 等 15+。
  • 会拖慢速度吗?流程更稳,长任务可自治数小时不偏离计划。
  • 怎么诊断异常?让助手“figure out what went wrong with superpowers”会调用诊断技能并给出证据。

七、总结

Superpowers 把“工程纪律”做成可插拔的技能框架,让任意编程助手都按资深节奏工作,显著降低返工率。MIT 协议,跨 harness 通用,适合重视流程与质量、又不想被单一平台锁定的团队与个人。