<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。  
> [English](./README.en.md) · [原始项目](https://github.com/obra/superpowers) · [上游 README](https://github.com/obra/superpowers/blob/HEAD/README.md)  
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

# Superpowers

Superpowers 是一套完整的软件开发生成方法论，专为你的编码智能体打造，构建在一组可组合的技能之上，并配有一些初始指令，确保你的智能体能善用这些技能。

## 我们正在招聘！

我们正在招聘一名全职人员，协助 Superpowers 社区和代码方面的工作。
你可以在 https://primeradiant.com/jobs/superpowers-community-engineer/ 了解岗位详情。
如果这听起来像你认识的某个人，欢迎推荐给我们。

## 快速开始

给你的智能体赋予 Superpowers：[Claude Code](#claude-code)、[Antigravity](#antigravity)、[Codex App](#codex-app)、[Codex CLI](#codex-cli)、[Cursor](#cursor)、[Factory Droid](#factory-droid)、[GitHub Copilot CLI](#github-copilot-cli)、[Kimi Code](#kimi-code)、[OpenCode](#opencode)、[Pi](#pi)。

## 工作原理

从你启动编码智能体的那一刻开始。一旦它发现你正在构建某个东西，它*不会*直接跳入写代码。相反，它会退一步，问你真正想做什么。

当它从对话中梳理出一份规格说明后，会以足够短、让你真正能阅读和消化的片段展示给你。

在你确认设计方案后，智能体会制定一份实现计划——这份计划清晰到即使是一位热情但品味不佳、缺乏判断力、没有项目背景、且讨厌测试的初级工程师也能照着执行。它强调真正的红/绿 TDD、YAGNI（You Aren't Gonna Need It，你不需要它）和 DRY。

接下来，一旦你说"开始"，它会启动一个*子智能体驱动开发*流程，让智能体逐一处理每个工程任务，检查并审查它们的工作，然后继续推进。你的智能体自主工作两三个小时而不偏离你共同制定的计划，这并不罕见。

还有很多其他内容，但以上是这套系统的核心。而且由于技能是自动触发的，你不需要做任何特殊操作。你的编码智能体就这样拥有了 Superpowers。

## 商业服务

如果你在企业中使用 Superpowers，并希望获得商业支持、额外工具或托管预算方面的帮助，请随时联系我们：sales@primeradiant.com。

## 安装

不同平台的安装方式有所不同。如果你使用多个平台，请为每个平台分别安装 Superpowers。

### Claude Code

Superpowers 可通过[官方 Claude 插件市场](https://claude.com/plugins/superpowers)获取

#### 官方市场

- 从 Anthropic 官方市场安装插件：

  ```bash
  /plugin install superpowers@claude-plugins-official
  ```

#### Superpowers 市场

Superpowers 市场提供 Superpowers 及其他一些相关插件，适用于 Claude Code。

- 注册市场：

  ```bash
  /plugin marketplace add obra/superpowers-marketplace
  ```

- 从该市场安装插件：

  ```bash
  /plugin install superpowers@superpowers-marketplace
  ```

### Antigravity

以插件形式从此仓库安装 Superpowers：

```bash
agy plugin install https://github.com/obra/superpowers
```

Antigravity 会运行插件的会话启动钩子，因此 Superpowers 从第一条消息起就处于激活状态。
使用同样的命令重新安装即可更新。

### Codex App

Superpowers 可通过[官方 Codex 插件市场](https://github.com/openai/plugins)获取。

- 在 Codex 应用中，点击侧边栏的 Plugins。
- 你应该会在 Coding 部分看到 `Superpowers`。
- 点击 Superpowers 旁边的 `+`，按提示操作即可。

### Codex CLI

Superpowers 可通过[官方 Codex 插件市场](https://github.com/openai/plugins)获取。

- 打开插件搜索界面：

  ```bash
  /plugins
  ```

- 搜索 Superpowers：

  ```bash
  superpowers
  ```

- 选择 `Install Plugin`。

### Cursor

- 在 Cursor Agent 聊天中，从市场安装：

  ```text
  /add-plugin superpowers
  ```

- 或者在插件市场中搜索 "superpowers"。

### Factory Droid

- 注册市场：

  ```bash
  droid plugin marketplace add https://github.com/obra/superpowers
  ```

- 安装插件：

  ```bash
  droid plugin install superpowers@superpowers
  ```

### GitHub Copilot CLI

- 注册市场：

  ```bash
  copilot plugin marketplace add obra/superpowers-marketplace
  ```

- 安装插件：

  ```bash
  copilot plugin install superpowers@superpowers-marketplace
  ```

### Kimi Code

Superpowers 可在 Kimi Code 的插件市场中获取。

- 打开 Kimi Code 的插件管理器：

  ```text
  /plugins
  ```

- 进入 `Marketplace` > `Superpowers` 并安装。

- 或者直接从本仓库安装：

  ```text
  /plugins install https://github.com/obra/superpowers
  ```

- 详细文档：[docs/README.kimi.md](docs/README.kimi.md)

### OpenCode

OpenCode 使用自己的插件安装方式；即使你在其他平台已经使用 Superpowers，也需要单独安装。

- 告诉 OpenCode：

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

- 详细文档：[docs/README.opencode.md](docs/README.opencode.md)

### Pi

以 Pi 包的形式从此仓库安装 Superpowers：

```bash
pi install git:github.com/obra/superpowers
```

用于本地开发时，使用此签出版本作为临时包运行 Pi：

```bash
pi -e /path/to/superpowers
```

Pi 包加载 Superpowers 技能以及一个小型扩展，该扩展会在会话启动时和压缩后注入 `using-superpowers` 引导程序。Pi 拥有原生技能，因此不需要兼容性的 `Skill` 工具。子智能体和任务列表工具仍然是可选的 Pi 配套包。

## 基本工作流

1. **brainstorming（头脑风暴）** - 在写代码前激活。通过提问来完善粗糙的想法，探索替代方案，分块展示设计以供验证。保存设计文档。

2. **using-git-worktrees（使用 Git 工作树）** - 在设计批准后激活。在新分支上创建隔离的工作空间，运行项目初始化，验证干净的测试基线。

3. **writing-plans（编写计划）** - 在设计批准后激活。将工作分解为小块任务（每个 2–5 分钟）。每个任务都有确切的文件路径、完整代码和验证步骤。

4. **subagent-driven-development（子智能体驱动开发）或 executing-plans（执行计划）** - 在有计划后激活。为每个任务分派全新的子智能体，进行两阶段审查（先检查规格合规性，再检查代码质量）；或批量执行并设置人工检查点。

5. **test-driven-development（测试驱动开发）** - 在实现过程中激活。强制 RED-GREEN-REFACTOR 循环：编写会失败的测试，观察它失败，编写最小代码，观察它通过，然后提交。删除在测试之前编写的代码。

6. **requesting-code-review（请求代码审查）** - 在任务之间激活。对照计划进行审查，按严重程度报告问题。关键问题会阻塞进度。

7. **finishing-a-development-branch（完成开发分支）** - 在任务完成后激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。

**智能体在任何任务之前都会检查相关技能。** 这是强制性工作流，而非建议。

## 内部包含

### 技能库

**测试**
- **test-driven-development（测试驱动开发）** - RED-GREEN-REFACTOR 循环（包含反模式参考）

**调试**
- **systematic-debugging（系统化调试）** - 4 阶段根因定位流程（包含根因追踪、纵深防御、条件等待等技术）
- **verification-before-completion（完成前验证）** - 确保问题确实已修复

**协作**
- **brainstorming（头脑风暴）** - 苏格拉底式设计打磨
- **writing-plans（编写计划）** - 详细的实现计划
- **executing-plans（执行计划）** - 带检查点的批量执行
- **dispatching-parallel-agents（分派并行智能体）** - 并发子智能体工作流
- **requesting-code-review（请求代码审查）** - 审查前检查清单
- **receiving-code-review（接收代码审查）** - 回应反馈
- **using-git-worktrees（使用 Git 工作树）** - 并行开发分支
- **finishing-a-development-branch（完成开发分支）** - 合并/PR 决策工作流
- **subagent-driven-development（子智能体驱动开发）** - 带两阶段审查的快速迭代（先检查规格合规性，再检查代码质量）

**元技能**
- **writing-skills（编写技能）** - 遵循最佳实践创建新技能（包含测试方法）
- **using-superpowers（使用 Superpowers）** - 技能系统介绍

## 哲学理念

- **测试驱动开发** - 始终先写测试
- **系统化优于临时应对** - 流程优于猜测
- **降低复杂性** - 以简洁为首要目标
- **用证据说话** - 验证后再宣布成功

阅读[原始发布公告](https://blog.fsck.com/2025/10/09/superpowers/)。

## 贡献

以下是 Superpowers 的一般贡献流程。请注意，我们通常不接受新技能的贡献，且任何对已有技能的更新必须在我们支持的所有编码智能体上都能正常工作。

1. Fork 本仓库
2. 切换到 `dev` 分支
3. 为你自己的工作创建一个分支
4. 遵循 `writing-skills` 技能来创建和测试新的或修改后的技能
5. 提交 PR，并务必填写 PR 模板。

技能行为测试使用来自 [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/) 的 drill eval 测试框架，克隆到 `evals/` 目录下——配置方法见 `evals/README.md`。插件基础设施测试位于 `tests/` 目录，通过相应的 `run-*.sh` 或 `npm test` 运行。

完整指南请参见 `skills/writing-skills/SKILL.md`。

## 更新

Superpowers 的更新方式在一定程度上取决于编码智能体，但通常是自动的。

## 许可证

MIT 许可证——详情见 LICENSE 文件

## 可视化伴侣遥测

由于技能和插件不会向创作者提供任何反馈，我们不知道有多少人在使用 Superpowers。默认情况下，brainstorming 的可选可视化伴侣功能中的 Prime Radiant 标志会从我们的网站加载。其中包含正在使用的 Superpowers 版本。它不包含有关你的项目、提示或编码智能体的任何细节。我们无法看到你的点击操作或你正在构建的任何内容。这有助于我们大致了解有多少人在使用 Superpowers 以及他们正在使用哪个版本。这是完全可选的。要禁用此功能，请将环境变量 `SUPERPOWERS_DISABLE_TELEMETRY` 设置为任何真值。Superpowers 也会遵守 Claude Code 的 `DISABLE_TELEMETRY` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 退出机制。

## 社区

Superpowers 由 [Jesse Vincent](https://blog.fsck.com) 和 [Prime Radiant](https://primeradiant.com) 的其他成员构建。

- **Discord**：[加入我们](https://discord.gg/35wsABTejz) 获取社区支持、提问，以及分享你用 Superpowers 构建的内容
- **Issues**：https://github.com/obra/superpowers/issues
- **发布公告**：[注册](https://primeradiant.com/superpowers/) 获取新版本通知
USD 预算：$0/$3；剩余 $3（分配：$250/月 + $250 启动池，已使用：$0/$497）
剩余预算：$3（试用池：$3）