在没有使用这套 Skills 之前，我使用 Claude Code 处理问题时，任务往往很快就草草结束：它不会主动发散思考，也很少把复杂问题拆成明确步骤，整体体验比较机械。尝试 Superpowers 之后，工作方式有了明显变化。这个项目在 GitHub 上也获得了大量关注，下面就来看看它具体做了什么。
概述
Superpowers（超能力）是由 Jesse Vincent 和 Prime Radiant 团队开发的一套完整的软件开发生命周期方法论，以 Claude Code 插件（Plugin）的形式提供。它不是某个单一功能，而是一套可组合的 Skills（技能）体系，从根本上改变了 AI 编程助手的工作方式——从“你说一句我写一段”的被动应答，转变为有流程、有纪律、可自主执行数小时的工程伙伴。
截至本文整理时，当前版本为 v5.1.0（2026-04-30 发布） 许可证：MIT 仓库地址：https://github.com/obra/superpowers Discord 社区：https://discord.gg/35wsABTejz
核心理念
Superpowers 建立在以下几条哲学基石上：
| 原则 | 含义 |
|---|---|
| 测试驱动开发（TDD） | 先写测试，再写代码，永远是第一位的 |
| 系统性优于随意性 | 用流程替代猜测，用纪律替代直觉 |
| 复杂度消减 | 简单性是首要目标，YAGNI（你不会需要它）要无情执行 |
| 证据先于断言 | 在声称完成之前，必须先运行验证命令并看到输出 |
这些理念贯穿所有技能，每一个技能都有铁的纪律（Iron Law）和红旗警告（Red Flags），防止 AI 走捷径。
核心工作流
Superpowers 定义了一条端到端的开发流水线，Agent 在开始任何任务前会自动检查是否有相关的技能需要激活：
这条工作流可以概括为：
- 从需求或想法出发，先通过 Brainstorming 完成头脑风暴和设计
- 使用 Writing Plans 把设计拆解为可执行的实施计划
- 通过 Git Worktrees 建立隔离的工作空间
- 使用 Subagent-Driven Development 执行任务
- 在实现过程中持续进行 TDD 循环和代码审查
- 验证全部结果后，由 Finishing a Development Branch 完成分支收尾
1. Brainstorming（头脑风暴）
触发时机： 任何创造性工作之前——创建功能、构建组件、添加功能、修改行为。
做了什么：
- 先探索项目上下文（文件、文档、最近提交）
- 如果涉及视觉设计，提供浏览器端可视化伴侬展示原型图/对比图
- 一次只问一个问题，逐步提炼需求
- 提出 2-3 种方案，给出推荐及理由
- 按模块呈现设计，每部分都获得用户确认
- 编写设计文档到
docs/superpowers/specs/并提交 - 进行规范自审（占位符检查、内部一致性、范围检查、歧义检查）
- 用户审核通过后，自动进入 Writing Plans
硬性门禁： 在呈现设计并获得用户批准之前，不允许调用任何实现技能、编写任何代码或搭建任何项目。
2. Writing Plans（编写计划）
触发时机： 拥有已批准的设计文档后，编写代码之前。
做了什么：
- 将设计拆解为一口大小的任务（每个 2-5 分钟）
- 每个任务包含：精确文件路径、完整代码、验证命令与预期输出
- 禁止使用任何占位符（TBD、TODO、“稍后实现”、类似引用等）
- 严格遵守 DRY、YAGNI、TDD 原则
- 编写后进行自我审查：规范覆盖度、占位符扫描、类型一致性
- 提供两种执行选项：推荐子代理驱动 / 内联执行
3. Using Git Worktrees（使用 Git 工作树）
触发时机： 开始实现之前，需要隔离工作空间时。
做了什么：
- 检测是否已在隔离工作空间中
- 优先使用平台的本地工作树工具（如
EnterWorktree） - 回退到
git worktree add - 自动运行项目设置（npm install / cargo build / pip install 等）
- 验证测试基线（确保工作空间从干净状态开始）
4. Subagent-Driven Development（子代理驱动开发，核心亮点）
触发时机： 拥有实施计划后，需要执行任务时。
这是 Superpowers 最强大的技能。它不是让 AI 自己一步步完成所有事，而是：
为每个任务派发全新的子代理 + 两阶段审查 = 高质量、快速迭代每个任务的流程：
- 派发实现者子代理 → 实现、测试、提交、自我审查
- 派发规范合规审查者子代理 → 检查代码是否严格匹配规范（防止过度构建或遗漏需求）
- 派发代码质量审查者子代理 → 检查代码质量、测试覆盖、可维护性
- 如果有问题 → 实现者修复 → 审查者重新审查 → 循环直到通过
这种架构让 Claude 能够自主工作数小时而不偏离计划。
5. Test-Driven Development（测试驱动开发）
触发时机： 任何功能实现或 Bug 修复。
铁的纪律：
没有失败的测试在先，就没有生产代码RED → GREEN → REFACTOR 循环：
- RED： 先写一个失败测试，验证它确实失败
- GREEN： 写最少代码让它通过
- REFACTOR： 在测试保持绿色的前提下重构
如果代码已经写在测试前面？删掉，重来。
6. Requesting Code Review（请求代码审查）
触发时机： 任务之间，自动进行。
做了什么：
- 根据计划审查实现
- 按严重程度报告问题（Critical / Important / Minor）
- 严重问题阻塞进度，必须修复后才能继续
7. Finishing a Development Branch（完成开发分支）
触发时机： 所有任务完成，测试通过后。
提供的选项：
- 合并回主分支（本地）
- 推送并创建 Pull Request
- 保留分支（稍后处理）
- 放弃此工作
会根据当前工作空间状态（正常仓库 / 工作树 / detached HEAD）动态调整选项。
其他重要技能
Systematic Debugging（系统化调试）
触发时机： 遇到任何 Bug、测试失败或意外行为时。
四阶段流程：
- 根因调查 — 仔细阅读错误信息、可靠重现、检查最近变更、追踪数据流
- 模式分析 — 找到工作示例、与参考实现对比、找差异
- 假设与测试 — 每次只做一个最小改动来验证假设
- 实施修复 — 先写失败测试、单次修复、验证通过
铁律： 没有根因调查，就不允许提修复方案。
Verification Before Completion（完成前验证）
触发时机： 即将声称工作完成时。
铁律：
没有新的验证证据，就不允许声称完成门控函数： 识别验证命令 → 执行完整命令 → 读取完整输出 → 验证结果 → 然后才能声称完成。
Receiving Code Review（接收代码审查反馈）
触发时机： 收到代码审查反馈后，实施建议之前。
强调技术严谨和验证，而非表面的赞同。
Dispatching Parallel Agents（派发并行代理）
触发时机： 面对 2 个以上没有共享状态或顺序依赖的独立任务时。
允许同时派发多个子代理处理不同的独立任务。
Executing Plans（执行计划）
触发时机： 有书面的实施计划，需要在单独会话中执行时。
提供审查检查点，以批处理方式执行计划。
Writing Skills（编写技能）
触发时机： 创建新技能、编辑现有技能或验证技能能否正常工作时。
包含完整的测试方法论和最佳实践指南。
支持平台
Superpowers 是一个跨平台插件，支持多种 AI 编码工具：
| 平台 | 安装方式 |
|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official（官方市场）或 /plugin install superpowers@superpowers-marketplace（Superpowers 市场） |
| Codex CLI | /plugins → 搜索 superpowers → Install Plugin |
| Codex App | 侧边栏 Plugins → Coding 区域 → 点击 + |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| OpenCode | 向 OpenCode 发送指令安装 |
| Cursor | /add-plugin superpowers |
| GitHub Copilot CLI | copilot plugin install superpowers@superpowers-marketplace |
| Factory Droid | droid plugin install superpowers@superpowers |
如何安装（以 Claude Code 为例）
方式一：官方市场（推荐）
# 从 Anthropic 官方市场安装
/plugin install superpowers@claude-plugins-official方式二：Superpowers 市场
# 注册市场
/plugin marketplace add obra/superpowers-marketplace
# 安装插件
/plugin install superpowers@superpowers-marketplace安装后不需要任何配置——技能会在会话启动时自动加载。
如何使用
Superpowers 的美妙之处在于：你不需要手动调用任何技能。 只需像平常一样使用 Claude Code 即可，技能会自动触发：
| 你说 | 自动触发 |
|---|---|
| “帮我做一个 React 待办列表” | Brainstorming |
| “修复这个 Bug” | Systematic Debugging + TDD |
| “实现这个功能” | Writing Plans → 执行选项 |
| “给这段代码加个功能” | Brainstorming → 完整流程 |
技能之间通过流程图的硬性门禁（Hard Gate） 串联，确保不会跳过任何步骤。例如，Brainstorming 的唯一合法出口是调用 Writing Plans，而 Writing Plans 完成后会提供执行选项。
设计哲学与特点
1. 强制性工作流（Mandatory Workflows）
技能不是建议，而是必须遵循的流程。每个技能都包含：
- 流程图（Graphviz DOT）：可视化的执行路径
- 检查清单（Checklist）：必须逐项完成
- 红旗警示（Red Flags）：常见作弊/走捷径的模式
- 理性化预防（Rationalization Prevention）：AI 最常见的借口及其反驳
2. 子代理架构
这是 Superpowers 区别于其他 AI 插件的最重要特性：
- 每个任务都有全新的上下文环境（Fresh Context）
- 两阶段审查确保规范合规 + 代码质量
- 实现者可以在开始前和进行中提问
- 控制器（Controller）精确筛选子代理需要的上下文，避免上下文窗口污染
3. 指令优先级
1. 用户的明确指令（CLAUDE.md、AGENTS.md）— 最高优先级
2. Superpowers 技能 — 覆盖默认系统行为
3. 默认系统提示 — 最低优先级如果 CLAUDE.md 说“不要用 TDD”，即使技能说“总是用 TDD”，也遵循用户的指令。
4. 证据驱动（Evidence-Driven）
- 完成前必须先验证（Verification Before Completion）
- 修复前必须先找根因（Systematic Debugging）
- 编码前必须先写测试（TDD）
- 所有成功声明都必须有新鲜验证输出作为证据
版本历史亮点
| 版本 | 主要变化 |
|---|---|
| v5.1.0 | 移除废弃命令；工作树技能重写；代码审查整合；多平台改进 |
| v5.0.0 | 可视化头脑风暴伴侬；文档审查系统；子代理驱动开发强制化；指令优先级体系 |
| v4.3.0 | 头脑风暴工作流强制化（硬性门禁 + 检查清单） |
| v4.0.0 | 两阶段代码审查；系统化调试技术整合；DOT 流程图作为可执行规范 |
| v3.0.0 | 迁移到 Anthropic 官方技能系统 |
社区与贡献
- Discord： https://discord.gg/35wsABTejz
- Issues： https://github.com/obra/superpowers/issues
- 发布通知： https://primeradiant.com/superpowers/
- 赞助： https://github.com/sponsors/obra
注意：Superpowers 项目不接受大多数外部贡献的 PR。仓库有着 94% 的 PR 拒率，主要因为 AI 生成的“垃圾 PR”过多。如果你确实想贡献，请仔细阅读
CLAUDE.md和 PR 模板。
总结
Superpowers 不仅仅是一个 Claude Code 插件，它是一个完整软件的开发的 AI 方法论。它将 AI 编码助手从“被动的代码生成器”转变为“自主的开发伙伴”，通过：
- 设计先于编码 — Brainstorming 确保方向正确
- 计划先于执行 — Writing Plans 确保每一步都可验证
- 隔离的工作空间 — Worktrees 保护主分支
- 子代理驱动 — 并行化 + 两阶段审查确保质量
- TDD 纪律 — 测试先行消灭回归
- 验证先于声称 — 证据驱动的完成标准
对于认真使用 AI 辅助编程的开发者来说，Superpowers 是目前最成熟、最系统化的工具链。它让你从不断“喂提示”的保姆模式中解放出来，真正让 AI 成为一个可以自主工作数小时的工程伙伴。