# Claude Code Superpowers 研究

> AI 编程的方法论框架 —— 让 AI 真正会干活
>
> 归档：2026-04-23

---

## 📊 项目概览

| 项目 | Stars | 定位 |
|------|-------|------|
| **obra/superpowers** | ⭐ 159k+ | 英文上游（方法论内核） |
| **jnMetaCode/superpowers-zh** | ⭐ 1,331 | 中文增强版（17 款工具） |
| **obra/superpowers-marketplace** | ⭐ 876 | 插件市场 |
| **obra/superpowers-skills** | ⭐ 623 | 社区 Skills |

**作者**：Jesse Vincent (Prime Radiant)

---

## 🎯 核心定位

**Superpowers 不是工具，而是一种方法论。**

它让 AI 编程工具从"直接写代码"变成"先想清楚再做"：

```
没装：你：加个批量导出 → AI：直接写代码 → 各种返工
装了：你：加个批量导出 → AI：先问需求 → 设计方案 → 确认 → 再做
```

---

## 🔄 核心工作流

### 完整开发流程

```
1. 头脑风暴 → 2. 编写计划 → 3. Git Worktree
     ↓              ↓              ↓
4. 子Agent开发 → 5. 代码审查 → 6. 完成分支
     ↓              ↓              ↓
  TDD 实现     质量把关      合并/PR
```

### 自动化触发

每个 Skill 在特定阶段**自动激活**，不需要手动调用：

| 阶段 | 自动触发的 Skill |
|------|-----------------|
| 开始编码前 | `brainstorming`（头脑风暴） |
| 设计确认后 | `writing-plans`（编写计划） |
| 计划完成后 | `using-git-worktrees` + `subagent-driven-development` |
| 实现过程中 | `test-driven-development` |
| 任务间切换 | `requesting-code-review` |
| 任务完成 | `finishing-a-development-branch` |

---

## 📦 Skills 详解（14 个核心）

### 开发流程类

| Skill | 用途 |
|-------|------|
| **brainstorming** | 苏格拉底式需求分析，确认后再动手 |
| **writing-plans** | 把需求拆成 2-5 分钟的小任务 |
| **executing-plans** | 按计划执行，每步验证 |
| **subagent-driven-development** | 每个任务一个子 Agent + 两轮审查 |
| **dispatching-parallel-agents** | 多任务并行 |

### 代码质量类

| Skill | 用途 |
|-------|------|
| **test-driven-development** | 严格 RED-GREEN-REFACTOR |
| **systematic-debugging** | 四阶段调试：定位→分析→假设→修复 |
| **requesting-code-review** | 自动代码审查 |
| **receiving-code-review** | 严谨处理审查反馈 |
| **verification-before-completion** | 声称完成前必须跑验证 |

### Git 工作流类

| Skill | 用途 |
|-------|------|
| **using-git-worktrees** | 隔离开发 |
| **finishing-a-development-branch** | 合并/PR/保留/丢弃四选一 |

### 元技能类

| Skill | 用途 |
|-------|------|
| **writing-skills** | 创建新 Skill 的方法论 |
| **using-superpowers** | 如何调用和优先使用 |

---

## 🇨🇳 中文增强版（6 个原创）

| Skill | 用途 |
|-------|------|
| **chinese-code-review** | 适配国内团队文化的代码审查 |
| **chinese-git-workflow** | Gitee/Coding/极狐 GitLab 支持 |
| **chinese-documentation** | 中文排版 + 中英混排 + 告别机翻味 |
| **chinese-commit-conventions** | 国内团队 Commit 规范 |
| **mcp-builder** | 构建生产级 MCP 工具 |
| **workflow-runner** | 多角色 YAML 工作流执行器 |

---

## 🚀 安装方式

### Claude Code（官方市场）

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

### 第三方市场

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

### 中文增强版（一键安装）

```bash
cd /your/project
npx superpowers-zh
```

自动检测项目中的 AI 工具并安装到正确位置。

---

## 🤖 支持的工具（17 款）

| 工具 | 类型 |
|------|------|
| **Claude Code** | CLI |
| **Cursor** | IDE |
| **Codex CLI** | CLI |
| **Hermes Agent** | CLI |
| **Windsurf** | IDE |
| **Kiro** | IDE |
| **Gemini CLI** | CLI |
| **Aider** | CLI |
| **Trae** | IDE |
| **OpenClaw** | CLI |
| **Qwen Code（通义灵码）** | IDE |
| **VS Code (Copilot)** | IDE |
| **DeerFlow 2.0** | Agent 框架 |
| **OpenCode** | CLI |
| **Antigravity** | CLI |
| **Claw Code** | CLI (Rust) |
| **Copilot CLI** | CLI |

---

## 💡 核心原则

| 原则 | 说明 |
|------|------|
| **TDD 优先** | 先写测试，再写代码 |
| **系统化** | 流程胜于猜测 |
| **简化复杂度** | 简化是首要目标 |
| **证据胜于言辞** | 验证后才说成功 |

---

## 📋 典型使用场景

### 场景 1：新功能开发

```
1. brainstorming → 确认需求
2. writing-plans → 拆分任务
3. subagent-driven-development → 逐步实现
4. requesting-code-review → 质量保证
5. finishing-a-development-branch → 合并
```

### 场景 2：Bug 修复

```
1. systematic-debugging → 定位根因
2. writing-plans → 制定修复计划
3. test-driven-development → 先写失败测试
4. verification-before-completion → 验证修复
```

### 场景 3：大型重构

```
1. using-git-worktrees → 隔离开发
2. dispatching-parallel-agents → 并行执行
3. requesting-code-review → 逐步审查
```

---

## 🔌 插件市场

### 可用插件

| 插件 | 用途 |
|------|------|
| **superpowers** | 核心 Skills 库（20+ 技能） |
| **elements-of-style** | 写作指南（Strunk 风格） |
| **developing-for-claude-code** | 插件开发指南 |
| **private-journal-mcp** | 私有日记 MCP |

### 安装插件市场

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

---

## 📊 对比其他方案

| 方案 | Stars | 类型 | 特点 |
|------|-------|------|------|
| **superpowers** | 159k | 方法论 | 系统化工作流 |
| **claude-code-best-practice** | 47k | 参考文档 | 命令/配置详解 |
| **ClaudeForge** | 353 | 工具 | CLAUDE.md 自动生成 |

---

## 🔗 资源

| 资源 | 链接 |
|------|------|
| 英文版 | https://github.com/obra/superpowers |
| 中文版 | https://github.com/jnMetaCode/superpowers-zh |
| 插件市场 | https://github.com/obra/superpowers-marketplace |
| 博客 | https://blog.fsck.com/2025/10/09/superpowers/ |
| Discord | https://discord.gg/35wsABTejz |

---

## AI工程索引

相关笔记：
- [[INDEX_AI工程]] - AI工程知识索引
- [[ClaudeCode完全研究]] - Claude Code 完整指南
- [[ClaudeCode使用技巧与最佳实践]] - 使用技巧

---

*整理：知识库管理员 | 归档：2026-04-23*