阿超 > superpowers

superpowers

2026-01-15

ai

当许多人在一条路上徘徊不前时，他们不得不让开一条大路，让那珍惜时间的人赶到他们的前面去。——苏格拉底

探索 Superpowers：为您的编程代理开放无限可能

Superpowers 是一个“核心技能库”，其目标是让编程代理（如 Claude Code 或 Codex）真正拥有“超能力”。它提供了一整套可组合的“技能”和任务驱动的高效工作流，让代理从“发任务”成长为一个具备团队协作能力的小助手。

而最迷人的地方在于，这些超能力就是一套贯穿项目全生命周期的工作流，从想法的诞生，到代码的实现，再到测试和代码审查，一切都秩序井然、自动高效。如果你是一个对 AI coding agent 充满期待的开发者，Superpowers 不只是工具，它是你的“幕后工作流操盘手”。

Superpowers 的独特亮点

超能力：7 步助力全周期开发

Superpowers 彻底重塑了工作的节奏与内容。以下是基本工作流概览：

  1. 头脑风暴（brainstorming）
    在任何代码行写下之前，Superpowers 的技能会引导你梳理想法、排布需求，并生成设计文档。

  2. Git 工作树的使用
    设计定稿后，创建独立的工作树，并验证测试基线前置条件。

  3. 计划制定（writing-plans）
    明确的实现计划，将工作细分成 2~5 分钟的任务，每个任务都清晰标注文件路径、实现细节和验证步骤。

  4. 子代理驱动开发（subagent-driven-development）
    每个任务调度一个独立子代理，分阶段审核其规范合规性，然后重点检视代码质量。

  5. 测试驱动开发（test-driven-development）
    每个实现过程严格按照 RED-GREEN-REFACTOR（失败 → 编写最小值代码 → 验证通过）的测试驱动方式开展。

  6. 请求代码审查
    在任务之间请求审查，关键问题一律禁止继续前进，相当于内建了一层质量保证。

  7. 开发分支的完成与整合
    当任务完结，Superpowers 会验证所有测试通过，提示你选择“合并 / PR / 保留 / 丢弃分支”。

整个流程并非宽松指导，而是自动触发、强制执行的，确保每一步都遵循最佳实践，帮助你的代理完成真正的生产级开发。

场景看板：技能库核心

Superpowers 内置了一套精心设计的技能库，助你从问题到代码的全过程实现最大化效率：

  • 测试能力

    • 测试驱动开发：按 Red-Green-Refactor 通用方法循环改良代码
    • 测试反模式排查：避免常见错误

  • 调试能力

    • 系统化调试：四阶段根因分析（包含条件暂停策略）
    • 完成前验证：确保问题被彻底修复

  • 协作与流程

    • 头脑风暴：系统地进行设计优化与成果验证
    • 写计划：生成详尽的实现计划
    • 执行计划：分批或多线程并行任务
    • 代码审查对策：发起与接收审查都有清晰指引，包括预审核清单

快速安装指南

Claude Code 用户

Claude Code 内置了 Market 插件市场兼容模式，直接运行命令安装：

1
2
3
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/help

启动后可检查支持命令是否加载成功：

1
2
3
4
# 示例命令：
# /superpowers:brainstorm - 设计交互式优化
# /superpowers:write-plan - 实现计划生成
# /superpowers:execute-plan - 批量执行计划

Codex/Opencode：

分别到安装说明页 .codex/INSTALL.md 或 .opencode/INSTALL.md 索取指引。命令行指导：

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

Coding Agent 的“超能力养成”

一旦代理加载了 Superpowers 工作流，便能轻松切换到 Superpowers。
以下是通过 Claude Code + 实现高精度 Skill 运作确保质量背书流步骤：

测试路径 ensure附带软件效 scheme：

针对 Track-codebots：T出示任务精 Work calculation breakdown keenya：
…
再案例 …

name
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Superpowers: 为编程代理加入无缝的“超能力”协作

[Superpowers](https://github.com/obra/superpowers) 是一个专为高级编程代理（例如Claude Code、Codex等）提供高效工作流的开源插件，旨在大幅提升AI代理在整个开发生命周期中的表现。通过加载一系列灵活组合的“技能”组件，Superpowers助力你的AI代理不仅仅“码代码”，还能像一个经验丰富的软件工程师一样执行结构化的软件开发任务。

---

## 为什么需要Superpowers？

今天的编程代理已经可以在编码任务中提供巨大的帮助，但在面对复杂的、涉及多个步骤的实际项目时，它们可能表现不佳。Superpowers通过引导代理进入专业化的开发工作流，将复杂的软件开发生命周期解构为一组高效的技能，帮助代理从“单一任务工具”进化为支持复杂业务的“协作伙伴”。

Superpowers从最初的想法出发，逐步细化到设计、实现计划、任务分派、测试驱动开发和代码审查等多个阶段。其核心亮点在于流程化的任务分解和协作管理。

---

## 超能力技能包：工作流分解

Superpowers 为你的代理提供了一整套技能，涵盖从代码构思到交付的全流程：

1. **头脑风暴**
   
   - 引导设计：在开始写代码之前，代理会先通过问答和迭代，与用户一起细化设计思路。
   - 提供设计文档供你审阅并确认。

2. **使用Git工作树**
   
   - 每个开发分支会生成独立的可用工作区，并设置干净的测试环境。

3. **实现计划（writing-plans）**
   
   - 将设计文档拆分成几分钟内可完成的小任务，每个任务自带完整路径、实现代码、验证步骤。

4. **计划执行**
   
   - 通过批处理或并行方式，每个任务会分配给一个独立的子代理完成，并实施严谨的两步审查：规范合规性（spec compliance）和代码质量（code quality）。

5. **测试驱动开发**
   
   - 代理会按照“RED-GREEN-REFACTOR”循环：设计失败的测试 → 写最小化功能代码通过测试 → 重构。

6. **请求代码审查**
   
   - 代理会在每个任务完成后自动发起代码审查。关键问题会阻止流程继续，确保代码满足质量要求。

7. **分支管理**
   
   - 所有任务完成后，自动验证测试、合并工作分支、创建PR或清理无用分支。

---

## 安装与配置

### 使用Claude Code的用户

Claude Code用户可以轻松通过Marketplace安装该插件：

```bash
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/help

运行 /help 确保以下关键技能加载成功：

  • /superpowers:brainstorm: 进行设计交互和问题提炼
  • /superpowers:write-plan: 创建实现计划
  • /superpowers:execute-plan: 分解并执行计划

Codex/OpenCode用户

  • Codex用户可以通过以下命令加载：
1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

详细说明在 docs/README.codex.md

  • OpenCode安裝指南同样简单有效：
1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

基础工作流演示

以下是Superpowers的一组核心工作流，镜头见功能逐层分解分析！

  1. **从“设计优化”开始 Brainstorming 分阶段引导…