Superpowers开源项目介绍

项目概述

Superpowers 是一个面向 AI 编码代理（Coding Agents）的开源软件开发工作流框架，通过可组合的 “技能（Skills）” 体系，为 AI 编码工具注入标准化、规范化的开发流程，让 AI 能够按照专业的软件工程实践完成从需求梳理到代码交付的全周期工作。

该项目由资深开发者 Jesse Vincent 主导开发，目前已经成为 GitHub 上增长最快的开源项目之一：

• 截至 2026 年 4 月，项目已获得超过 160k+ Star，数千名社区贡献者

• 峰值增长速度达到每日近 2000 Star，曾登顶 GitHub 趋势榜第二位

• 已被 Anthropic 官方收录到 Claude Code 插件市场，成为官方认可的生态工具

• 支持 Claude Code、Cursor、Codex、OpenCode、GitHub Copilot CLI、Gemini CLI 等多个主流 AI 编码平台

不同于传统的 AI 编码插件，Superpowers 并非简单的代码生成工具，而是将成熟的软件开发方法论转化为可被 AI 执行的规则体系，让 AI 编码代理从 “盲目写代码” 转变为 “按流程做开发”，大幅提升 AI 开发的可靠性、可维护性和代码质量。

核心工作原理

Superpowers 的核心逻辑是通过预设的技能体系，为 AI 编码代理建立一套强制的开发流程，避免 AI 陷入 “想到哪写到哪” 的无序开发：

1. 需求前置梳理：当你启动开发任务时，AI 不会直接开始写代码，而是先通过苏格拉底式的提问，梳理你真正的需求，澄清模糊的目标，探索可能的替代方案。

2. 设计确认：将梳理后的需求和设计拆分为可阅读的小块，逐段向你确认，确保双方对要做的事情达成完全一致。

3. 任务拆解：在你确认设计后，AI 会将开发工作拆解为极小的、可执行的任务单元（每个任务仅需 2-5 分钟即可完成），每个任务都包含明确的文件路径、代码要求和验证标准。

4. 子代理并行执行：启动子代理驱动的开发流程，每个任务由独立的子代理完成，并且内置两轮审核机制：首先检查是否符合需求规范，然后检查代码质量。

5. 自动化质量管控：在整个开发过程中，强制遵循测试驱动开发（TDD）、系统化调试等最佳实践，自动拦截不符合规范的代码。

通过这套机制，AI 可以在无需人工干预的情况下，自主工作数小时，并且始终不偏离最初的计划，最终交付符合工程标准的代码。

核心特性

自动化流程管控

所有技能都会根据任务阶段自动触发，无需用户手动调用，AI 会在合适的阶段自动应用对应的工作流规则，用户只需要在关键节点进行确认即可。

标准化工程实践

框架内置了行业通用的软件工程最佳实践，并且通过强制规则确保 AI 严格执行：

• 强制测试驱动开发（RED-GREEN-REFACTOR）

• 系统化的根因调试流程

• 代码提交前的自动审核

• 隔离式的分支开发模式

可扩展的技能体系

整个框架基于可组合的技能体系构建，用户可以根据自己的需求扩展自定义技能，社区也在持续贡献新的技能模块，让框架可以适配更多的开发场景。

跨平台兼容

支持当前主流的所有 AI 编码平台，一套技能体系可以在不同的工具中通用，无需为每个平台单独适配。

安装指南

Superpowers 的安装方式根据你使用的 AI 编码平台有所不同，以下是各平台的安装方法：

Claude Code 官方市场

Superpowers 已经上架 Claude 官方插件市场，直接安装即可：

/plugin install superpowers@claude-plugins-official

Claude Code 社区市场

你也可以通过社区市场安装最新的开发版本：

# 先注册社区市场
/plugin marketplace add obra/superpowers-marketplace
# 安装插件
/plugin install superpowers@superpowers-marketplace

Cursor

在 Cursor 的 Agent 聊天中，直接通过插件市场安装：

/add-plugin superpowers

或者在 Cursor 的插件市场中搜索 “superpowers” 进行安装。

Codex

直接让 Codex 执行安装指令即可：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

详细文档参考：docs/README.codex.md

OpenCode

同样，让 OpenCode 执行安装指令：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

详细文档参考：docs/README.opencode.md

GitHub Copilot CLI

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

Gemini CLI

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

更新命令：

gemini extensions update superpowers

安装验证

安装完成后，启动一个新的会话，尝试触发一个技能，比如输入 “help me plan this feature” 或者 “let’s debug this issue”，如果 AI 自动调用了对应的 Superpowers 技能，说明安装成功。

标准开发工作流

Superpowers 定义了一套完整的开发工作流，覆盖从需求到交付的全流程，每个阶段都会自动激活对应的技能：

1. 需求头脑风暴（Brainstorming）
   在写代码之前自动激活，通过提问梳理模糊的需求，探索替代方案，将设计拆分为可验证的小块，最终生成标准化的设计文档。

2. 隔离工作区准备（Git Worktrees）
   在你确认设计后自动激活，创建独立的 Git 工作树和新分支，自动完成项目环境配置，验证测试基线，确保开发环境干净可用。

3. 实现计划编写（Writing Plans）
   根据确认的设计，将整个开发工作拆解为极小的任务单元，每个任务都包含明确的文件路径、完整的代码要求和验证步骤，确保每个任务都可以独立执行。

4. 任务执行（Subagent/Plan Execution）
   根据计划执行任务，支持两种模式：

   • 子代理驱动开发：每个任务由独立的子代理完成，内置两轮审核

   • 批量执行：分批次执行任务，在批次之间设置人工检查点

5. 测试驱动开发（Test-Driven Development）
   在代码实现阶段强制激活，严格遵循 RED-GREEN-REFACTOR 流程：先写失败的测试，验证测试失败，然后写最小化的代码让测试通过，最后重构代码，自动删除先写代码后写测试的违规内容。

6. 代码审核（Code Review）
   在任务之间自动激活，对照计划审核代码，按严重程度报告问题，严重问题会阻塞后续开发，确保代码始终符合要求。

7. 开发收尾（Finishing Development）
   所有任务完成后自动激活，验证所有测试通过，向你提供合并、提交 PR、保留分支或者丢弃修改的选项，自动清理临时工作区。

整个流程中，AI 会在每个任务前自动检查对应的技能，所有流程都是强制执行的，而非可选的建议，确保开发过程始终符合规范。

技能库详解

Superpowers 内置了丰富的技能库，覆盖开发的各个场景，所有技能都可以自动触发：

测试类技能

• test-driven-development：实现标准的 RED-GREEN-REFACTOR 开发循环，内置测试反模式参考，确保测试的有效性。

调试类技能

• systematic-debugging：标准化的 4 阶段根因分析流程，包含根因追踪、深度防御、条件等待等专业调试技术。

• verification-before-completion：在宣布问题修复前，自动验证问题是否真的被解决，避免 “假修复”。

协作类技能

• brainstorming：苏格拉底式的需求梳理与设计 refinement

• writing-plans：生成详细的可执行实现计划

• executing-plans：带检查点的批量任务执行

• dispatching-parallel-agents：支持子代理的并行工作流

• requesting-code-review：内置预审核检查清单

• receiving-code-review：标准化的代码评审反馈处理流程

• using-git-worktrees：隔离式的并行开发分支管理

• finishing-a-development-branch：合并与 PR 的决策工作流

• subagent-driven-development：带两轮审核的快速迭代子代理开发

元技能

• writing-skills：帮助用户创建新技能的工具，内置技能开发的最佳实践和测试方法

• using-superpowers：帮助用户快速上手 Superpowers 技能体系的引导技能

开发理念

Superpowers 的设计遵循以下核心哲学：

• 测试驱动开发优先：永远先写测试，再写代码

• 系统化优于临时拼凑：用标准化流程代替随机猜测

• 优先降低复杂度：将简单性作为首要目标

• 证据优先于声明：在宣布成功前，必须有验证证据

实践效果与用户反馈

根据社区用户的反馈，Superpowers 已经在大量生产项目中得到验证：

• 大量开发者反馈，Superpowers 强制的 TDD 流程帮助他们养成了更好的开发习惯，有用户评价：“它通过强制 TDD，让我变成了更好的开发者”

• 使用 Superpowers 开发的生产应用，无需手动编写测试，即可达到 85%-95% 的测试覆盖率

• 对于复杂项目，AI 可以在无需人工干预的情况下自主工作数小时，大幅提升开发效率

• 代码质量得到显著提升，减少了后续的维护成本

当然，也有部分用户提出了一些权衡点：

• 子代理模式会消耗更多的 Token，对于简单项目可能会有额外的成本

• 严格的流程管控在某些快速原型场景下，可能会显得有些繁琐

贡献指南

Superpowers 是一个社区驱动的开源项目，欢迎所有开发者贡献新的技能或者改进现有功能：

1. Fork 本仓库

2. 为你的新技能创建独立分支

3. 使用内置的writing-skills技能来创建和测试你的新技能

4. 提交 Pull Request

详细的技能开发指南可以参考：skills/writing-skills/SKILL.md

版本更新

Superpowers 的技能会随着插件更新自动同步，你只需要更新插件即可获取最新的技能：

/plugin update superpowers

社区与支持

Superpowers 拥有活跃的社区，你可以通过以下渠道获取支持：

• Discord 社区：加入我们的 Discord，获取社区支持、分享你的使用经验

• Issue 反馈：在GitHub Issues提交问题和建议

• 发布通知：订阅更新通知，获取新版本的发布消息

• 作者博客：Jesse Vincent 的博客，了解项目的最新动态和设计思路

许可证

本项目基于 MIT License 开源，详细信息请参考仓库中的 LICENSE 文件。

项目链接

• GitHub 仓库：https://github.com/obra/superpowers

• 官方介绍博客：https://blog.fsck.com/2025/10/09/superpowers/