Superpowers
给你的 Coding Agent 装上 24 万 Star 的开发方法论

它到底是什么

一句话：Superpowers 是一套可组合的技能框架，让你的 Coding Agent 自动遵循完整的软件开发方法论。

想象一下：你启动 Claude Code、Codex、Cursor 或者任何 Coding Agent，说一句"帮我做个用户认证模块"。普通 Agent 的反应是立刻开写代码，写到一半发现设计有问题再回头改，改完发现测试没覆盖再补，补完发现跟其他模块冲突了再重构。

装了 Superpowers 之后，Agent 的反应完全不一样：它会先退一步，问你到底想解决什么问题，然后跟你一起敲定设计文档，再把工作拆成一个个 2-5 分钟的小任务，每个任务都带测试用例，然后用子 Agent 并行执行，执行完还有两轮代码审查——先查是否符合规格，再查代码质量。

整个流程是强制的，不是建议。Agent 在每个环节之前会自动检查有没有对应的 Skill，有就按规矩来。

解决的核心痛点

现在用 Coding Agent 写代码，最大的问题不是它写不出来，而是它写出来的东西经常是这样的：

Superpowers 的核心洞察是：这些问题不是模型能力不够，而是缺乏方法论约束。就像给一个聪明但没经验的初级工程师一套严格的开发流程，他的产出质量会立刻提升。

技术架构拆解

核心机制：技能系统（Skills）

Superpowers 不是一个 CLI 工具，也不是一个 IDE 插件。它是一组 Markdown 文件，定义了 Agent 在不同阶段应该遵循的行为规则。

每个 Skill 包含：

• 触发条件 — 什么时候激活这个技能（比如"Agent 准备写代码时"触发 brainstorming）
• 行为规则 — Agent 必须执行的具体步骤
• 输出格式 — 每个步骤产出什么（设计文档、任务计划、测试用例等）
• 质量门禁 — 什么时候算"完成"，什么情况必须回退

关键设计：这些不是 Prompt 建议，而是强制工作流。Agent 在执行任何任务前会自动检查相关 Skill，然后按照定义好的流程走。

七大核心工作流

Superpowers 把软件开发拆成 7 个阶段，每个阶段有对应的 Skill：

子 Agent 驱动开发（Subagent-Driven Development）

这是 Superpowers 最有特色的设计。传统模式下，一个 Agent 从头写到尾，容易偏离计划。Superpowers 的做法是：

主 Agent（你对话的那个）
    ├── 读取任务计划
    ├── 任务 1 → 启动子 Agent A → 写代码 + 测试
    │     ├── 审查：是否符合任务规格？
    │     └── 审查：代码质量是否达标？
    │     └── 通过 → 提交
    ├── 任务 2 → 启动子 Agent B → 写代码 + 测试
    │     └── ...
    └── 所有任务完成 → 主 Agent 汇总审查 → 合并

每个子 Agent 是全新的上下文，只拿到当前任务的信息，不会被之前的历史对话干扰。主 Agent 负责监督和审查。实际使用中，Agent 可以自主工作数小时而不需要你介入。

兼容性：全平台覆盖

Superpowers 支持目前市面上所有主流 Coding Agent：

• Claude Code — 通过官方插件市场安装
• OpenAI Codex（App + CLI）— 通过官方插件市场
• Cursor — /add-plugin superpowers
• OpenCode — 从 GitHub 安装
• Gemini CLI — gemini extensions install
• GitHub Copilot CLI — 通过 marketplace
• Kimi Code、Pi、Factory Droid、Antigravity — 各有安装方式

每个平台的安装方式不同，但核心 Skill 文件是同一套。

怎么装

Claude Code（最简单）

# 官方插件市场
/plugin install superpowers@claude-plugins-official

# 或者通过 Superpowers 自己的市场
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

OpenAI Codex

# Codex App 里：侧边栏 → Plugins → Coding 区域 → 点 + 安装
# Codex CLI 里：
/plugins
# 搜索 superpowers → Install Plugin

Cursor

# Agent 聊天里输入
/add-plugin superpowers

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

OpenCode

# 在 OpenCode 对话里输入
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

验证安装

安装后不需要额外配置。启动你的 Coding Agent，给它一个开发任务，观察它的行为——如果它先问你需求而不是直接写代码，说明 Superpowers 已经生效了。

和同类方案对比

适用场景

• 中大型功能开发 — 需求复杂、涉及多个文件的任务，Superpowers 的设计→规划→执行流程特别有价值
• 需要高质量代码的项目 — TDD + 两轮审查，产出质量显著高于裸跑 Agent
• 长时间自主开发 — 子 Agent 驱动模式让 Agent 可以连续工作数小时
• 团队协作 — 统一的开发方法论，不同人用不同 Agent 也能保持一致的代码质量
• 学习 Agent 开发流程 — 不知道怎么让 Agent 高效工作？Superpowers 帮你定义了最佳实践

实际体验的坑

• 简单任务会变慢 — 改个 CSS 颜色也要走设计→规划→执行流程，大材小用。适合有一定复杂度的任务
• Token 消耗增加 — 每个阶段都有额外的提示词和审查，Token 用量比裸跑多 2-3 倍
• 子 Agent 模式需要平台支持 — 不是所有 Agent 都支持启动子 Agent，不支持的平台会退化为批次执行模式
• Shell 项目，实际是 Markdown — 主仓库语言标记是 Shell，但核心内容是 Markdown Skill 文件，不要被语言标签误导
• 商业支持是付费的 — 框架本身 MIT 开源，但企业级支持、托管消费管理等需要联系 Prime Radiant
• 遥测默认开启 — 官方 Logo 加载会带版本号，隐私敏感的话设置 SUPERPOWERS_DISABLE_TELEMETRY=1

谁在做

Superpowers 由 Jesse Vincent 和 Prime Radiant 团队开发。Jesse 是知名开源开发者，之前做过 RT（Request Tracker，最流行的开源工单系统）。

项目 2025 年 10 月开源，到现在 24 万 Star，增长速度惊人。社区活跃度很高，Discord 社区有专门的讨论频道。

总结

Superpowers 的核心价值不是"让 Agent 更聪明"，而是"让 Agent 更守规矩"。它把软件工程的最佳实践——TDD、设计先行、任务拆分、代码审查——打包成 Agent 可以自动遵循的技能。

如果你经常用 Coding Agent 写超过 100 行的代码，Superpowers 值得一试。安装成本几乎为零（一行命令），但代码质量提升是肉眼可见的。

项目地址：github.com/obra/superpowers

官方博客：发布公告

Discord 社区：discord.gg/35wsABTejz