系列导航：
- 开篇 · 2026 如何养好 Claude Code（开篇）：从养龙虾到养 Claude Code
- 第零篇 · 2026 如何养好 Claude Code（零）：ClaudeCode Basics
- 第一篇 · 2026 如何养好 Claude Code（一）：核心机制深度解析
- 第二篇 · 2026 如何养好 Claude Code（二）：插件生态深度实践
- 第三篇 · 2026 如何养好 Claude Code（三）：框架选型指南
- 第四篇 · 2026 如何养好 Claude Code（四）：多Agent协作实战
开篇：为什么需要框架？
前面的文章介绍了 Claude Code 的核心机制和插件生态。你可能已经跃跃欲试，想把这些能力组合起来，形成一套自己的工作流。
但问题来了：从哪里开始？
市面上已经有人帮你做了这件事——SuperClaude 和 Superpowers 就是两套成熟的"开箱即用"框架。它们封装了最佳实践，让你不需要从零配置。
注意，这两个框架虽然都以"Super"开头，但定位完全不同：
- Superpowers 是 Claude Code 的插件（Plugin），通过
/plugin安装，是一套质量纪律系统 - SuperClaude 是独立的配置框架，通过
pipx install安装，是一套能力扩展系统
它们不是同一类型工具，而是是更像"驾照"和"能力证书"——一个管"怎么做对"，一个管"能做什么"。
本文将带你详细了解两者的设计理念、架构差异和适用场景，帮你做出最适合自己的选择。
一、框架概述
Superpowers
本质：Superpowers 是一个 Claude Code 插件（通过 /plugin 安装），本质是一套技能（Skills）集合，通过强制 TDD 和结构化工作流来规范 AI 行为。
定位: AI编码代理工作流系统（Claude Code Plugin）
核心理念: 质量优先的系统化开发
GitHub Stars: 48k+
版本: v5.0.6
GitHub: https://github.com/obra/superpowers
关键特征:
- 强制TDD工作流
- 技能可组合系统
- 子代理自动化
- 两阶段代码审查
- Git工作树集成
SuperClaude
本质：SuperClaude 是一个配置框架（通过 pipx install superclaude 安装），本质是一套行为指令注入系统，通过 Persona（角色）、MCP 集成和 Slash 命令来增强 AI 能力。
定位: 能力扩展框架（Configuration Framework）
核心理念: 专家角色协作 + 能力增强
版本: v4.3.0
GitHub: https://github.com/SuperClaude-Org/SuperClaude_Framework
关键特征:
- 30 个 Slash Commands
- 20 个专业 Agent（Persona）
- 7 种行为模式
- 8 个 MCP 服务器集成
- 深度研究能力
核心差异：不是互斥，而是互补
理解两者的关键在于认识到它们不是互斥关系，而是定位完全不同的工具：
| 维度 | Superpowers | SuperClaude |
|---|---|---|
| 产品形态 | Claude Code Plugin（插件） | 配置框架（独立安装） |
| 安装方式 | /plugin install |
pipx install superclaude |
| 核心机制 | Skills（技能）集合 | Persona + Slash Commands + MCP |
| 设计目标 | 规范 AI 行为（纪律） | 增强 AI 能力（能力） |
| 是否互斥 | 否，可与 SuperClaude 组合使用 | 否，可与 Superpowers 组合使用 |
二、安装配置实战
Superpowers 安装
Superpowers 作为 Claude Code 插件，通过内置的 Plugin 系统安装：
# 1. 注册市场
/plugin marketplace add obra/superpowers-marketplace
# 2. 安装插件
/plugin install superpowers@superpowers-marketplace
# 3. 验证安装
/help
# 应该看到 /superpowers:brainstorm 等命令
安装后的目录结构：
~/.claude/plugins/superpowers/
├── skills/
│ ├── brainstorming.md
│ ├── test-driven-development.md
│ ├── subagent-driven-development.md
│ ├── writing-plans.md
│ ├── executing-plans.md
│ ├── code-review.md
│ └── ...
└── plugin.json
SuperClaude 安装
SuperClaude 作为独立配置框架，通过 pipx 安装：
# 1. pipx 安装（推荐）
pipx install superclaude
# 2. 安装命令（30 个 slash commands）
superclaude install
# 3. 可选：安装 MCP 服务器
superclaude mcp --list
superclaude mcp --servers tavily --servers context7
# 4. 验证
superclaude doctor
安装后的目录结构：
~/.claude/
├── skills/ # 30 个 Slash Commands
│ ├── sc:analyze.md
│ ├── sc:implement.md
│ ├── sc:design.md
│ └── ...
├── CLAUDE.md # 全局配置（Persona、MCP 等）
└── settings.json # MCP 服务器配置
组合安装（进阶）
两者可以同时使用，组合方式如下：
# 先装 SuperClaude（能力层）
pipx install superclaude
superclaude install
# 再装 Superpowers（纪律层）
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
# 效果：SuperClaude 提供丰富的角色和命令，
# Superpowers 提供强制 TDD 和质量门控
三、核心理念对比
设计哲学
| 维度 | Superpowers | SuperClaude |
|---|---|---|
| 质量保证 | 强制执行 | 灵活可选 |
| 工作流 | 结构化7阶段 | 动态自适应 |
| 测试 | TDD强制 | 多策略支持 |
| 审查 | 自动两阶段 | 专家角色审查 |
| 扩展性 | 技能组合 | 角色协作 |
核心原则
Superpowers 原则：
1. NO PRODUCTION CODE WITHOUT FAILING TEST FIRST
→ 绝对强制，无例外
2. YAGNI (You Aren't Gonna Need It)
→ 只实现当前需要的功能
3. Verify before declaring success
→ 声称成功前必须验证
SuperClaude 原则：
1. 专家角色协作
→ 不同专家处理不同问题
2. 智能任务调度
→ 自动分配给合适角色
3. 动态工作流编排
→ 根据任务自适应调整
四、功能覆盖矩阵
| 功能维度 | Superpowers | SuperClaude |
|---|---|---|
| 核心定位 | 质量纪律框架 | 能力扩展框架 |
| 安装方式 | /plugin |
pipx install |
| 命令数量 | 10+ Skills | 30 Slash Commands |
| Agent/角色 | 子代理（自动） | 20 专业 Agent |
| 测试策略 | 强制 TDD | 灵活可选 |
| 代码审查 | 两阶段自动审查 | 专家角色审查 |
| MCP 集成 | 无（纯 Skill） | 8 个 MCP 服务器 |
| 工作流模式 | 固定 7 阶段 | 7 种自适应模式 |
| Git 集成 | Worktree 自动化 | 基本支持 |
| 质量门控 | 6 层强制 | 10 步可选 |
| 深度研究 | 无 | 内置 Deep Research |
| 学习曲线 | 陡峭（2-3月） | 平缓（1-2月） |
| GitHub Stars | 48k+ | 快速增长中 |
五、架构设计对比
Superpowers 架构
graph TB
subgraph "Superpowers 架构 (v5.0.6)"
A[用户] --> B[技能触发器]
B --> C[技能编排]
C --> D[子代理派发]
D --> E[任务执行]
E --> F[两阶段审查]
F --> G[质量门控]
end
style B fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style D fill:#D4A574,stroke:#b8905a,color:#fff
style F fill:#7BA17B,stroke:#5a8a5a,color:#fff
特点：
- 线性工作流
- 技能可组合
- 强制质量门控
- 子代理隔离
SuperClaude 架构
graph TB
subgraph "SuperClaude 架构 (v4.3.0)"
A[用户] --> B[30 Slash Commands]
B --> C[20 专业 Agent]
C --> D{角色调度}
D --> E[architect]
D --> F[frontend]
D --> G[backend]
D --> H[security]
D --> I[qa / refactorer]
D --> J[其他 15 个 Agent]
C --> K[7 行为模式]
C --> L[8 MCP 服务器]
end
style B fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style D fill:#D4A574,stroke:#b8905a,color:#fff
style K fill:#7BA17B,stroke:#5a8a5a,color:#fff
style L fill:#C8A27B,stroke:#a8865a,color:#fff
特点：
- 并行协作
- 角色专业化
- 动态调度
- MCP 能力扩展
六、工作流对比
Superpowers 工作流（7阶段）
graph LR
A[brainstorming<br/>需求探索] --> B[worktree<br/>环境隔离]
B --> C[write-plan<br/>任务分解]
C --> D[subagent-dev<br/>子代理开发]
D --> E[tdd<br/>测试驱动]
E --> F[code-review<br/>代码审查]
F --> G[finishing-branch<br/>完成分支]
style A fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style C fill:#7BA17B,stroke:#5a8a5a,color:#fff
style D fill:#D4A574,stroke:#b8905a,color:#fff
style G fill:#7BA17B,stroke:#5a8a5a,color:#fff
特点：
- 固定7阶段
- 顺序执行
- 强制门控
- 质量优先
SuperClaude 工作流（动态）
特点：
- 动态编排
- 并行协作
- 灵活调整
- 效率优先
七、实战对比：构建认证系统
用同一个任务展示两个框架的不同做法，直观感受设计哲学的差异。
任务描述：“为 Web 应用构建用户认证系统，支持 JWT + refresh token”
Superpowers 做法
graph TB
A["/superpowers:brainstorm<br/>苏格拉底式探索需求"] --> B["/superpowers:worktree<br/>创建隔离环境"]
B --> C["/superpowers:write-plan<br/>分解为 TDD 任务"]
C --> D["/superpowers:subagent-dev<br/>每任务新子代理"]
D --> E["/superpowers:tdd<br/>RED-GREEN-REFACTOR"]
E --> F["/superpowers:code-review<br/>两阶段自动审查"]
F --> G["/superpowers:finish-branch<br/>合并或 PR"]
style A fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style C fill:#7BA17B,stroke:#5a8a5a,color:#fff
style E fill:#D4A574,stroke:#b8905a,color:#fff
style G fill:#7BA17B,stroke:#5a8a5a,color:#fff
详细步骤：
Step 1: brainstorm（苏格拉底式探索）
→ "用户是谁？需要哪些角色？"
→ "Token 有效期多长？刷新策略？"
→ "密码策略？是否支持 OAuth？"
→ 最终输出：结构化需求文档
Step 2: worktree（环境隔离）
→ git worktree 创建隔离分支
→ 避免污染主分支
Step 3: write-plan（TDD 任务分解）
→ 将需求拆解为可测试的原子任务
→ 每个任务有明确的测试验收标准
Step 4: subagent-dev（子代理开发）
→ 每个原子任务启动新子代理
→ 子代理只关注当前任务，上下文干净
Step 5: tdd（强制测试驱动）
→ RED: 先写失败测试
→ GREEN: 写最少代码让测试通过
→ REFACTOR: 重构，测试保持绿色
Step 6: code-review（两阶段审查）
→ 第一阶段：自动质量检查
→ 第二阶段：安全性和架构审查
Step 7: finish-branch（完成分支）
→ 合并到主分支或创建 PR
→ 自动清理 worktree
SuperClaude 做法
graph TB
A["/brainstorm<br/>结构化头脑风暴"] --> B["/design<br/>系统架构设计"]
B --> C["/implement<br/>代码实现"]
C --> D["/test<br/>测试生成"]
D --> E["/analyze<br/>代码分析"]
E --> F["/git<br/>Git 操作"]
style A fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style C fill:#D4A574,stroke:#b8905a,color:#fff
style D fill:#7BA17B,stroke:#5a8a5a,color:#fff
style F fill:#7BA17B,stroke:#5a8a5a,color:#fff
详细步骤：
Step 1: /brainstorm（结构化头脑风暴）
→ Brainstorming 模式自动激活
→ 苏格拉底式问答探索需求
→ 输出：结构化需求文档
Step 2: /design（系统架构设计）
→ architect Agent 自动激活
→ 分析认证系统架构
→ 输出：JWT + refresh token 架构方案
Step 3: /implement（代码实现）
→ backend Agent 自动激活
→ 实现认证逻辑、密码加密、Token 生成
→ 支持多语言、多框架
Step 4: /test（测试生成）
→ qa Agent 自动激活
→ 生成单元测试和集成测试
→ 测试覆盖分析
Step 5: /analyze（代码分析）
→ security Agent 自动激活
→ 安全漏洞扫描
→ 代码质量分析
Step 6: /git（Git 操作）
→ 智能提交信息生成
→ PR 创建和描述
对比总结
| 维度 | Superpowers | SuperClaude |
|---|---|---|
| 开发节奏 | 慢而稳，每步有保障 | 快而灵活，Agent 自适应 |
| 测试介入 | 第一步就写测试 | 实现后再生成测试 |
| 角色分工 | 统一的子代理 | 20 个专业 Agent 自动调度 |
| 审查方式 | 固定两阶段 | 按需安全/质量审查 |
| 环境管理 | 自动 worktree 隔离 | 基本分支管理 |
| 适合心态 | “质量是生命线” | “先跑起来再优化” |
八、学习曲线
Superpowers
学习周期: 2-3个月
时间投入: 45-65小时
Week 1: 基础概念 (10-15h)
✓ TDD理念
✓ RED-GREEN-REFACTOR
✓ 基本工作流
Week 2: 实践应用 (15-20h)
✓ 完整工作流
✓ 子代理开发
✓ Git工作树
Week 3-4: 熟练掌握 (20-30h)
✓ 高级技巧
✓ 自定义技能
✓ 团队协作
SuperClaude
学习周期: 1-2个月
时间投入: 18-27小时
Week 1: 基础使用 (8-12h)
✓ 基本命令
✓ 角色系统
✓ 工作流理解
Week 2: 角色协作 (10-15h)
✓ 专家角色
✓ 任务调度
✓ 协作模式
Week 3+: 持续改进
✓ 高级配置
✓ 自定义角色
学习曲线对比：
- Superpowers：陡峭曲线，长期收益高
- SuperClaude：平缓曲线，快速上手
九、选型决策树
graph TB
A[开始选择] --> B{团队规模}
B -->|个人/小团队| C{质量要求}
B -->|中大型团队| D{项目复杂度}
C -->|极高| E[Superpowers]
C -->|中等| F{工作流偏好}
F -->|标准化| E
F -->|灵活| G[SuperClaude]
D -->|高| G
D -->|中等| H{测试策略}
H -->|TDD强制| E
H -->|灵活选择| G
style E fill:#7B9EC8,stroke:#5a8ab8,color:#fff
style G fill:#7BA17B,stroke:#5a8a5a,color:#fff
快速决策表
| 你的情况 | 推荐 | 原因 |
|---|---|---|
| 个人开发者，学习最佳实践 | Superpowers | 完整质量保证，系统化流程 |
| 2-5人小团队，统一工作流 | Superpowers | 标准化流程，质量一致 |
| 5人+团队，需要灵活性 | SuperClaude | 专家协作，灵活适应 |
| 质量优先，TDD强制 | Superpowers | TDD强制执行 |
| 快速迭代，速度优先 | SuperClaude | 灵活工作流，快速交付 |
| 复杂架构，需要专家决策 | SuperClaude | 架构师角色，专业决策 |
| 两者都想用 | 组合使用 | Superpowers 管纪律，SuperClaude 扩展能力 |
十、组合使用策略
策略1：分阶段采用
阶段1: 使用 Superpowers 打基础
时间: 1-2个月
目标:
✓ 建立质量标准
✓ 学习TDD实践
✓ 统一工作流
阶段2: 引入 SuperClaude 增强
时间: 持续
目标:
✓ 增加灵活性
✓ 专家角色支持
✓ 处理复杂场景
策略2：按项目类型选择
质量优先项目 → Superpowers
示例: 核心业务系统、金融应用、医疗软件
快速迭代项目 → SuperClaude
示例: 原型开发、MVP验证、快速实验
策略3：组合使用
Superpowers（纪律层）+ SuperClaude（能力层）
Superpowers 负责:
✓ 强制 TDD
✓ 质量门控
✓ 代码审查
SuperClaude 负责:
✓ 专家角色调度
✓ MCP 能力扩展
✓ 深度研究
十一、小结
核心差异总结
| 维度 | Superpowers | SuperClaude |
|---|---|---|
| 产品形态 | Plugin（插件） | 配置框架 |
| 核心定位 | 质量纪律 | 能力扩展 |
| 适合团队 | 个人/小团队 | 中大型团队 |
| 学习曲线 | 陡峭（2-3月） | 平缓（1-2月） |
| 质量保证 | 强制执行 | 灵活可选 |
| 工作流 | 固定7阶段 | 动态自适应 |
| 扩展方式 | 技能组合 | 角色协作 |
| 是否互斥 | 否 | 否 |
选择建议
选择 Superpowers 如果：
- 你重视代码质量胜过速度
- 你想学习或强制TDD实践
- 你是个人开发者或小团队
- 你的项目质量要求极高
选择 SuperClaude 如果：
- 你需要灵活适应不同项目
- 你是中大型团队
- 你的项目复杂度较高
- 你需要在速度和质量间平衡
两者都想要：
- 先用 Superpowers 建立纪律，再用 SuperClaude 扩展能力
- 按项目类型灵活切换
- 核心系统用 Superpowers，实验项目用 SuperClaude
下期预告
下一篇《多Agent协作实战》将深入：
- Agent Teams 架构解析
- 任务拆分策略
- Git Worktree 联动
- 团队落地建议
思考题
看完这一篇，有兴趣可以试着回答这些问题，看看你的理解程度：
-
Superpowers 和 SuperClaude 的核心定位差异是什么？为什么说它们不是互斥的？
-
Superpowers 是通过什么机制安装的？SuperClaude 呢？两者可以组合使用吗？
-
TDD 强制执行的优缺点是什么？什么类型的项目最适合强制 TDD？
-
如何根据团队规模和项目类型选择框架？请给出一个具体场景的选型分析。