# superpowers

**Repository Path**: fb4213/superpowers

## Basic Information

- **Project Name**: superpowers
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-10
- **Last Updated**: 2026-04-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Superpowers

Superpowers 是一套完整的软件开发工作流，专为你的编码代理构建，基于一组可组合的"技能"和一些初始指令，确保你的代理能够使用它们。

## 工作原理

从你启动编码代理的那一刻开始。一旦它发现你正在构建东西，它*不会*直接跳进去尝试编写代码。相反，它会退后一步，询问你真正想做什么。

一旦它通过对话提取出了规格说明，它会以足够短、易于阅读和消化的块的形式呈现给你。

在你批准设计后，你的代理会制定一个实施计划，这个计划足够清晰，以至于一个热情但品味不佳、没有判断力、没有项目背景且厌恶测试的初级工程师也能遵循。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。

接下来，一旦你说"开始"，它会启动一个*子代理驱动开发*流程，让代理完成每个工程任务，检查和审查他们的工作，然后继续前进。Claude 能够自主工作一两个小时而不偏离你制定的计划是很常见的。

还有很多其他功能，但这是系统的核心。而且因为技能会自动触发，你不需要做任何特别的事情。你的编码代理只是拥有了超能力。

## 赞助

如果 Superpowers 帮助你做了一些赚钱的事情，并且你愿意的话，我会非常感谢你考虑[赞助我的开源工作](https://github.com/sponsors/obra)。

谢谢！

- Jesse

## 安装

**注意：** 不同平台的安装方式不同。Claude Code 或 Cursor 有内置的插件市场。Codex 和 OpenCode 需要手动设置。

### Claude Code 官方市场

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

从 Claude 市场安装插件：

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

### Claude Code（通过插件市场）

在 Claude Code 中，首先注册市场：

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

然后从此市场安装插件：

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

### Cursor（通过插件市场）

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

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

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

### Codex

告诉 Codex：

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

**详细文档：** [docs/README.codex.md](docs/README.codex.md)

### 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)

### GitHub Copilot CLI

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

### Gemini CLI

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

更新：

```bash
gemini extensions update superpowers
```

### 验证安装

在你选择的平台中启动一个新会话，要求一些应该触发技能的东西（例如，"帮我规划这个功能"或"让我们调试这个问题"）。代理应该自动调用相关的 superpowers 技能。

## 基本工作流

1. **头脑风暴** - 在编写代码之前激活。通过问题完善粗略想法，探索替代方案，分段呈现设计以供验证。保存设计文档。

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

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

4. **子代理驱动开发** 或 **执行计划** - 有计划后激活。每个任务派发新的子代理，进行两阶段审查（规格合规性，然后代码质量），或以人工检查点批量执行。

5. **测试驱动开发** - 实施期间激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，看着它失败，编写最少的代码，看着它通过，提交。删除测试之前编写的代码。

6. **请求代码审查** - 任务之间激活。根据计划审查，按严重程度报告问题。关键问题会阻止进度。

7. **完成开发分支** - 任务完成时激活。验证测试，提供选项（合并/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** - 并行开发分支
- **finishing-a-development-branch** - 合并/PR 决策工作流
- **subagent-driven-development** - 两阶段审查的快速迭代（规格合规性，然后代码质量）

**元**
- **writing-skills** - 按照最佳实践创建新技能（包括测试方法论）
- **using-superpowers** - 技能系统介绍

## 理念

- **测试驱动开发** - 总是先写测试
- **系统化而非临时** - 流程优于猜测
- **复杂度降低** - 简单性作为首要目标
- **证据优于声明** - 在宣布成功之前验证

阅读更多：[Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/)

## 贡献

技能直接存放在这个仓库中。贡献方法：

1. Fork 仓库
2. 为你的技能创建分支
3. 按照 `writing-skills` 技能创建和测试新技能
4. 提交 PR

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

## 更新

更新插件时技能会自动更新：

```bash
/plugin update superpowers
```

## 许可证

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/) 获取新版本通知