# superpowers

**Repository Path**: modificial/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**: 1
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Superpowers

Superpowers 是一套面向编程智能体的完整软件开发工作流，建立在一组可组合的“技能”和一段确保智能体会使用这些技能的初始指令之上。

## 工作原理

它从你启动编程智能体的那一刻就开始生效。一旦智能体发现你要构建某个东西，它*不会*立刻跳进代码实现，而是先退一步，弄清楚你真正想解决的问题是什么。

当它从对话里梳理出一份规格后，会按足够短的小节展示给你，确保你真的能读完并消化。

在你确认设计之后，智能体会整理出一份实现计划，清晰到即使是一个热情但审美堪忧、判断力一般、不了解项目上下文、还不爱写测试的初级工程师，也能照着做。它强调真正的红绿 TDD、YAGNI（You Aren't Gonna Need It）和 DRY。

接着，当你说“开始”后，它会启动 *subagent-driven-development* 流程，让多个智能体逐项完成工程任务、检查和审查结果，并持续向前推进。Claude 连续数小时自主工作且不偏离既定计划，并不罕见。

系统里还有很多细节，但核心就是这些。由于技能会自动触发，你不需要做额外操作。你的编程智能体天然就拥有 Superpowers。

## 赞助

如果 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)

### Gemini CLI

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

更新：

```bash
gemini extensions update superpowers
```

### 验证安装

在你选择的平台中开启一个新会话，然后提一个本应触发技能的请求（例如“帮我规划这个功能”或“我们来调试这个问题”）。智能体应当会自动调用相关的 superpowers 技能。

## 基础工作流

1. **brainstorming** - 在写代码前触发。通过提问打磨粗略想法、探索备选方案、按章节展示设计供你确认，并保存设计文档。

2. **using-git-worktrees** - 在设计获批后触发。为新分支创建隔离工作空间，运行项目初始化，并验证测试基线是干净的。

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** - 四阶段根因分析流程（包含 root-cause-tracing、defense-in-depth、condition-based-waiting 技术）
- **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，详见 LICENSE 文件。

## 社区

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

如果你想获得社区支持、提问，或分享你正在构建的内容，欢迎加入我们的 [Discord](https://discord.gg/Jd8Vphy9jq)。

## 支持

- **Discord**: [加入 Discord](https://discord.gg/Jd8Vphy9jq)
- **Issues**: https://github.com/obra/superpowers/issues
- **Marketplace**: https://github.com/obra/superpowers-marketplace