Superpowers

让你的 AI 编程代理拥有超能力 — 一套完整的
AI 驱动软件开发方法论与技能体系

一、什么是 Superpowers？

Superpowers 是一套为 AI 编程代理（Coding Agent）打造的完整软件开发方法论。它不是简单的提示词集合，而是一个由14 个可组合技能（Skills）和自动触发机制构成的系统化工程框架。

想象一下：你有一个 AI 编程助手，但它总是直接开始写代码，不考虑设计、不写测试、不做审查。Superpowers 就是解决这个问题的——它让 AI 在编码之前先思考，在编码过程中规范行为，在编码完成后严格验证。

项目信息

作者：Jesse Vincent 及 Prime Radiant 团队

GitHub：github.com/obra/superpowers

许可证：MIT License（完全免费开源）

当前版本：v5.1.0（2026 年 4 月发布）

二、为什么需要 Superpowers？

在使用 Claude Code、Cursor、Copilot 等 AI 编码工具时，你可能遇到过这些痛点：

• AI 直接跳进写代码，没有充分理解需求就动手
• 不写测试或测试质量差，代码看似能跑但隐患重重
• 缺乏代码审查机制，生成的代码可能包含安全漏洞或性能问题
• 工作流不可复现，每次对话的结果差异巨大
• 项目越做越乱，缺少架构设计和模块化思考

Superpowers 通过强制性的工作流程和自动触发的技能来解决这些问题。它不是一个建议清单——而是一套必须执行的工作流。当你的 AI 代理安装了 Superpowers 后，它会在正确的时机自动调用相应的技能。

注意：该项目有 94% 的 PR 拒绝率！维护者对贡献质量要求极高，这也从侧面说明了项目的严谨程度。

三、核心工作流程（七大阶段）

Superpowers 将软件开发过程划分为七个连续阶段，每个阶段对应一个自动触发的技能：

Superpowers 完整开发流水线

1 头脑风暴 (Brainstorming)

在写任何代码之前激活。通过苏格拉底式提问完善想法，探索替代方案，分段展示设计供确认，最终输出正式的设计文档。

2 Git Worktree 创建

设计批准后自动创建隔离的 Git Worktree 和新分支，确保主分支不受影响，并验证干净的测试基线。

3 编写计划 (Writing Plans)

将任务拆分为 2-5 分钟的小任务块，每个任务包含精确的文件路径、完整代码和验证步骤。

4 子代理驱动开发 / 计划执行

每个任务派发独立子代理执行，采用两阶段审查机制（规格合规性 + 代码质量）。AI 可自主运行数小时而不偏离计划。

5 测试驱动开发 (TDD)

强制 RED-GREEN-REFACTOR 循环：先写失败测试 → 观察失败 → 写最少代码 → 观察通过 → 提交。删除所有在测试之前编写的代码。

6 请求代码审查

任务之间自动触发审查，对照计划检查实现，按严重程度报告问题。关键问题会阻塞后续进度。

7 完成开发分支

全部任务完成后自动验证所有测试，提供合并/创建 PR/保留/丢弃等选项，清理 worktree 资源。

关键特点：以上所有技能都是自动触发的！你不需要手动调用任何命令，AI 代理会在正确的时间点自动进入相应的工作阶段。

四、技能库详解

Superpowers 的 14 个核心技能分为四大类：

分类	技能名称	功能说明
测试	test-driven-development	TDD 红/绿/重构循环，含测试反模式参考手册
调试	systematic-debugging	四阶段根因分析：根因追踪 + 纵深防御 + 条件等待
	verification-before-completion	完成修复前验证问题确实已解决
协作	brainstorming	苏格拉底式设计精炼（支持可视化伴侣服务器）
	writing-plans	编写详细的实施计划和任务分解
	executing-plans	带人工检查点的批量计划执行
	dispatching-parallel-agents	并发子代理工作流调度与管理
	requesting-code-review	发起代码审查（含审查员提示模板）
	receiving-code-review	回应代码审查反馈的标准化流程
	using-git-worktrees	Git 并行开发分支管理（Worktree 机制）
	finishing-a-dev-branch	分支完成后的合并/PR 决策流程
	subagent-driven-development	子代理驱动开发 + 两阶段审查循环
元技能	writing-skills	创建新技能的最佳实践（含测试方法论）
	using-superpowers	技能系统的入门引导和使用说明

特色技能深度解读

Brainstorming（头脑风暴） — 这是整个流程的入口。当 AI 检测到你想要构建某个东西时，它不会立刻写代码，而是通过一系列精心设计的提问来帮你理清需求。它甚至内置了一个可视化伴侣服务器，可以生成可视化的设计图来辅助沟通。

Subagent-Driven Development（子代理驱动开发） — 这是 Superpowers 最具创新性的功能。它将每个开发任务派发给一个全新的子代理，并通过两阶段审查保证质量：第一阶段检查是否遵循了规格说明，第二阶段检查代码质量。这使得 AI 可以自主工作数小时而不偏离计划。

Test-Driven Development（测试驱动开发） — 强制执行严格的 TDD 流程。不仅要求先写测试，还维护了一份测试反模式参考手册，帮助识别常见的测试坏实践（如 mock 过度使用、测试耦合实现细节等）。

Systematic Debugging（系统化调试） — 提供四阶段的根因分析方法论，包括根因追踪技术、纵深防御策略和基于条件的等待技巧，附带实际可用的示例脚本。

---

五、安装指南

Superpowers 目前支持 8 种主流 AI 编码工具。以下是各平台的安装方式：

Claude Code

官方插件市场一键安装
/plugin install superpowers@claude-plugins-official

Codex CLI / App

OpenAI 官方插件市场搜索安装
App 内侧边栏 Plugins 中找到 Superpowers

Gemini CLI

命令行扩展安装
gemini extensions install [url]

Cursor

Agent 聊天中输入
/add-plugin superpowers

OpenCode

独立的安装指引文档
需按 docs 中的步骤配置

GitHub Copilot CLI

注册 Superpowers 市场后安装
支持 marketplace 插件体系

Factory Droid

通过 droid 命令注册市场并安装插件

# 以 Claude Code 为例，最简安装方式：
/plugin install superpowers@claude-plugins-official

# 安装完成后，每次启动新会话时
# 技能会自动加载，无需任何额外操作

提示：如果你同时使用多个编码工具（如既用 Claude Code 又用 Cursor），需要分别为每个工具安装 Superpowers。

六、设计哲学

Superpowers 的四大核心原则贯穿于每一个技能的设计中：

🧪 测试优先

Test-Driven Development
始终先写测试

⚙️ 系统性

Systematic over Ad-hoc
流程优于猜测

✨ 简洁至上

Complexity Reduction
简单是首要目标

📊 证据导向

Evidence over Claims
验证后才能宣称成功

此外，Superpowers 还强调三个重要的工程原则：

• YAGNI（You Aren't Gonna Need It）— 不写不需要的代码
• DRY（Don't Repeat Yourself）— 避免重复逻辑
• 零依赖设计 — 核心功能不依赖任何第三方库

七、核心亮点与技术特色

1. 自动触发机制

通过 Hooks 系统（session-start 脚本），Superpowers 在每次新会话启动时自动加载引导指令。这意味着你不需要记住任何命令——AI 代理会在合适的时机自动调用正确的技能。

2. 两阶段代码审查

独创的子代理审查机制分为两个阶段：

• 阶段一：规格合规性审查 — 代码是否实现了计划的全部内容？
• 阶段二：代码质量审查 — 代码是否符合最佳实践？

只有通过两个阶段的审查后，才会继续推进到下一个任务。

3. 可视化头脑风暴

自 v5.0 起，Brainstorming 技能内置了可视化伴侣服务器，可以生成 HTML 格式的可视化设计图，让需求讨论更加直观高效。

4. 内联自审优化

v5.0.6 引入了内联自审机制替代子代理审查循环，大幅减少了 token 用量和执行时间，同时保持了审查质量。

5. 完整的跨平台适配

通过不同的 Hook 配置文件和 Polyglot 脚本包装器，Superpowers 完美兼容 macOS、Linux 和 Windows 平台。

6. 丰富的测试基础设施

项目包含 52 个测试文件（Shell 脚本、文本断言、Markdown 测试等），覆盖技能加载、Hook 执行、模板渲染等多个维度。

特性	说明
零依赖核心	不依赖任何第三方 npm 包，纯 Shell + Markdown 实现
技能可组合	14 个技能可独立使用，也可组合成完整流水线
可扩展	提供 writing-skills 元技能，用户可创建自定义技能
活跃迭代	从 v2.0 到 v5.1 快速演进，持续优化体验

八、总结

Superpowers 不仅是一个工具或插件，更是一套经过实战检验的AI 辅助软件工程方法论。它的价值在于：

对开发者而言：不再需要担心 AI 随意发挥，每一次编码都经过设计→计划→实现→测试→审查的完整流程。

对团队而言：标准化的工作流使得不同成员获得的 AI 辅助质量一致，代码审查有据可依。

对项目而言：TDD 保证测试覆盖率，YAGNI 防止过度工程，DRY 减少冗余代码。

如果你正在使用 AI 编码工具进行日常开发，强烈推荐尝试 Superpowers。它可能需要一点学习成本来适应新的工作流模式，但一旦上手，你会发现 AI 编码的质量和可控性会有质的飞跃。

# GitHub 地址
https://github.com/obra/superpowers

# Discord 社区
https://discord.gg/35wsABTejz

# 版本更新通知
https://primeradiant.com/superpowers/

# 作者博客
https://blog.fsck.com

本文基于 Superpowers v5.1.0 编写 | 项目采用 MIT 协议开源

原文档：github.com/obra/superpowers