SuperClaude 命令指南:用 /sc:* 斜杠命令与 @agent-* 专家构建 Claude Code 结构化开发工作流
SuperClaude 命令指南:用 /sc:* 斜杠命令与 @agent-* 专家构建 Claude Code 结构化开发工作流
SuperClaude 是一套面向 Claude Code 的行为上下文框架:它不通过传统软件执行命令,而是向 Claude Code 注入一组高度结构化的行为指令文件,将普通对话升级为覆盖需求发现、架构设计、编码实现、质量验证与文档沉淀的完整开发流水线。读完本文,你将掌握 /sc:* 斜杠命令、@agent-* 专家调用与 SuperClaude 终端命令三者的边界与组合方式,能够独立完成环境验证、核心工作流编排与常见故障排查。
命令类型:三类入口各司其职
SuperClaude 围绕 Claude Code 提供了一整套命令体系。按使用位置与语义,可分为三类:
| 类型 | 使用位置 | 格式 | 示例 |
|---|---|---|---|
| 斜杠命令 | Claude Code 对话内 | /sc:[命令] |
/sc:implement "功能" |
| 智能体调用 | Claude Code 对话内 | @agent-[名称] |
@agent-security "审查" |
| 安装命令 | 终端 | SuperClaude [命令] |
SuperClaude install |
本文按原文档写作时的命令集(25 个命令:工作流类
/sc:*+ 专家类@agent-*)展开讲解;当前仓库的 src/superclaude/commands 目录实际已扩展为 30 个上下文文件,二者并不冲突——原文档覆盖的是全部核心命令,新命令(如pm、recommend、sc、index-repo)是在此基础上增量演进的。
快速测试:确认环境就绪
安装完成后,可以通过以下命令快速验证框架是否可用:
# 终端:确认安装状态
python3 -m SuperClaude --version
# Claude Code CLI 版本检查:claude --version
# Claude Code 对话内:测试命令是否生效
/sc:brainstorm "测试项目" # 应进入引导式需求发现
/sc:analyze README.md # 应给出分析结果
一条典型的端到端工作流是:/sc:brainstorm "想法" → /sc:implement "功能" → /sc:test。
SuperClaude 的工作原理:行为上下文,而非可执行程序
要正确使用这套命令,必须先理解它的运行机制。SuperClaude 提供的是一批"行为上下文文件":当你输入 /sc:implement 时,Claude Code 会读取对应的 implement.md 上下文文件,并遵循其中的行为指令。
关键认知:SuperClaude 命令并不是以软件形式执行的——它是上下文触发器,通过让 Claude Code 读取框架的专业指令文件来改变 Claude 的行为模式。
三类命令的语义差异
- 斜杠命令(
/sc:*):触发工作流模式与行为模式,如/sc:brainstorm、/sc:implement; - 智能体调用(
@agent-*):手动激活特定领域专家,如@agent-security; - 标志(
--think、--safe-mode等):修改命令的行为与分析深度。
上下文加载的四个环节
- 用户输入:输入
/sc:implement "认证系统"; - 上下文加载:Claude Code 读取
~/.claude/superclaude/Commands/implement.md; - 行为采纳:Claude 应用领域专业知识、工具选择逻辑与验证模式;
- 增强输出:产出包含安全考量和最佳实践的结构化实现。
核心要点:这不是传统意义上的软件执行,而是通过上下文管理构建精细的开发工作流。这一点在源码中可以得到印证——仓库的 src/superclaude/commands 目录下存放的正是 30 个 Markdown 行为文件(如 implement.md、brainstorm.md),每个文件头部都包含 name、description、category、complexity、mcp-servers、personas 等元信息,供 Claude Code 按需路由;真正面向终端的 CLI 逻辑则位于 src/superclaude/cli,二者职责边界清晰。
安装命令 vs 使用命令
终端命令(真实 CLI 软件):
SuperClaude install—— 安装框架组件SuperClaude update—— 更新既有安装SuperClaude uninstall—— 卸载框架python3 -m SuperClaude --version—— 检查安装状态
Claude Code 对话命令(上下文触发器):
/sc:brainstorm—— 激活需求发现上下文/sc:implement—— 激活功能开发上下文@agent-security—— 激活安全专家上下文- 所有此类命令仅在 Claude Code 聊天界面内生效
快速上手:想体验核心工作流,直接依次尝试
/sc:brainstorm "项目想法"→/sc:implement "功能名"→/sc:test。
环境自检:终端与 Claude Code 双通道验证
终端验证(在终端/CMD 中执行)
# 确认 SuperClaude 可用(主要方式)
python3 -m SuperClaude --version
# 预期输出:SuperClaude 4.1.5(以实际安装版本为准)
# 确认 Claude Code CLI 版本
claude --version
# 查看已安装组件
python3 -m SuperClaude install --list-components | grep mcp
# 预期输出:已安装的 MCP 组件列表
Claude Code 对话验证(在 Claude Code 聊天中输入)
# 基础 /sc: 命令测试
/sc:brainstorm "测试项目"
# 预期行为:启动交互式需求发现
# 命令帮助测试
/sc:help
# 预期行为:列出可用命令
命令速查表
| 命令类型 | 执行位置 | 格式 | 目的 | 示例 |
|---|---|---|---|---|
| 安装 | 终端/CMD | SuperClaude [命令] |
配置与维护 | SuperClaude install |
| 配置 | 终端/CMD | python3 -m SuperClaude [命令] |
高级配置 | python3 -m SuperClaude --version |
| 斜杠命令 | Claude Code | /sc:[命令] |
工作流自动化 | /sc:implement "功能" |
| 智能体调用 | Claude Code | @agent-[名称] |
手动激活专家 | @agent-security "审查" |
| 增强标志 | Claude Code | /sc:[命令] --标志 |
修改行为 | /sc:analyze --think-hard |
请牢记:所有
/sc:命令与@agent-调用都在 Claude Code 聊天内生效,而非终端。它们触发 Claude Code 从 SuperClaude 框架读取特定上下文文件。
必备命令详解:12 个核心命令实战
以下是提升即时生产力的核心工作流命令,每个命令都包含语法、使用场景与底层行为说明。
/sc:brainstorm —— 项目需求发现
目的:通过苏格拉底式对话与系统化探索进行交互式需求发现。
语法:/sc:brainstorm "想法" [--strategy systematic|creative]
使用场景:
- 新项目规划:
/sc:brainstorm "电商平台" - 功能探索:
/sc:brainstorm "用户认证系统" - 问题求解:
/sc:brainstorm "数据库查询缓慢"
源码级行为(见 brainstorm.md):该上下文文件明确声明"STOP AFTER REQUIREMENTS DISCOVERY"——只产出需求规格,不产出架构与代码。其行为流为:探索(苏格拉底式提问)→ 分析(多智能体协调)→ 验证(可行性评估)→ 规格化(跨会话持久化)→ 交接(生成可执行简报)。它会协调 architect、analyzer、frontend、backend、security、devops、project-manager 七个专家画像,并联动 Sequential、Context7、Magic、Playwright、Morphllm、Serena 六个 MCP 服务器。产出文档应包含:澄清后的用户目标、功能需求、非功能需求、用户故事/验收标准、遗留问题清单。完成后建议衔接 /sc:design(架构)或 /sc:workflow(实现规划)。
/sc:help —— 命令参考
目的:列出所有可用的 /sc 命令及说明。
语法:/sc:help
使用场景:发现可用命令 /sc:help;快速确认命令名称 /sc:help。
/sc:research —— 深度研究命令
目的:通过自适应规划与智能检索完成综合性网页研究。
语法:/sc:research "[查询]" [--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]
使用场景:
- 技术调研:
/sc:research "最新 React 19 特性" --depth deep - 市场分析:
/sc:research "2024 年 AI 编程助手格局" --strategy unified - 学术调查:
/sc:research "量子计算突破" --depth exhaustive - 实时资讯:
/sc:research "2024 年最新 AI 进展"
核心能力:
- 六阶段工作流:理解 → 规划 → TodoWrite → 执行 → 跟踪 → 验证
- 自适应深度:Quick(基础检索)、Standard(扩展)、Deep(全面)、Exhaustive(最大深度)
- 规划策略:Planning(直接执行)、Intent(先澄清意图)、Unified(协同规划)
- 并行执行:默认并行检索与抽取
- 证据管理:带相关性评分的清晰引用
- 输出规范:报告保存至
docs/research/[主题]_[时间戳].md
源码级行为(见 research.md):执行阶段采用"并行优先"策略——同类查询始终批量并行,按内容复杂度路由抽取方式,并支持多跳探索(沿实体链、概念链深入)。其自适应深度对应关系为:Quick 约 1 跳、Standard 2-3 跳、Deep 3-4 跳、Exhaustive 5 跳。该命令联动 Tavily(主检索引擎)、Sequential(复杂推理与综合)、Playwright(JS 密集内容抽取)、Serena(研究会话持久化),且明确"STOP AFTER RESEARCH REPORT"——只产出研究报告,不代为实现结论。
/sc:implement —— 功能开发
目的:通过智能专家路由实现全栈功能开发。
语法:/sc:implement "功能描述" [--type frontend|backend|fullstack] [--focus security|performance]
使用场景:
- 认证:
/sc:implement "JWT 登录系统" - UI 组件:
/sc:implement "响应式仪表盘" - API:
/sc:implement "REST 用户端点" - 数据库:
/sc:implement "带关联关系的用户模式"
源码级行为(见 implement.md):这是行为流最完整的命令之一,包含分析 → 规划 → 生成 → 验证 → 集成五步:先检测技术栈上下文,再按上下文激活对应专家画像(architect、frontend、backend、security、qa-specialist),通过 Context7 获取框架官方模式、Magic 生成 UI 组件、Sequential 做多步骤协调、Playwright 做测试验证。其元信息中 mcp-servers: [context7, sequential, magic, playwright],源码中的实际触发模式还支持 --framework react|vue|express、--safe、--with-tests 等参数,比速查表更细。完成标准:代码可编译、基础功能可用、文件就绪待测试;完成后衔接 /sc:test 与 /sc:git。
/sc:analyze —— 代码评估
目的:覆盖质量、安全、性能、架构的多维代码分析。
语法:/sc:analyze [路径] [--focus quality|security|performance|architecture]
使用场景:
- 项目体检:
/sc:analyze . - 安全审计:
/sc:analyze --focus security - 性能评审:
/sc:analyze --focus performance
源码级行为(见 analyze.md):采用"发现 → 扫描 → 评估 → 建议 → 报告"五步流程,先通过语言检测与项目分析对源文件分类,再应用领域特定分析技术与模式匹配,产出带严重度评级(severity)的优先级发现项与改进路线图。其工具编排为 Glob(文件发现)、Grep(模式分析)、Read(源码检查)、Bash(外部工具执行)、Write(报告生成)。
/sc:business-panel —— 战略性商业分析
目的:召集 9 位知名思想家的多专家商业策略分析。
语法:/sc:business-panel "内容" [--mode discussion|debate|socratic] [--experts "name1,name2"]
使用场景:
- 策略评估:
/sc:business-panel "我们的市场进入策略" - 竞争分析:
/sc:business-panel @competitor_analysis.pdf --mode debate - 创新评估:
/sc:business-panel "AI 产品想法" --experts "christensen,drucker" - 策略学习:
/sc:business-panel "竞争策略" --mode socratic
专家阵容:Christensen、Porter、Drucker、Godin、Kim/Mauborgne、Collins、Taleb、Meadows、Doumont。
源码级行为(见 business-panel.md):支持三阶段分析模式——DISCUSSION(默认,专家互相补充)、DEBATE(对抗性质疑)、SOCRATIC INQUIRY(提问驱动探索),并提供 --synthesis-only(跳过详细分析直接输出综合结论)、--structured(符号系统提效)、--verbose、--questions 等输出选项。该命令与所有思考类标志兼容(--think、--think-hard、--ultrathink),默认只产出专家分析与建议,不代为实施商业决策。
/sc:spec-panel —— 专家规格评审
目的:调用知名规格与软件工程专家进行多专家规格评审与改进。
语法:/sc:spec-panel [内容|@文件] [--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]
使用场景:
- 规格评审:
/sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture - 需求工作坊:
/sc:spec-panel "用户故事内容" --mode discussion - 架构验证:
/sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture - 合规评审:
/sc:spec-panel @security_requirements.yml --focus compliance - 迭代改进:
/sc:spec-panel @complex_system.spec.yml --iterations 3
专家阵容:Wiegers、Adzic、Cockburn、Fowler、Nygard、Newman、Hohpe、Crispin、Gregory、Hightower。
源码级行为(见 spec-panel.md):10 位专家按领域划分为四组——需求工程(Wiegers 的 SMART 标准、Adzic 的 Given/When/Then 示例化、Cockburn 的用例方法)、技术架构(Fowler 的接口设计、Nygard 的失败模式、Newman 的微服务边界、Hohpe 的企业集成模式)、质量测试(Crispin、Gregory)与云原生(Hightower)。--focus 参数会动态组会:例如 --focus requirements 激活 Wiegers(主)、Adzic、Cockburn;--focus architecture 激活 Fowler(主)、Newman、Hohpe、Nygard。三种评审模式各有不同的专家互动模式:discussion 为顺序点评与共识构建、critique 为带严重度分级与优先级排序的系统评审、socratic 为学习导向的追问。--iterations N 支持多轮迭代改进(第 1 轮结构性问题、第 2 轮细节打磨、第 3 轮润色优化),并支持 standard/structured/detailed 三种输出格式。
/sc:troubleshoot —— 问题诊断
目的:基于根因分析的系统化问题诊断。
语法:/sc:troubleshoot "问题描述" [--type build|runtime|performance]
使用场景:
- 运行时错误:
/sc:troubleshoot "登录时 500 错误" - 构建失败:
/sc:troubleshoot --type build - 性能问题:
/sc:troubleshoot "页面加载缓慢"
源码级行为(见 troubleshoot.md):采用"先诊断、后修复"的安全策略——默认只诊断(分析 → 调查 → 调试 → 提出方案 → 停下展示给用户),只有显式加 --fix 标志并经用户确认后才应用修复。其源码触发模式为 [issue] [--type bug|build|performance|deployment] [--trace] [--fix],--type 取值范围比速查表更广,覆盖 bug、构建、性能、部署四类问题。
/sc:test —— 质量保证
目的:带覆盖率分析的全面测试。
语法:/sc:test [--type unit|integration|e2e] [--coverage] [--fix]
使用场景:
- 全量测试套件:
/sc:test --coverage - 单元测试:
/sc:test --type unit --watch - E2E 验证:
/sc:test --type e2e
源码级行为(见 test.md):自动检测测试框架与配置,执行阶段会激活 Playwright MCP 与 qa-specialist 专家画像——--type e2e 时自动启用浏览器测试能力(跨浏览器兼容、视觉验证、性能指标)。支持 --watch 连续监控模式与 --fix 自动修复简单失败。
/sc:improve —— 代码改进
目的:应用系统化的代码改进与优化。
语法:/sc:improve [路径] [--type performance|quality|security] [--preview]
使用场景:
- 常规改进:
/sc:improve src/ - 性能优化:
/sc:improve --type performance - 安全加固:
/sc:improve --type security
/sc:document —— 文档生成
目的:为代码与 API 生成全面文档。
语法:/sc:document [路径] [--type api|user-guide|technical] [--format markdown|html]
使用场景:
- API 文档:
/sc:document --type api - 用户指南:
/sc:document --type user-guide - 技术文档:
/sc:document --type technical
/sc:workflow —— 实现规划
目的:从需求生成结构化实现计划。
语法:/sc:workflow "功能描述" [--strategy agile|waterfall] [--format markdown]
使用场景:
- 功能规划:
/sc:workflow "用户认证" - 迭代规划:
/sc:workflow --strategy agile - 架构规划:
/sc:workflow "微服务迁移"
源码级行为(见 workflow.md):行为流为分析(解析 PRD 与功能规格)→ 规划(依赖映射与任务编排)→ 协调(激活多专家画像)→ 执行(生成结构化分步工作流)→ 验证(质量门禁)。同样声明"STOP AFTER PLAN CREATION"——只产出实现计划文档(claudedocs/workflow_*.md,含实施阶段、任务依赖、执行顺序、检查点与验证步骤),不写代码、不跑构建。
常见工作流:验证过的命令组合
单个命令解决单点问题,组合命令才能覆盖完整生命周期。以下是官方验证过的四类组合。
新项目搭建
/sc:brainstorm "项目概念" # 定义需求
/sc:design "系统架构" # 生成技术设计
/sc:workflow "实现计划" # 生成开发路线图
功能开发
/sc:implement "功能名" # 构建功能
/sc:test --coverage # 测试验证
/sc:document --type api # 生成文档
代码质量提升
/sc:analyze --focus quality # 评估当前状态
/sc:improve --preview # 预览改进项
/sc:test --coverage # 验证变更
缺陷调查
/sc:troubleshoot "问题描述" # 诊断问题
/sc:analyze --focus problem-area # 深入分析
/sc:improve --fix --safe-mode # 应用定向修复
规格开发
/sc:spec-panel @existing_spec.yml --mode critique # 专家评审
/sc:spec-panel @improved_spec.yml --iterations 2 # 迭代改进
/sc:document --type technical # 生成文档
完整命令参考:按类别速查
开发命令
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| workflow | 实现规划 | 项目路线图、迭代规划 |
| implement | 功能开发 | 全栈功能、API 开发 |
| build | 项目编译 | CI/CD、生产构建 |
| design | 系统架构 | API 规格、数据库模式 |
分析命令
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| analyze | 代码评估 | 质量审计、安全评审 |
| research | 智能检索式网页研究 | 技术调研、实时资讯、市场分析 |
| business-panel | 战略性分析 | 商业决策、竞争评估 |
| spec-panel | 规格评审 | 需求验证、架构分析 |
| troubleshoot | 问题诊断 | 缺陷调查、性能问题 |
| explain | 代码讲解 | 学习、代码评审 |
质量命令
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| improve | 代码改进 | 性能优化、重构 |
| cleanup | 技术债清理 | 死代码移除、整理 |
| test | 质量保证 | 测试自动化、覆盖率分析 |
| document | 文档化 | API 文档、用户指南 |
项目管理
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| estimate | 项目估算 | 时间线规划、资源分配 |
| task | 任务管理 | 复杂工作流、任务跟踪 |
| spawn | 元编排 | 大型项目、并行执行 |
工具命令
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| help | 列出所有命令 | 发现可用命令 |
| git | 版本控制 | 提交管理、分支策略 |
| index | 命令发现 | 功能探索、查找命令 |
会话命令
| 命令 | 目的 | 最佳用途 |
|---|---|---|
| load | 上下文加载 | 会话初始化、项目 onboarding |
| save | 会话持久化 | 检查点、上下文保留 |
| reflect | 任务验证 | 进度评估、完成验证 |
| select-tool | 工具优化 | 性能优化、工具选择 |
命令索引:按功能与复杂度检索
按功能划分:
- 规划:brainstorm、design、workflow、estimate
- 开发:implement、build、git
- 分析:analyze、business-panel、spec-panel、troubleshoot、explain
- 质量:improve、cleanup、test、document
- 管理:task、spawn、load、save、reflect
- 工具:help、index、select-tool
按复杂度划分:
- 初级:brainstorm、implement、analyze、test、help
- 中级:workflow、design、business-panel、spec-panel、improve、document
- 高级:spawn、task、select-tool、reflect
故障排查
命令问题:
- 找不到命令:检查安装
python3 -m SuperClaude --version - 无响应:重启 Claude Code 会话
- 处理延迟:无 MCP 服务器时使用
--no-mcp测试
快速修复:
- 重置会话:用
/sc:load重新初始化 - 检查状态:
SuperClaude install --list-components - 获取帮助:故障排查指南
行为标志:命令行为的调节器
命令的行为与深度由标志(flags)控制。大部分标志会自动激活——Claude Code 会基于请求中的关键词与模式读取相应的行为指令。核心分组如下(详见 flags 指南):
- 分析深度:
--think(标准结构化分析,约 4K token)、--think-hard(深析,约 10K token)、--ultrathink(最大深度,约 32K token); - MCP 服务器:
--c7/--context7、--seq/--sequential、--magic、--play/--playwright、--morph/--morphllm、--serena,以及全局的--all-mcp与--no-mcp; - 行为模式:
--brainstorm、--introspect、--task-manage、--orchestrate、--token-efficient/--uc; - 执行控制:
--loop、--safe-mode、--validate、--delegate、--concurrency、--iterations; - 输出优化:
--scope、--focus、--format。
标志之间存在优先级规则:安全第一(--safe-mode > --validate > 优化类)、显式优先(用户标志 > 自动检测)、深度层级(--ultrathink > --think-hard > --think)、--no-mcp 覆盖所有 MCP 标志、作用域按 system > project > module > file 递减。