SuperClaude Framework 详细教程：把 Claude Code 变成结构化开发平台

SuperClaude 是一个"元编程式配置框架"，通过行为指令注入 + 组件编排，把 Claude Code 从"聊天写代码"升级成"可控、可复用、可团队化"的结构化开发平台。

它提供 30 个 Slash Commands 、16 个 Agents 、7 种行为模式 、8 个 MCP Server 集成，覆盖从调研、设计、编码、测试到发布的完整生命周期。

📋 目录

[0. 快速开始](#0. 快速开始)
[1. 核心概念：Commands / Agents / Modes / MCP](#1. 核心概念：Commands / Agents / Modes / MCP)
[2. 高频命令工作流（按真实开发节奏）](#2. 高频命令工作流（按真实开发节奏）)
[3. 快速参考表](#3. 快速参考表)
[4. 总结](#4. 总结)

0. 快速开始

🎯 核心能力

SuperClaude 将 Claude Code 从"聊天写代码"升级为"结构化开发平台"：

✅ 30 个 Slash Commands：把复杂提示产品化，一键调用专业工作流
✅ 16 个 Agents：专业分工，比如"代码审查员 / 架构师 / 研究员"
✅ 7 种行为模式：控制风险与输出风格，在"探索 / 计划 / 产出"之间切换
✅ 8 个 MCP Servers：接入外部能力（检索、知识库、工具链、数据源等）

🚀 第一步：查看所有命令

在 Claude Code 会话中输入：

text 复制代码

/sc:sc

这会显示所有可用的 SuperClaude 命令。如果能看到命令列表，说明 SuperClaude 已安装并可用！

📚 快速上手：5 个核心命令

先记住这 5 个命令即可快速开始：

/sc:index-repo - 为当前仓库建立索引，让 AI 快速理解代码库
/sc:research [query] - 做深度 Web 调研
/sc:design [需求] - 做系统/接口设计
/sc:implement [功能] - 落实具体功能开发
/sc:test --coverage - 执行测试并查看覆盖率

💡 小技巧 ：任何命令都可以加 --help 查看详细用法，例如：/sc:implement --help

1. 核心概念：Commands / Agents / Modes / MCP

1.1 Slash Commands（命令体系，对齐 `/sc:sc`）

SuperClaude 的定位不是"给你更多 prompt"，而是把 prompt 固化成命令 ，形成可复用的工作流入口。

运行：

复制代码

/sc:sc

会看到类似下面的命令列表（来自 SuperClaude Framework v4.1.7 输出）：

Command	描述
`/sc:research`	并行搜索的深度网络调研
`/sc:index-repo`	为上下文优化索引仓库
`/sc:agent`	启动专业化的 AI 代理
`/sc:recommend`	获取命令推荐
`/sc:brainstorm`	交互式需求发现
`/sc:design`	设计系统架构和 API
`/sc:implement`	功能实现（集成 MCP）
`/sc:analyze`	全面的代码分析
`/sc:test`	执行测试并分析覆盖率
`/sc:build`	构建和打包项目
`/sc:git`	Git 操作（智能提交）
`/sc:workflow`	生成实现工作流
`/sc:explain`	解释代码和概念
`/sc:troubleshoot`	诊断并解决问题
`/sc:document`	生成聚焦的文档
`/sc:improve`	应用系统化的代码改进
`/sc:cleanup`	移除死代码，优化结构
`/sc:estimate`	提供开发估算
`/sc:spawn`	任务编排与委派
`/sc:save` / `/sc:load`	会话生命周期管理
`/sc:reflect`	任务反思和验证
`/sc:spec-panel`	多专家规范审查
`/sc:business-panel`	业务分析系统

（其余命令可在实际 /sc:sc 输出中查看，以你当前安装版本为准。）

命令使用分层思路

入口类命令 ：/sc:sc、/sc:recommend
用来发现有哪些能力、下一步该用哪个命令。
工作流类命令 ：/sc:brainstorm、/sc:design、/sc:implement、/sc:test、/sc:document、/sc:workflow 等
覆盖从调研 → 设计 → 实现 → 测试 → 文档的完整链路。
工具/维护类命令 ：/sc:index-repo、/sc:analyze、/sc:troubleshoot、/sc:improve、/sc:cleanup、/sc:git、/sc:save / /sc:load 等
用于索引、分析、诊断、改进、会话管理。

快速上手：从 `/sc:sc` 和 5 个核心命令开始

第一步，在 Claude Code 里执行：

复制代码

/sc:sc

然后重点先记住这 5 个命令即可：

/sc:index-repo：为当前仓库建立索引
/sc:research：做深度 Web 调研
/sc:design：做系统/接口设计
/sc:implement：落实具体功能开发
/sc:test：执行测试（建议加 --coverage）

小技巧：任何命令都可以加 --help 看用法，比如：/sc:implement --help。

常用命令示例（对齐官方 Quick Examples）

命令模式	用途	示例
`/sc:research`	并行 Web 深度调研	`/sc:research React 18 new features`
`/sc:agent`	启动特定类型 Agent	`/sc:agent deep-research`
`/sc:analyze`	代码/系统分析	`/sc:analyze --security`
`/sc:implement`	功能实现	`/sc:implement user authentication`
`/sc:test`	执行测试（含覆盖率）	`/sc:test --coverage`
`/sc:save`	保存会话	`/sc:save "milestone checkpoint"`
`/sc:load`	加载会话	`/sc:load project_name`

1.2 Agents（16个专业角色）

SuperClaude 提供 16 个专业化的 Agent，每个 Agent 专注于特定领域。通过 /sc:agent [type] 命令来启动特定的 Agent。

Agent 使用理念

核心思想：不要让一个 Agent 从头干到尾；用 Agent 做"阶段性接管"，质量会明显更稳。

如何使用 Agent

基本语法：

text 复制代码

/sc:agent [agent-type] [任务描述]

查看可用的 Agent 类型：

text 复制代码

/sc:agent --help

或直接输入：

text 复制代码

/sc:agent

会显示所有可用的 Agent 类型列表。

阶段性接管模式（完整示例）

阶段 1：研究阶段

text 复制代码

/sc:agent deep-research "调研 React 18 的新特性和最佳实践"

或使用专门的调研命令：

text 复制代码

/sc:research React 18 new features

阶段 2：设计阶段

text 复制代码

/sc:agent architect "设计用户认证系统的架构和数据流"

或使用设计命令：

text 复制代码

/sc:design 设计用户认证系统架构

阶段 3：实施阶段

text 复制代码

/sc:agent implementer "实现用户登录功能"

或直接使用：

text 复制代码

/sc:implement 用户登录功能

阶段 4：审查阶段

text 复制代码

/sc:agent security-reviewer "审查认证代码的安全性"

或使用分析命令：

text 复制代码

/sc:analyze --security

常用 Agent 类型及使用示例

Agent 类型	命令示例	使用场景
deep-research	`/sc:agent deep-research "调研 GraphQL 与 REST 的对比"`	深度技术调研、竞品分析
architect	`/sc:agent architect "设计微服务架构"`	系统架构设计、模块拆分
implementer	`/sc:agent implementer "实现支付模块"`	功能开发、代码实现
security-reviewer	`/sc:agent security-reviewer "审查 API 安全性"`	安全审计、漏洞检测
qa-tester	`/sc:agent qa-tester "设计登录流程测试用例"`	测试策略、质量保证
documenter	`/sc:agent documenter "编写 API 文档"`	文档编写、知识整理
optimizer	`/sc:agent optimizer "优化数据库查询性能"`	性能分析、瓶颈优化
devops	`/sc:agent devops "配置 CI/CD 流水线"`	部署脚本、环境配置

完整工作流示例：使用多个 Agent 协作

text 复制代码

# 1. 研究阶段
/sc:agent deep-research "调研用户评论系统的最佳实践"
/sc:save "研究完成"

# 2. 设计阶段
/sc:agent architect "设计评论系统的数据模型和 API"
/sc:save "设计完成"

# 3. 实施阶段
/sc:agent implementer "实现评论功能"
/sc:save "实现完成"

# 4. 测试阶段
/sc:agent qa-tester "设计评论功能的测试用例"
/sc:test --coverage

# 5. 审查阶段
/sc:agent security-reviewer "审查评论功能的安全性"
/sc:analyze --security

# 6. 文档阶段
/sc:agent documenter "编写评论功能的使用文档"

最佳实践

明确阶段边界 ：每个阶段结束时，使用 /sc:save 保存成果，然后切换到下一个 Agent
保持上下文 ：使用 /sc:save 和 /sc:load 确保上下文在不同 Agent 间传递
专业分工：让专业的人做专业的事，不要用一个 Agent 做所有事
结合命令使用 ：Agent 可以与 /sc:research、/sc:design、/sc:implement 等命令配合使用，获得更好的效果

1.3 Modes（7种行为模式）

Modes 可以理解为：控制"输出方式与风险水平"的档位。在 SuperClaude 中，Modes 主要通过不同的命令来实现，每个命令内置了相应的行为模式。

模式与命令的对应关系

模式	对应命令	开发阶段	行为特点	风险等级
探索模式	`/sc:brainstorm`、`/sc:research`	需求调研	允许发散、多方案对比	低（不改文件）
计划模式	`/sc:design`、`/sc:workflow`	方案设计	只产出清单、步骤、影响分析	低（只分析）
实施模式	`/sc:implement`	编码实现	开始改代码、跑测试	中（会修改文件）
审查模式	`/sc:analyze --security`、`/sc:reflect`	代码审查	以安全/质量为优先级	高（严格检查）
优化模式	`/sc:improve`、`/sc:cleanup`	性能优化	聚焦效率提升	中（可能重构）
文档模式	`/sc:document`	文档编写	专注文档产出	低（只写文档）
测试模式	`/sc:test`	测试阶段	专注测试用例和验证	中（可能改测试）

如何使用 Modes（通过命令实现）

方式 1：直接使用对应模式的命令

text 复制代码

# 探索模式：需求澄清
/sc:brainstorm 实现用户评论系统
/sc:research React 评论组件最佳实践

# 计划模式：方案设计
/sc:design 设计评论系统的数据模型和 API
/sc:workflow 实现评论功能的步骤

# 实施模式：编码实现
/sc:implement 创建评论数据模型
/sc:implement 实现评论 API 接口

# 审查模式：质量检查
/sc:analyze --security
/sc:reflect 复盘本次开发过程

# 优化模式：性能提升
/sc:improve 优化评论查询性能
/sc:cleanup 清理死代码

# 文档模式：文档编写
/sc:document 生成评论功能的 API 文档

# 测试模式：测试验证
/sc:test --coverage

方式 2：通过命令标志控制行为

某些命令支持标志参数来控制行为模式：

text 复制代码

# 安全审查模式
/sc:analyze --security

# 测试覆盖模式
/sc:test --coverage

# 查看命令支持的标志
/sc:implement --help
/sc:analyze --help

完整工作流示例：模式切换

text 复制代码

# 阶段 1：探索模式（需求澄清）
/sc:brainstorm 用户评论系统需求
/sc:research 评论系统的技术选型
/sc:save "需求探索完成"

# 阶段 2：计划模式（方案设计）
/sc:design 评论系统的架构设计
/sc:workflow 实现评论功能的详细步骤
/sc:save "设计方案完成"

# 阶段 3：实施模式（编码实现）
/sc:implement 创建评论数据模型
/sc:implement 实现评论 API
/sc:implement 实现前端评论组件
/sc:save "功能实现完成"

# 阶段 4：测试模式（测试验证）
/sc:test --coverage
/sc:save "测试完成"

# 阶段 5：审查模式（质量检查）
/sc:analyze --security
/sc:reflect
/sc:save "审查完成"

# 阶段 6：优化模式（性能优化，可选）
/sc:improve 优化评论加载性能
/sc:cleanup

# 阶段 7：文档模式（文档编写）
/sc:document 生成评论功能文档

模式切换最佳实践

按阶段切换：根据开发阶段选择合适的命令（即模式）
保存检查点 ：每个模式切换时使用 /sc:save 保存状态
明确意图：在命令中明确说明你的目标，让 AI 更好地理解上下文

组合使用 ：可以组合多个命令来实现复杂任务，例如：

text 复制代码

/sc:design 设计系统架构
/sc:workflow 生成实现步骤
/sc:implement 按步骤实现
/sc:test --coverage
/sc:document 生成文档

注意事项

风险控制 ：探索和计划模式的命令（如 /sc:brainstorm、/sc:design）通常不会修改文件，可以放心使用
实施模式 ：/sc:implement 会实际修改代码，建议在版本控制下使用，或先用 /sc:workflow 查看计划
审查模式 ：/sc:analyze --security 和 /sc:reflect 用于质量检查，不会修改代码
查看帮助 ：不确定命令行为时，使用 --help 查看详细说明

1.4 MCP Servers（8个外部工具集成）

MCP（Model Context Protocol）Servers 让 Claude Code 具备"工具手脚"，可以接入外部能力。

MCP 概念说明

MCP Servers 是 SuperClaude 与外部系统集成的桥梁：

检索能力：接入搜索引擎、知识库
工具链：接入开发工具、构建系统
数据源：接入数据库、API 服务
测试框架：接入测试工具、验证系统

常用 MCP Servers 说明

Server	激活标志	用途	适用场景
Context7	`--c7` / `--context7`	官方文档检索	框架模式、官方文档查询
Sequential	`--seq` / `--sequential`	复杂分析、调试	系统设计、深度分析
Magic	`--magic`	UI 组件、设计系统	前端开发、UI 设计
Morphllm	`--morph` / `--morphllm`	批量转换、模式编辑	代码重构、批量修改
Serena	`--serena`	符号操作、项目记忆	大型代码库、符号查找
Playwright	`--play` / `--playwright`	浏览器测试、E2E	自动化测试、视觉验证
Tavily	`--tavily`	网络搜索	信息检索、实时数据
Filesystem	`--fs`	文件系统操作	文件管理、批量处理

常用 MCP Servers 使用示例

Context7（官方文档检索）

bash 复制代码

# 在命令中使用
--c7 "查找 Next.js 认证最佳实践"

# 或
--context7 "React Hooks 使用指南"

Sequential（复杂分析）

bash 复制代码

# 用于深度分析
--seq "分析系统性能瓶颈"

# 或
--sequential "设计微服务架构"

Magic（UI 组件）

bash 复制代码

# 前端开发
--magic "创建响应式导航栏组件"

# 设计系统
--magic --think "设计统一的按钮组件系统"

Playwright（浏览器测试）

bash 复制代码

# E2E 测试
--play "编写登录流程的 E2E 测试"

# 或
--playwright "测试购物车功能"

2. 高频命令工作流（按真实开发节奏）

下面这套是"最小可用工作流"，完全基于实际的 /sc:* 命令------你只要记：列命令 → 索引仓库 → 选择合适工作流命令 → 保存会话。

2.1 新项目上手（第一次进仓库）

目标：快速理解代码库结构、架构、风险点

工作流步骤

查看可用命令
text 复制代码
```
/sc:sc
```
为当前仓库建立索引
text 复制代码
```
/sc:index-repo
```
让 SuperClaude 对当前代码仓库建立结构化索引，后续分析/实现更有上下文。
整体架构与代码分析
text 复制代码
```
/sc:analyze
```
可选：根据需要添加选项，例如 --security、--performance（以实际帮助输出为准）。

技术/业务调研

text 复制代码

/sc:research 当前项目涉及的关键技术栈

获取下一步建议
text 复制代码
```
/sc:recommend
```
让 SuperClaude 根据当前上下文推荐后续可以用的命令和工作流。
保存当前理解结果
text 复制代码
```
/sc:save "项目初探完成"
```

预期产出

项目架构概览（模块/层次）
技术栈清单
关键模块/目录说明
潜在风险点列表与后续建议

2.2 修 Bug / 处理告警（稳定优先）

目标：安全、可控地修复问题，尽量避免回归

工作流步骤

定位与诊断问题
text 复制代码
```
/sc:troubleshoot
```
结合报错日志/告警信息，让它帮你梳理：复现路径、影响范围、可能根因。
安全分析（可选但强烈推荐）
text 复制代码
```
/sc:analyze --security
```
让系统从安全视角查看这个改动可能引入/暴露的问题。
生成修复方案与步骤
text 复制代码
```
/sc:workflow 修复 [具体 Bug 描述]
```
例如：/sc:workflow 修复订单金额计算错误
实施修复
text 复制代码
```
/sc:implement 修复 [Bug 简要说明]
```
示例：/sc:implement 修复订单金额四舍五入错误
补充/执行测试
text 复制代码
```
/sc:test --coverage
```
让它帮你跑测试并关注覆盖率，必要时让它补充测试用例。
Git 提交（可选）
text 复制代码
```
/sc:git
```
让它基于实际改动生成清晰的提交消息/提交拆分建议。

保存阶段性结果

text 复制代码

/sc:save "Bug 修复完成（含测试）"

注意事项

复杂 Bug 建议：/sc:troubleshoot → /sc:workflow → /sc:implement → /sc:test --coverage
每一个关键阶段都使用 /sc:save，方便以后用 /sc:load 快速回到当时上下文。

2.3 做功能（从需求到 PR）

目标：从需求 → 设计 → 实现 → 测试 → 文档 → PR 的完整闭环

工作流步骤

阶段 1：需求澄清与拆解

text 复制代码

/sc:brainstorm 需求：实现用户评论系统

让它帮你澄清边界条件、角色、异常场景等。

阶段 2：系统/接口设计

text 复制代码

/sc:design 设计用户评论系统的数据模型和 API

结合 SuperClaude 官方 Reference 文档中建议的设计流程，你可以要求它输出：

领域模型 / 表结构草图
API 设计（路径、方法、请求/响应体）
模块划分与依赖关系

阶段 3：生成实现工作流

text 复制代码

/sc:workflow 实现用户评论系统

期待它输出：按步骤拆分的实现计划（后端/前端/测试），并标出每步的预期产物。

阶段 4：按步骤实现功能

text 复制代码

/sc:implement 创建评论数据模型
/sc:implement 实现评论相关 API 接口
/sc:implement 实现前端评论组件

建议每完成一个子任务就手动确认一下改动，再继续下一个 /sc:implement。

阶段 5：测试与质量保障

text 复制代码

/sc:test --coverage

可以要求它：

生成/补充单元测试、集成测试
标出关键路径的覆盖率盲区

必要时配合：

text 复制代码

/sc:improve
/sc:cleanup

做结构优化、死代码清理。

阶段 6：文档与 PR 准备

text 复制代码

/sc:document 生成用户评论功能的开发文档和使用说明

生成：

变更说明
接口文档
使用示例

然后：

text 复制代码

/sc:git

生成清晰的提交信息，甚至帮助拆分多个 commit。

阶段 7：复盘与估算（可选）

text 复制代码

/sc:reflect
/sc:estimate

前者用于复盘本次任务过程（有哪些可以下次做得更好），后者用于为类似需求提供更准确的工作量预估。

简化版「一条龙」示例

text 复制代码

/sc:index-repo
/sc:brainstorm 新增：用户评论系统
/sc:design 设计评论系统的数据模型和 API
/sc:workflow 实现用户评论系统
/sc:implement 评论后端与前端
/sc:test --coverage
/sc:document 生成评论系统文档
/sc:git
/sc:save "评论系统 v1 完成"

3. 快速参考表

3.1 核心命令快速参考

命令	用途	示例
`/sc:sc`	查看所有可用命令	`/sc:sc`
`/sc:research`	并行 Web 深度调研	`/sc:research React 18 new features`
`/sc:index-repo`	为当前仓库建立索引	`/sc:index-repo`
`/sc:brainstorm`	需求澄清与场景发散	`/sc:brainstorm 用户评论系统需求`
`/sc:design`	系统/接口设计	`/sc:design 用户评论系统的数据模型`
`/sc:implement`	功能实现	`/sc:implement user authentication`
`/sc:analyze`	代码/系统分析	`/sc:analyze --security`
`/sc:test`	执行测试（可含覆盖率分析）	`/sc:test --coverage`
`/sc:workflow`	生成实现工作流	`/sc:workflow 实现订单导出功能`
`/sc:troubleshoot`	故障诊断与问题排查	`/sc:troubleshoot`
`/sc:document`	生成文档	`/sc:document 生成本次功能说明文档`
`/sc:improve`	结构化代码改进	`/sc:improve`
`/sc:cleanup`	清理死代码、优化结构	`/sc:cleanup`
`/sc:git`	智能 Git 操作和提交信息生成	`/sc:git`
`/sc:save`	保存当前会话状态	`/sc:save "milestone checkpoint"`
`/sc:load`	加载指定会话状态	`/sc:load project_name`
`/sc:reflect`	任务复盘与验证	`/sc:reflect`
`/sc:estimate`	工作量估算	`/sc:estimate 新版本迭代`

3.2 性能与效率标志

标志	用途	适用场景
`--uc` / `--ultracompressed`	Token 高效通信	大型操作、上下文压力大
`--orchestrate`	优化工具选择	多工具操作、性能需求
`--loop`	迭代改进循环	代码优化、质量提升
`--validate`	执行前风险评估	生产环境、关键操作

3.3 MCP 服务器激活标志

标志	Server	最佳用途
`--c7` / `--context7`	Context7	官方文档、框架模式
`--seq` / `--sequential`	Sequential	复杂分析、调试、系统设计
`--magic`	Magic	UI 组件、设计系统、前端
`--morph` / `--morphllm`	Morphllm	批量转换、模式编辑
`--serena`	Serena	符号操作、项目记忆、大型代码库
`--play` / `--playwright`	Playwright	浏览器测试、E2E、视觉验证
`--tavily`	Tavily	网络搜索、实时信息
`--fs`	Filesystem	文件系统操作、批量处理

3.4 框架集成快速开始

React/Next.js 项目

bash 复制代码

# 初始化 React 模式
--c7 --magic "使用 TypeScript 实现 Next.js 认证"

# 组件开发工作流
--magic --think "创建响应式仪表板组件"

Node.js/Express 后端

bash 复制代码

# API 开发最佳实践
--c7 --seq "使用 Express 和 MongoDB 设计 RESTful API"

# 性能优化
--think --orchestrate "优化数据库查询和缓存"

全栈开发

bash 复制代码

# 完整应用工作流
--task-manage --all-mcp "构建全栈电商平台"

# 集成测试
--play --seq "实现端到端测试策略"

4. 总结

SuperClaude Framework 将 Claude Code 从"聊天写代码"升级为"结构化开发平台"。通过掌握：

✅ 30 个 Slash Commands：把复杂提示产品化
✅ 16 个 Agents：专业分工，阶段性接管
✅ 7 种 Modes：控制风险和输出风格
✅ 8 个 MCP Servers：接入外部能力和工具

SuperClaude Framework 详细教程：把 Claude Code 变成结构化开发平台

📋 目录

0. 快速开始

🎯 核心能力

🚀 第一步：查看所有命令

📚 快速上手：5 个核心命令

1. 核心概念：Commands / Agents / Modes / MCP

1.1 Slash Commands（命令体系，对齐 /sc:sc）

命令使用分层思路

快速上手：从 /sc:sc 和 5 个核心命令开始

常用命令示例（对齐官方 Quick Examples）

1.2 Agents（16个专业角色）

Agent 使用理念

如何使用 Agent

阶段性接管模式（完整示例）

常用 Agent 类型及使用示例

完整工作流示例：使用多个 Agent 协作

最佳实践

1.3 Modes（7种行为模式）

模式与命令的对应关系

如何使用 Modes（通过命令实现）

完整工作流示例：模式切换

模式切换最佳实践

注意事项

1.4 MCP Servers（8个外部工具集成）

MCP 概念说明

常用 MCP Servers 说明

常用 MCP Servers 使用示例

2. 高频命令工作流（按真实开发节奏）

2.1 新项目上手（第一次进仓库）

工作流步骤

预期产出

2.2 修 Bug / 处理告警（稳定优先）

工作流步骤

注意事项

2.3 做功能（从需求到 PR）

工作流步骤

简化版「一条龙」示例

3. 快速参考表

3.1 核心命令快速参考

3.2 性能与效率标志

3.3 MCP 服务器激活标志

3.4 框架集成快速开始

React/Next.js 项目

Node.js/Express 后端

全栈开发

4. 总结

1.1 Slash Commands（命令体系，对齐 `/sc:sc`）

快速上手：从 `/sc:sc` 和 5 个核心命令开始