# superpowers

**Repository Path**: goodsccd/superpowers

## Basic Information

- **Project Name**: superpowers
- **Description**: An agentic skills framework & software development methodology that works.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AI大模型

## README

# Superpowers（超级能力）

Superpowers 是一套面向编码 Agent 的完整软件开发方法论，构建在一组可组合的技能（skills）以及一些初始指令之上，确保你的 Agent 真正会用上这些技能。

## 快速开始

为你的 Agent 装上 Superpowers：[Claude Code](#claude-code)、[Codex CLI](#codex-cli)、[Codex App](#codex-app)、[Factory Droid](#factory-droid)、[Gemini CLI](#gemini-cli)、[OpenCode](#opencode)、[Cursor](#cursor)、[GitHub Copilot CLI](#github-copilot-cli)。

## 工作原理

它从你启动编码 Agent 的那一刻就开始发挥作用。一旦发现你要构建某个东西，它*不会*立刻动手写代码，而是先退一步，问你到底想做什么。

在通过对话梳理出一份规格说明后，它会把这些设计分成一小段一小段地展示给你，让你能真正读得过来、消化得了。

在你确认设计之后，Agent 会制定出一份实现计划，清晰到连一个热情有余、品味堪忧、毫无判断力、完全不了解项目背景还特别不爱写测试的初级工程师都能照着做。它强调真正的红/绿 TDD（测试驱动开发）、YAGNI（你不会需要它）和 DRY（不要重复自己）。

接下来，只要你说一声「开始」，它就会启动一个*子 Agent 驱动的开发*（subagent-driven-development）流程：让各个 Agent 逐一完成每项工程任务，对它们的工作进行检查和评审，然后继续推进。Claude 经常能在不偏离既定计划的情况下连续自主工作好几个小时。

里面还有很多其他内容，但以上就是这个系统的核心。而且由于这些技能会自动触发，你不需要做任何特殊操作——你的编码 Agent 自然就拥有了 Superpowers。

## 赞助

如果 Superpowers 帮你做出了能赚钱的东西，而你又愿意的话，非常欢迎考虑[赞助我的开源工作](https://github.com/sponsors/obra)。

感谢！

- Jesse

## 安装

安装方式因 harness（运行环境）而异。如果你同时使用多个，需要分别单独安装 Superpowers。

### Claude Code

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

#### 官方市场

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

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

#### Superpowers 市场

Superpowers 市场为 Claude Code 提供 Superpowers 及一些其他相关插件。

- 注册市场：

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

- 从该市场安装插件：

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

### Codex CLI

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

- 打开插件搜索界面：

  ```bash
  /plugins
  ```

- 搜索 Superpowers：

  ```bash
  superpowers
  ```

- 选择 `Install Plugin`。

### Codex App

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

- 在 Codex 应用中，点击侧边栏的 Plugins。
- 你应该能在 Coding 区看到 `Superpowers`。
- 点击 Superpowers 旁边的 `+`，按提示完成安装。

### Factory Droid

- 注册市场：

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

- 安装插件：

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

### Gemini CLI

- 安装扩展：

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

- 日后更新：

  ```bash
  gemini extensions update superpowers
  ```

### OpenCode

OpenCode 使用自己的插件安装机制；即使你已经在别的 harness 中用过 Superpowers，也需要在 OpenCode 中单独安装一次。

- 告诉 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)

### Cursor

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

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

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

### GitHub Copilot CLI

- 注册市场：

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

- 安装插件：

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

## 基本工作流

1. **brainstorming（头脑风暴）** —— 在写代码前激活。通过提问打磨粗略想法，探索备选方案，分节展示设计供确认。保存设计文档。

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

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

4. **subagent-driven-development（子 Agent 驱动开发）** 或 **executing-plans（执行计划）** —— 在有计划时激活。为每个任务派发全新的子 Agent，并执行两阶段评审（先看是否符合规格，再看代码质量）；或者带人工检查点地分批执行。

5. **test-driven-development（测试驱动开发）** —— 在实现阶段激活。强制执行 RED-GREEN-REFACTOR（红-绿-重构）：先写会失败的测试，看它失败，写最少量的代码让它通过，看它通过，然后提交。若先于测试写了代码则会被删除。

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

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

**Agent 在执行任何任务前都会先检查相关技能。** 这是强制的工作流，而非建议。

## 内部内容

### 技能库

**测试**
- **test-driven-development** —— RED-GREEN-REFACTOR 循环（含测试反模式参考）

**调试**
- **systematic-debugging** —— 4 阶段根因分析流程（含根因追踪、纵深防御、条件等待等技术）
- **verification-before-completion** —— 确保它确实被修复了

**协作**
- **brainstorming** —— 苏格拉底式设计打磨
- **writing-plans** —— 详细的实现计划
- **executing-plans** —— 带检查点的分批执行
- **dispatching-parallel-agents** —— 并发子 Agent 工作流
- **requesting-code-review** —— 评审前的检查清单
- **receiving-code-review** —— 如何回应反馈
- **using-git-worktrees** —— 并行开发分支
- **finishing-a-development-branch** —— 合并 / 提 PR 决策工作流
- **subagent-driven-development** —— 带两阶段评审（先看规格符合度，再看代码质量）的快速迭代

**元技能**
- **writing-skills** —— 按最佳实践创建新技能（含测试方法论）
- **using-superpowers** —— 技能系统入门

## 理念

- **测试驱动开发** —— 永远先写测试
- **系统化优于临时应对** —— 流程优先于猜测
- **降低复杂度** —— 以简洁为首要目标
- **证据优于断言** —— 宣布成功前先验证

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

## 贡献

下面是 Superpowers 的一般贡献流程。请注意，我们通常**不**接受新增技能的贡献，且对技能的任何修改都必须在我们支持的所有编码 Agent 上正常运行。

1. Fork 本仓库
2. 切换到 `dev` 分支
3. 为你的工作创建一个分支
4. 按照 `writing-skills` 技能来创建和测试新增及修改的技能
5. 提交 PR，务必填写完整 pull request 模板

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

## 更新

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

## 许可证

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

## 社区

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/) 以便在新版本发布时收到通知