# superpowers-cn

**Repository Path**: fangjunjie/superpowers-cn

## Basic Information

- **Project Name**: superpowers-cn
- **Description**: superpowers 中文版
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-05

## 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（通过插件市场）

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

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

然后从此市场安装插件：

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

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

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

```text
/plugin-add 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)

### 验证安装

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

## 基本工作流

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 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 文件

## 支持

- **问题**: https://github.com/obra/superpowers/issues
- **市场**: https://github.com/obra/superpowers-marketplace