SuperClaude 命令指南:用 /sc:* 斜杠命令与 @agent-* 专家构建 Claude Code 结构化开发工作流

原创2026-09-19 14:00:131,754 阅读
文章标签:人工智能AI AgentAgent 框架AI 技能开发工具CLI提示工程MCP 服务

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 等):修改命令的行为与分析深度。

上下文加载的四个环节

  1. 用户输入:输入 /sc:implement "认证系统";
  2. 上下文加载:Claude Code 读取 ~/.claude/superclaude/Commands/implement.md;
  3. 行为采纳:Claude 应用领域专业知识、工具选择逻辑与验证模式;
  4. 增强输出:产出包含安全考量和最佳实践的结构化实现。

核心要点:这不是传统意义上的软件执行,而是通过上下文管理构建精细的开发工作流。这一点在源码中可以得到印证——仓库的 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 递减。

下一步

登录后查看全文
SuperClaude_Framework