命令参考手册

版本: 4.1.9•总命令数: 29•更新时间: 2025年12月

这是 SuperClaude 框架的完整命令参考手册,包含所有斜杠命令的详细描述、参数、用法示例和最佳实践。

快速参考

分类	个命令
开发命令	/sc:implement /sc:build /sc:improve /sc:cleanup /sc:git
文档	/sc:document /sc:explain /sc:index
规划与需求	/sc:brainstorm /sc:design /sc:estimate /sc:workflow
项目管理	/sc:pm /sc:task /sc:spawn /sc:select-tool /sc:index-repo
研究与分析	/sc:research /sc:business-panel /sc:spec-panel
会话管理	/sc:load /sc:save /sc:agent
测试与质量	/sc:test /sc:analyze /sc:troubleshoot /sc:reflect
实用工具	/sc:help /sc:recommend

开发命令

5 个命令

/sc:implement

高级

具备智能角色激活和 MCP 集成的功能与代码实现

语法

/sc:implement [选项] "[功能描述]"

选项

标志	值	描述
--type	component, api, service, feature	指定构件类型：'component'（组件）、'api'（接口）、'service'（服务）或 'feature'（功能）。
--framework	react, vue, express 等	指定目标框架（如 react、vue）以定制代码生成模式。
--safe	-	启用保守模式：避免破坏性更改，专注于非破坏性更新。
--with-tests	-	自动生成单元测试和集成测试代码。

示例

React 组件实现

/sc:implement --type component --framework react "用户个人资料组件"

API 服务实现（安全模式 + 测试）

/sc:implement --type api --safe --with-tests "用户认证 API"

全栈功能

/sc:implement --type feature --with-tests "支付处理系统"

Vue 框架组件

/sc:implement --type component --framework vue "仪表板部件"

Express 后端服务

/sc:implement --type service --framework express --safe "文件上传服务"

React 安全组件（含测试）

/sc:implement --type component --framework react --safe --with-tests "管理员面板"

Next.js 页面实现

/sc:implement --type feature --framework nextjs "用户设置页面"

纯 API 实现（无测试）

/sc:implement --type api "通知端点"

/sc:build

高级

具备智能错误处理和优化的项目构建、编译和打包

语法

/sc:build [选项] [目标]

选项

标志	值	描述
--type	dev, prod, test	构建的目标环境：'dev'（开发）、'prod'（生产）或 'test'（测试）。
--clean	-	在开始前删除之前的构建产物。
--optimize	-	启用性能优化，如压缩和 tree-shaking。
--verbose	-	启用内部代理决策和状态变化的详细日志记录。

示例

开发环境构建

/sc:build --type dev

生产环境构建

/sc:build --type prod --clean --optimize

详细日志构建

/sc:build --verbose

/sc:improve

高级

系统化地改进代码质量、性能和可维护性

语法

/sc:improve [选项] [目标]

选项

标志	值	描述
--type	quality, performance, maintainability, style	改进的重点领域：'quality'（质量）、'performance'（性能）、'maintainability'（可维护性）或 'style'（风格）。
--safe	-	安全模式（保守改进）
--interactive	-	在应用每个改进建议前提示用户批准。
--preview	-	生成建议更改的综合差异预览，但不应用更改。
--validate	-	应用更改后运行验证步骤（如 linters、测试）。

示例

质量改进

/sc:improve --type quality src/auth

性能优化（安全模式）

/sc:improve --type performance --safe api/

交互式风格改进

/sc:improve --type style --interactive components/

可维护性改进（预览）

/sc:improve --type maintainability --preview src/utils

质量改进（验证 + 交互）

/sc:improve --type quality --validate --interactive src/services

安全性能优化（预览）

/sc:improve --type performance --safe --preview database/

综合质量审查

/sc:improve --type quality --validate --safe src/

风格统一（安全 + 预览）

/sc:improve --type style --safe --preview --validate components/

/sc:cleanup

高级

系统化地清理代码、移除死代码并优化项目结构

语法

/sc:cleanup [选项] [目标]

选项

标志	值	描述
--type	code, imports, files, all	清理目标：'code'（格式化）、'imports'（未使用）、'files'（临时文件）或 'all'（全部）。
--safe	-	安全模式（保守清理）
--aggressive	-	应用更严格的清理规则，可能显著改变代码结构。
--interactive	-	交互式清理
--preview	-	生成建议更改的综合差异预览，但不应用更改。

示例

安全代码清理

/sc:cleanup --type code --safe src/

导入清理

/sc:cleanup --type imports

综合交互式清理

/sc:cleanup --type all --interactive

激进文件清理（预览）

/sc:cleanup --type files --aggressive --preview

安全代码清理（预览）

/sc:cleanup --type code --safe --preview src/legacy

交互式导入清理

/sc:cleanup --type imports --interactive

综合激进清理

/sc:cleanup --type all --aggressive

安全综合清理（预览 + 交互）

/sc:cleanup --type all --safe --preview --interactive

/sc:git

基础

具备智能提交消息和工作流优化的 Git 操作

语法

/sc:git [选项] "[操作]"

选项

标志	值	描述
--smart-commit	-	使用 AI 分析暂存的更改并生成语义化的提交消息。
--interactive	-	通过分步提示引导完成 git 工作流。

示例

智能提交

/sc:git --smart-commit

创建功能分支

/sc:git "feature/user-auth"

交互式操作

/sc:git --interactive

文档

3 个命令

/sc:document

基础

为组件、函数、API 和功能生成重点文档

语法

/sc:document [选项] [目标]

选项

标志	值	描述
--type	inline, external, api, guide	目标格式：'inline'（内联注释）、'external'（markdown）、'api'（规格）或 'guide'（指南）。
--style	brief, detailed	详细程度：'brief'（摘要）或 'detailed'（完整规格）。

示例

内联文档

/sc:document --type inline src/utils.ts

API 文档

/sc:document --type api --style detailed api/

用户指南

/sc:document --type guide --style brief

/sc:explain

基础

提供代码、概念和系统行为的清晰解释

语法

/sc:explain [选项] "[目标]"

选项

标志	值	描述
--level	basic, intermediate, advanced	目标受众专业水平：'basic'（基础）、'intermediate'（中级）或 'advanced'（高级）。
--format	text, examples, interactive	解释格式：'text'（文本）、'examples'（示例）或 'interactive'（交互式）。
--context	[domain]	将解释上下文限制在特定领域（如 'auth'、'database'）。

示例

基础解释

/sc:explain --level basic src/auth/middleware.ts

高级详细解释

/sc:explain --level advanced --format examples "JWT 认证流程"

交互式解释

/sc:explain --format interactive "数据库优化"

/sc:index

基础

生成全面的项目文档和知识库

语法

/sc:index [选项] [目标]

选项

标志	值	描述
--type	docs, api, structure, readme	要生成的索引类型：'docs'（文档）、'api'（接口）、'structure'（结构）或 'readme'。
--format	md, json, yaml	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

文档索引

/sc:index --type docs

API 索引

/sc:index --type api --format json api/

项目结构索引

/sc:index --type structure --format yaml

规划与需求

4 个命令

/sc:brainstorm

高级

通过苏格拉底式对话和系统化探索进行交互式需求发现

语法

/sc:brainstorm [选项] "[主题/想法]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	选择战略方法：'systematic'（系统化）注重彻底性，'agile'（敏捷）注重速度，'enterprise'（企业级）注重规模。
--depth	shallow, normal, deep	控制分析深度：'shallow'（浅层）用于快速扫描，'deep'（深层）用于综合审查。
--parallel	-	启用并行探索路径

示例

系统化产品发现（深度分析）

/sc:brainstorm --strategy systematic --depth deep "AI 驱动的项目管理工具"

敏捷功能探索（并行路径）

/sc:brainstorm --strategy agile --parallel "实时协作功能"

企业解决方案验证

/sc:brainstorm --strategy enterprise "企业数据分析平台"

快速浅层探索

/sc:brainstorm --depth shallow "移动应用创意"

系统化并行深度探索

/sc:brainstorm --strategy systematic --depth deep --parallel "微服务架构"

敏捷迭代探索

/sc:brainstorm --strategy agile --depth normal "用户认证改进"

/sc:design

基础

设计系统架构、API 和组件接口，提供全面的规格说明

语法

/sc:design [选项] [目标]

选项

标志	值	描述
--type	architecture, api, component, database	设计类型
--format	diagram, spec, code	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

系统架构设计

/sc:design --type architecture --format diagram user-management-system

API 规格说明设计

/sc:design --type api --format spec payment-api

组件接口设计

/sc:design --type component --format code notification-service

数据库模式设计

/sc:design --type database --format diagram e-commerce-db

/sc:estimate

基础

为任务、功能或项目提供智能开发估算

语法

/sc:estimate [选项] "[目标]"

选项

标志	值	描述
--type	time, effort, complexity	估算类型
--unit	hours, days, weeks	时间单位
--breakdown	-	启用详细分解

示例

时间估算

/sc:estimate --type time --unit days "认证系统"

复杂度分析

/sc:estimate --type complexity --breakdown "API 重构"

/sc:workflow

高级

根据 PRD 和功能需求生成结构化的实施工作流

语法

/sc:workflow [选项] "[功能描述]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	工作流策略
--depth	shallow, normal, deep	工作流深度
--parallel	-	启用并行执行

示例

系统化工作流

/sc:workflow --strategy systematic "支付集成"

敏捷迭代工作流

/sc:workflow --strategy agile --depth deep "用户引导流程"

项目管理

5 个命令

/sc:pm

元级

项目管理代理 - 默认编排代理，无缝协调所有子代理并管理工作流

语法

/sc:pm [选项] "[请求]"

选项

标志	值	描述
--strategy	brainstorm, direct, wave	定义执行模式：'brainstorm'（头脑风暴）用于通过交互式提问进行探索性构思和需求发现（适用于模糊或不明确的请求），'direct'（直接）用于无需大量规划的即时实施（最适合范围明确的清晰任务），或 'wave'（波次）用于具有结构化实施阶段的分阶段推出（最适合需要系统化推进的复杂多阶段项目）。当需求需要澄清时选择 brainstorm，对于直接任务选择 direct，对于大规模变更选择 wave。
--verbose	-	启用内部代理决策、子代理激活、工作流状态变化和委派模式的详细日志记录。用于理解 PM 代理的推理过程、调试工作流问题、学习编排策略，或跟踪为特定任务激活了哪些专业代理。提供策略选择、任务分解逻辑和执行流程的透明度。

示例

默认用法（无需命令，直接描述需求，PM 代理自动处理编排）

/sc:pm "需要为应用添加支付处理功能"

显式策略选择（使用 wave 策略）

/sc:pm --strategy wave "提升应用安全性"

头脑风暴模式（PM 代理自动检测探索需求）

/sc:pm "也许我们可以改进用户体验？"

显式头脑风暴策略（强制需求发现）

/sc:pm --strategy brainstorm "为仪表板添加新功能"

直接策略（明确需求的即时实施）

/sc:pm --strategy direct "修复移动端登录按钮对齐问题"

详细模式（跟踪代理编排决策）

/sc:pm --verbose "重构 API 层"

波次策略与详细日志（复杂项目的可见性）

/sc:pm --strategy wave --verbose "从 REST 迁移到 GraphQL"

多阶段项目工作流（认证系统）

/sc:pm --strategy wave "实现完整的用户认证，包括 OAuth、2FA 和会话管理"

调试工作流（性能调查）

/sc:pm --verbose "调查并修复仪表板加载性能问题"

性能优化项目（系统化改进）

/sc:pm --strategy wave "优化前端、后端和数据库的应用性能"

/sc:task

高级

具备智能工作流管理和委派的复杂任务执行

语法

/sc:task [选项] "[任务描述]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	定义任务执行方法：'systematic'（系统化）用于有条不紊的逐步推进，每个阶段都有全面的规划和验证（最适合需要仔细分析的复杂陌生任务），'agile'（敏捷）用于频繁验证周期的迭代快速开发（适用于不断演变的需求或实验性功能），或 'enterprise'（企业级）用于具有治理、文档和跨团队协调的大规模操作（适用于影响多个系统的关键任务变更）。选择 systematic 注重彻底性，agile 注重速度和灵活性，或 enterprise 注重组织规模。
--parallel	-	当任务可以分解为无依赖子任务时，启用独立操作的并行执行。自动识别并发处理的机会以减少总执行时间。对于多文件编辑、批量操作或具有清晰组件边界的任务特别有效。在优化速度且操作没有顺序依赖时使用。
--delegate	-	根据任务领域和复杂度启用对专业子代理的智能委派。任务代理分析需求并将子任务路由到适当的专家（例如，UI 任务到 frontend-architect，认证任务到 security-engineer，优化任务到 performance-engineer）。用于跨越多个领域或需要专业知识的复杂任务。通过专家级执行提高质量。

示例

系统化任务执行

/sc:task --strategy systematic "实现认证"

并行任务执行与委派

/sc:task --parallel --delegate "重构 API 端点"

敏捷策略（迭代开发）

/sc:task --strategy agile "构建交互式数据可视化仪表板"

企业级策略（大规模迁移）

/sc:task --strategy enterprise "将 50+ 个微服务迁移到 Kubernetes"

并行执行（独立操作）

/sc:task --parallel "将所有组件 prop 类型更新为 TypeScript"

委派给专家（复杂领域任务）

/sc:task --delegate "为消息功能实现端到端加密"

系统化与并行化（彻底 + 快速）

/sc:task --strategy systematic --parallel "将遗留代码库重构为现代模式"

敏捷与完全委派和并行化（快速多领域开发）

/sc:task --strategy agile --delegate --parallel "在前端和后端添加实时协作功能"

/sc:spawn

元级

具备智能分解和委派的元系统任务编排

语法

/sc:spawn [复杂任务] [选项]

选项

标志	值	描述
--strategy	sequential, parallel, adaptive	定义任务协调方法：'sequential'（顺序）用于逐步执行，每个阶段必须在下一个阶段开始前完成（适用于具有严格顺序要求的依赖任务），'parallel'（并行）用于独立子任务的并发执行以最大化速度（最适合具有清晰边界且无依赖关系的任务），或 'adaptive'（自适应）用于分析复杂度并自动调整策略的智能动态路由（推荐用于具有混合依赖模式的复杂多领域项目）。选择 sequential 用于有序工作流，parallel 用于最大吞吐量，或 adaptive 用于不确定的复杂度。
--depth	normal, deep	控制任务分解粒度：'normal'（标准）提供主要阶段和组件的标准分解（适用于大多数结构清晰的项目），'deep'（深度）执行细粒度子任务的递归分解，并进行全面的依赖性分析（对于复杂的遗留系统、架构迁移或彻底规划至关重要时必不可少）。对于典型项目使用 normal，对于最大规划细节和风险缓解使用 deep。

示例

复杂功能实现

/sc:spawn "实现用户认证系统"

大规模系统操作

/sc:spawn --strategy adaptive --depth deep "将遗留单体应用迁移到微服务"

跨领域基础设施

/sc:spawn "建立带安全扫描的 CI/CD 流水线"

顺序策略（有序工作流）

/sc:spawn --strategy sequential "重新设计数据库架构并迁移生产数据"

并行策略（独立组件）

/sc:spawn --strategy parallel "同时实现 API 文档、客户端 SDK 和使用分析"

标准深度（标准规划）

/sc:spawn --depth normal "为应用添加多语言支持"

深度分解（全面分析）

/sc:spawn --depth deep "将单体应用重构为领域驱动的微服务"

并行 + 标准深度（快速标准项目）

/sc:spawn --strategy parallel --depth normal "为 iOS 和 Android 平台构建移动应用"

顺序 + 深度（复杂有序迁移）

/sc:spawn --strategy sequential --depth deep "将遗留 COBOL 系统现代化为云原生架构"

任务层次可视化

spawn 编排创建多级分解：

级别 1：高级阶段（PM Agent 协调）
  ├─ 级别 2：主要组件（Task Agent 执行）
  │   ├─ 级别 3：具体实现（专家代理）
  │   └─ 级别 4：细粒度子任务（仅 depth=deep）

示例："构建电子商务平台"
  ├─ 阶段 1：架构和设计
  │   ├─ 数据库架构设计（backend-architect）
  │   ├─ API 契约定义（backend-architect）
  │   └─ UI/UX 线框图（frontend-architect）
  ├─ 阶段 2：核心实现
  │   ├─ 产品目录（backend + frontend）
  │   ├─ 购物车（backend + frontend）
  │   └─ 支付集成（security-engineer + backend）
  └─ 阶段 3：测试和部署
      ├─ E2E 测试（quality-engineer）
      └─ 生产部署（devops-architect）

/sc:select-tool

基础

基于复杂度评分和操作分析的智能 MCP 工具选择

语法

/sc:select-tool [选项]

选项

标志	值	描述
--analyze	-	对当前项目上下文、任务复杂度和可用 MCP 工具进行深度分析，以推荐最佳工具选择。评估因素包括：代码库大小、操作类型、性能要求和工具能力。输出复杂度评分（0-1）、推荐工具和置信度。用于在执行前了解哪些工具最适合您的特定场景。
--explain	-	提供工具选择推荐背后的详细推理和决策逻辑。解释为什么选择特定工具而不是替代方案，包括权衡分析、能力匹配和效率考虑。教育模式，帮助用户学习工具选择模式并理解智能路由系统。与 --analyze 结合使用可获得全面的工具选择教育。

示例

分析工具选择

/sc:select-tool --analyze

解释工具选择推理

/sc:select-tool --explain

组合分析和解释（学习模式）

/sc:select-tool --analyze --explain

使用工具选择的性能优化工作流

# 步骤 1：分析性能任务的最佳工具
/sc:select-tool --analyze --explain

# 步骤 2：使用推荐的工具执行
# （基于分析：用于分析的 Sequential，用于代码导航的 Serena）

/sc:index-repo

基础

用于上下文优化的仓库索引（94% token 削减：58K → 3K）

语法

/sc:index-repo [路径]

示例

索引当前仓库

/sc:index-repo .

索引特定目录

/sc:index-repo src/

大型仓库性能指标

/sc:index-repo .

增量重新索引工作流

# 初始索引
/sc:index-repo .

# 重大代码更改后（例如，功能分支合并、重构）
/sc:index-repo .  # 重新索引以更新项目理解

# 针对特定更改区域进行更快更新
/sc:index-repo src/features/authentication/

多模块项目索引策略

# 包含多个包的 monorepo
/sc:index-repo packages/backend/    # 索引后端模块
/sc:index-repo packages/frontend/   # 索引前端模块
/sc:index-repo packages/shared/     # 索引共享工具

# 或一次索引整个 monorepo
/sc:index-repo .                    # 全面索引

研究与分析

3 个命令

/sc:research

高级

具备自适应规划和智能搜索的深度网络研究

语法

/sc:research [选项] "[查询]"

选项

标志	值	描述
--depth	quick, standard, deep, exhaustive	搜索深度：'quick'（快速摘要）、'standard'（标准）、'deep'（全面）或 'exhaustive'（详尽）。
--strategy	planning, intent, unified	研究方法：'planning'（规划）、'intent'（意图）或 'unified'（统一）。

示例

基础研究（默认深度）

/sc:research "2024 量子计算最新进展"

深度竞争分析

/sc:research --depth deep "AI 编码助手竞争分析"

统一策略研究

/sc:research --strategy unified "分布式系统最佳实践"

快速事实查询

/sc:research --depth quick "当前 React 版本"

学术级深度研究

/sc:research --depth exhaustive "机器学习优化技术"

意图规划研究

/sc:research --strategy intent "云架构模式"

深度 + 规划组合

/sc:research --depth deep --strategy planning "微服务安全最佳实践"

标准研究（显式）

/sc:research --depth standard "数据库扩展策略"

/sc:business-panel

高级

由 9 位著名商业思想家组成的多专家商业战略分析

语法

/sc:business-panel [选项] "[主题]"

选项

标志	值	描述
--mode	discussion, debate, socratic	分析模式
--experts	[name1,name2,...]	专家选择

示例

市场进入战略分析

/sc:business-panel --mode discussion "市场进入战略"

辩论模式

/sc:business-panel --mode debate --experts porter,godin "定价策略"

苏格拉底式探索

/sc:business-panel --mode socratic "数字化转型"

/sc:spec-panel

高级

由著名软件工程专家进行的多专家规格说明审查和改进

语法

/sc:spec-panel [选项] "[规格说明]"

选项

标志	值	描述
--mode	discussion, critique, socratic	审查模式
--experts	[name1,name2,...]	专家选择
--focus	requirements, architecture, testing, compliance	审查重点
--iterations	[N]	迭代次数
--format	standard, structured, detailed	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

需求规格说明审查

/sc:spec-panel --focus requirements "API 规格说明"

架构批判模式

/sc:spec-panel --mode critique --focus architecture "微服务设计"

详细迭代审查

/sc:spec-panel --iterations 3 --format detailed "安全策略"

苏格拉底式测试审查

/sc:spec-panel --mode socratic --focus testing "测试覆盖率策略"

合规讨论审查

/sc:spec-panel --mode discussion --focus compliance "GDPR 要求"

特定专家架构审查

/sc:spec-panel --experts fowler,beck --focus architecture "领域驱动设计"

多轮结构化需求审查

/sc:spec-panel --iterations 5 --format structured --focus requirements "用户故事"

批判模式测试审查（详细）

/sc:spec-panel --mode critique --focus testing --format detailed "集成测试"

综合规格说明审查

/sc:spec-panel --mode discussion --focus requirements --iterations 3 --format detailed "系统规格说明"

会话管理

3 个命令

/sc:load

基础

具备 Serena MCP 集成的会话生命周期管理，用于项目上下文加载

语法

/sc:load [目标] [选项]

选项

标志	值	描述
--type	project, config, deps, checkpoint	加载类型
--refresh	-	刷新缓存
--analyze	-	启用分析

示例

加载项目上下文

/sc:load --type project src/

加载检查点

/sc:load --type checkpoint "auth-feature"

刷新并分析

/sc:load --refresh --analyze

/sc:save

基础

具备 Serena MCP 集成的会话生命周期管理，用于会话上下文持久化

语法

/sc:save [名称] [选项]

选项

标志	值	描述
--type	session, learnings, context, all	保存类型
--summarize	-	生成摘要
--checkpoint	-	创建检查点

示例

保存会话

/sc:save --type session "auth-complete"

保存学习成果

/sc:save --type learnings --summarize

创建检查点

/sc:save --checkpoint "midpoint"

/sc:agent

高级

SC 代理 - 编排调查、实施和审查完整工作流的会话控制器

语法

示例

代理在会话开始时自动启动，用户描述任务后接管完整工作流

/sc:agent # 无需手动调用，自动激活

测试与质量

4 个命令

/sc:test

高级

执行测试，提供覆盖率分析和自动化质量报告

语法

/sc:test [选项] [目标]

选项

标志	值	描述
--type	unit, integration, e2e, all	测试范围：'unit'（单元）、'integration'（集成）、'e2e'（端到端）或 'all'（全部）。
--coverage	-	生成代码覆盖率报告，标识未测试的代码行。
--watch	-	检测到文件更改时自动重新运行测试。
--fix	-	尝试自动解决格式化或快照不匹配等轻微测试失败。

示例

基础测试执行

/sc:test

单元测试覆盖率分析

/sc:test --type unit --coverage src/components

端到端浏览器测试

/sc:test --type e2e

开发监听模式（自动修复）

/sc:test --watch --fix

集成测试

/sc:test --type integration

综合测试（含覆盖率）

/sc:test --type all --coverage

单元测试监听模式

/sc:test --type unit --watch

端到端测试（自动修复）

/sc:test --type e2e --fix

覆盖率监听模式

/sc:test --coverage --watch

/sc:analyze

基础

跨质量、安全、性能和架构领域的综合代码分析

语法

/sc:analyze [选项] [目标]

选项

标志	值	描述
--focus	quality, security, performance, architecture	分析领域：'quality'（质量）、'security'（安全）、'performance'（性能）或 'architecture'（架构）。
--depth	quick, deep	控制分析深度：'shallow'（快速扫描）、'deep'（全面审查）。
--format	text, json, report	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

综合项目分析

/sc:analyze

聚焦安全评估（深度）

/sc:analyze --focus security --depth deep src/auth

性能优化分析（报告格式）

/sc:analyze --focus performance --format report

快速质量检查

/sc:analyze --focus quality --depth quick src/components

架构深度分析（JSON 输出）

/sc:analyze --focus architecture --depth deep --format json

安全快速扫描

/sc:analyze --focus security --depth quick

性能深度分析

/sc:analyze --focus performance --depth deep api/

质量报告（深度）

/sc:analyze --focus quality --depth deep --format report src/

/sc:troubleshoot

基础

诊断和解决代码、构建、部署和系统行为中的问题

语法

/sc:troubleshoot [选项] "[问题描述]"

选项

标志	值	描述
--type	bug, build, performance, deployment	问题类别：'bug'（缺陷）、'build'（构建）、'performance'（性能）或 'deployment'（部署）。
--trace	-	输出详细的执行跟踪以精确定位故障源。
--fix	-	尝试自动为已识别的问题应用补丁。

示例

缺陷诊断

/sc:troubleshoot --type bug "登录表单无法提交"

构建问题

/sc:troubleshoot --type build --trace "CI 构建失败"

性能问题

/sc:troubleshoot --type performance --fix "API 响应缓慢"

/sc:reflect

基础

使用 Serena MCP 分析能力进行任务反思和验证

语法

/sc:reflect [选项] [目标]

选项

标志	值	描述
--type	task, session, completion	反思范围：'task'（当前任务）、'session'（会话历史）或 'completion'（目标检查）。
--analyze	-	执行详尽推理以发现隐藏的模式或风险。
--validate	-	应用更改后运行验证步骤（如 linters、测试）。

示例

任务反思

/sc:reflect --type task --analyze

会话审查

/sc:reflect --type session

完成验证

/sc:reflect --type completion --validate

实用工具

2 个命令

/sc:help

基础

列出所有可用的 /sc 命令及其功能

语法

/sc:help [命令名称]

示例

显示所有命令帮助

/sc:help

特定命令帮助

/sc:help implement

系统指南

MCP 服务器集成

可用服务器

服务器	用途	API 密钥	自动激活触发器
context7	官方库文档	否	导入语句、框架关键词
sequential	多步推理	否	`--think`、调试、复杂分析
magic	UI 组件生成	是	`component`、`UI`、前端请求
playwright	浏览器自动化	否	`test`、`e2e`、`browser`
morphllm	代码转换	是	多文件编辑、重构
serena	语义代码理解	否	大型项目、会话管理
tavily	网络搜索	是（免费层）	`/sc:research`、`latest`
chrome-devtools	性能分析	否	`performance`、`debug`

服务器组合

yaml

免费（无需 API 密钥）:
  - context7 + sequential + playwright + serena

学习:
  - context7 + sequential

Web 开发:
  - magic + context7 + playwright

深度研究:
  - tavily + sequential + serena

企业级重构:
  - serena + morphllm + sequential

配置

MCP 服务器在 ~/.claude.json 中配置：

json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"}
    }
  }
}

最佳实践

1. 命令选择指南

场景	推荐命令	原因
新项目启动	`/sc:brainstorm`	结构化需求发现
功能实现	`/sc:implement`	智能角色协调
代码审查	`/sc:analyze`	多维度分析
测试执行	`/sc:test`	覆盖率和质量报告
深度研究	`/sc:research`	自适应多源搜索
日常任务	`/sc:pm`	自动编排（默认）

2. 标志组合模式

bash

# 深度安全分析
/sc:analyze --focus security --depth deep

# 全面测试
/sc:test --type all --coverage

# 安全实现
/sc:implement "功能" --safe --with-tests

# 详细研究
/sc:research "主题" --depth exhaustive --strategy unified

3. 工作流模式

新功能开发:

bash

/sc:brainstorm "功能创意" --strategy systematic
/sc:design "功能" --type architecture
/sc:workflow "实施计划"
/sc:implement "功能" --with-tests
/sc:test --coverage
/sc:document --type api

缺陷修复:

bash

/sc:troubleshoot "缺陷描述" --trace
/sc:analyze --focus quality --depth deep
/sc:implement "修复" --safe
/sc:test --type regression

代码优化:

bash

/sc:analyze --focus performance
/sc:improve --type performance --safe
/sc:cleanup --type all --interactive
/sc:test --coverage

4. Token 效率

任务复杂度	Token 预算	推荐方法
简单（拼写错误）	200	直接修复
中等（缺陷修复）	1,000	置信度检查
复杂（新功能）	2,500	完整工作流

置信度检查投资回报率: 花费 100-200 个 token 可节省 5,000-50,000 个 token

快速参考卡

核心命令

bash

# 发现与规划
/sc:brainstorm "创意"        # 结构化头脑风暴
/sc:design "系统"            # 架构设计
/sc:workflow "任务"          # 工作流规划

# 开发
/sc:implement "功能"         # 代码实现
/sc:improve path/            # 代码改进
/sc:test --coverage          # 测试执行

# 研究
/sc:research "主题"          # 网络研究
/sc:analyze path/            # 代码分析

# 会话管理
/sc:save "检查点"            # 保存会话
/sc:load "会话"              # 加载会话
/sc                          # 列出所有命令

常用标志

bash

--think         # 启用序列推理
--think-hard    # 启用深度分析
--c7            # 强制激活 Context7
--no-mcp        # 禁用 MCP 服务器
--all-mcp       # 启用所有 MCP 服务器
--coverage      # 包含测试覆盖率
--depth quick   # 研究深度控制
--safe          # 安全模式
--with-tests    # 包含测试
--interactive   # 交互模式

安装与升级

安装

安装 SuperClaude Framework CLI：

bash

npm install -g @superclaude/cli

或通过 npx 运行：

bash

npx @superclaude/cli init

升级

升级到最新版本：

bash

npm update -g @superclaude/cli

检查版本：

bash

/sc:version

命令参考手册

版本: 4.1.9•总命令数: 29•更新时间: 2025年12月

这是 SuperClaude 框架的完整命令参考手册,包含所有斜杠命令的详细描述、参数、用法示例和最佳实践。

快速参考

分类	个命令
开发命令	/sc:implement /sc:build /sc:improve /sc:cleanup /sc:git
文档	/sc:document /sc:explain /sc:index
规划与需求	/sc:brainstorm /sc:design /sc:estimate /sc:workflow
项目管理	/sc:pm /sc:task /sc:spawn /sc:select-tool /sc:index-repo
研究与分析	/sc:research /sc:business-panel /sc:spec-panel
会话管理	/sc:load /sc:save /sc:agent
测试与质量	/sc:test /sc:analyze /sc:troubleshoot /sc:reflect
实用工具	/sc:help /sc:recommend

开发命令

5 个命令

/sc:implement

高级

具备智能角色激活和 MCP 集成的功能与代码实现

语法

/sc:implement [选项] "[功能描述]"

选项

标志	值	描述
--type	component, api, service, feature	指定构件类型：'component'（组件）、'api'（接口）、'service'（服务）或 'feature'（功能）。
--framework	react, vue, express 等	指定目标框架（如 react、vue）以定制代码生成模式。
--safe	-	启用保守模式：避免破坏性更改，专注于非破坏性更新。
--with-tests	-	自动生成单元测试和集成测试代码。

示例

React 组件实现

/sc:implement --type component --framework react "用户个人资料组件"

API 服务实现（安全模式 + 测试）

/sc:implement --type api --safe --with-tests "用户认证 API"

全栈功能

/sc:implement --type feature --with-tests "支付处理系统"

Vue 框架组件

/sc:implement --type component --framework vue "仪表板部件"

Express 后端服务

/sc:implement --type service --framework express --safe "文件上传服务"

React 安全组件（含测试）

/sc:implement --type component --framework react --safe --with-tests "管理员面板"

Next.js 页面实现

/sc:implement --type feature --framework nextjs "用户设置页面"

纯 API 实现（无测试）

/sc:implement --type api "通知端点"

/sc:build

高级

具备智能错误处理和优化的项目构建、编译和打包

语法

/sc:build [选项] [目标]

选项

标志	值	描述
--type	dev, prod, test	构建的目标环境：'dev'（开发）、'prod'（生产）或 'test'（测试）。
--clean	-	在开始前删除之前的构建产物。
--optimize	-	启用性能优化，如压缩和 tree-shaking。
--verbose	-	启用内部代理决策和状态变化的详细日志记录。

示例

开发环境构建

/sc:build --type dev

生产环境构建

/sc:build --type prod --clean --optimize

详细日志构建

/sc:build --verbose

/sc:improve

高级

系统化地改进代码质量、性能和可维护性

语法

/sc:improve [选项] [目标]

选项

标志	值	描述
--type	quality, performance, maintainability, style	改进的重点领域：'quality'（质量）、'performance'（性能）、'maintainability'（可维护性）或 'style'（风格）。
--safe	-	安全模式（保守改进）
--interactive	-	在应用每个改进建议前提示用户批准。
--preview	-	生成建议更改的综合差异预览，但不应用更改。
--validate	-	应用更改后运行验证步骤（如 linters、测试）。

示例

质量改进

/sc:improve --type quality src/auth

性能优化（安全模式）

/sc:improve --type performance --safe api/

交互式风格改进

/sc:improve --type style --interactive components/

可维护性改进（预览）

/sc:improve --type maintainability --preview src/utils

质量改进（验证 + 交互）

/sc:improve --type quality --validate --interactive src/services

安全性能优化（预览）

/sc:improve --type performance --safe --preview database/

综合质量审查

/sc:improve --type quality --validate --safe src/

风格统一（安全 + 预览）

/sc:improve --type style --safe --preview --validate components/

/sc:cleanup

高级

系统化地清理代码、移除死代码并优化项目结构

语法

/sc:cleanup [选项] [目标]

选项

标志	值	描述
--type	code, imports, files, all	清理目标：'code'（格式化）、'imports'（未使用）、'files'（临时文件）或 'all'（全部）。
--safe	-	安全模式（保守清理）
--aggressive	-	应用更严格的清理规则，可能显著改变代码结构。
--interactive	-	交互式清理
--preview	-	生成建议更改的综合差异预览，但不应用更改。

示例

安全代码清理

/sc:cleanup --type code --safe src/

导入清理

/sc:cleanup --type imports

综合交互式清理

/sc:cleanup --type all --interactive

激进文件清理（预览）

/sc:cleanup --type files --aggressive --preview

安全代码清理（预览）

/sc:cleanup --type code --safe --preview src/legacy

交互式导入清理

/sc:cleanup --type imports --interactive

综合激进清理

/sc:cleanup --type all --aggressive

安全综合清理（预览 + 交互）

/sc:cleanup --type all --safe --preview --interactive

/sc:git

基础

具备智能提交消息和工作流优化的 Git 操作

语法

/sc:git [选项] "[操作]"

选项

标志	值	描述
--smart-commit	-	使用 AI 分析暂存的更改并生成语义化的提交消息。
--interactive	-	通过分步提示引导完成 git 工作流。

示例

智能提交

/sc:git --smart-commit

创建功能分支

/sc:git "feature/user-auth"

交互式操作

/sc:git --interactive

文档

3 个命令

/sc:document

基础

为组件、函数、API 和功能生成重点文档

语法

/sc:document [选项] [目标]

选项

标志	值	描述
--type	inline, external, api, guide	目标格式：'inline'（内联注释）、'external'（markdown）、'api'（规格）或 'guide'（指南）。
--style	brief, detailed	详细程度：'brief'（摘要）或 'detailed'（完整规格）。

示例

内联文档

/sc:document --type inline src/utils.ts

API 文档

/sc:document --type api --style detailed api/

用户指南

/sc:document --type guide --style brief

/sc:explain

基础

提供代码、概念和系统行为的清晰解释

语法

/sc:explain [选项] "[目标]"

选项

标志	值	描述
--level	basic, intermediate, advanced	目标受众专业水平：'basic'（基础）、'intermediate'（中级）或 'advanced'（高级）。
--format	text, examples, interactive	解释格式：'text'（文本）、'examples'（示例）或 'interactive'（交互式）。
--context	[domain]	将解释上下文限制在特定领域（如 'auth'、'database'）。

示例

基础解释

/sc:explain --level basic src/auth/middleware.ts

高级详细解释

/sc:explain --level advanced --format examples "JWT 认证流程"

交互式解释

/sc:explain --format interactive "数据库优化"

/sc:index

基础

生成全面的项目文档和知识库

语法

/sc:index [选项] [目标]

选项

标志	值	描述
--type	docs, api, structure, readme	要生成的索引类型：'docs'（文档）、'api'（接口）、'structure'（结构）或 'readme'。
--format	md, json, yaml	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

文档索引

/sc:index --type docs

API 索引

/sc:index --type api --format json api/

项目结构索引

/sc:index --type structure --format yaml

规划与需求

4 个命令

/sc:brainstorm

高级

通过苏格拉底式对话和系统化探索进行交互式需求发现

语法

/sc:brainstorm [选项] "[主题/想法]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	选择战略方法：'systematic'（系统化）注重彻底性，'agile'（敏捷）注重速度，'enterprise'（企业级）注重规模。
--depth	shallow, normal, deep	控制分析深度：'shallow'（浅层）用于快速扫描，'deep'（深层）用于综合审查。
--parallel	-	启用并行探索路径

示例

系统化产品发现（深度分析）

/sc:brainstorm --strategy systematic --depth deep "AI 驱动的项目管理工具"

敏捷功能探索（并行路径）

/sc:brainstorm --strategy agile --parallel "实时协作功能"

企业解决方案验证

/sc:brainstorm --strategy enterprise "企业数据分析平台"

快速浅层探索

/sc:brainstorm --depth shallow "移动应用创意"

系统化并行深度探索

/sc:brainstorm --strategy systematic --depth deep --parallel "微服务架构"

敏捷迭代探索

/sc:brainstorm --strategy agile --depth normal "用户认证改进"

/sc:design

基础

设计系统架构、API 和组件接口，提供全面的规格说明

语法

/sc:design [选项] [目标]

选项

标志	值	描述
--type	architecture, api, component, database	设计类型
--format	diagram, spec, code	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

系统架构设计

/sc:design --type architecture --format diagram user-management-system

API 规格说明设计

/sc:design --type api --format spec payment-api

组件接口设计

/sc:design --type component --format code notification-service

数据库模式设计

/sc:design --type database --format diagram e-commerce-db

/sc:estimate

基础

为任务、功能或项目提供智能开发估算

语法

/sc:estimate [选项] "[目标]"

选项

标志	值	描述
--type	time, effort, complexity	估算类型
--unit	hours, days, weeks	时间单位
--breakdown	-	启用详细分解

示例

时间估算

/sc:estimate --type time --unit days "认证系统"

复杂度分析

/sc:estimate --type complexity --breakdown "API 重构"

/sc:workflow

高级

根据 PRD 和功能需求生成结构化的实施工作流

语法

/sc:workflow [选项] "[功能描述]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	工作流策略
--depth	shallow, normal, deep	工作流深度
--parallel	-	启用并行执行

示例

系统化工作流

/sc:workflow --strategy systematic "支付集成"

敏捷迭代工作流

/sc:workflow --strategy agile --depth deep "用户引导流程"

项目管理

5 个命令

/sc:pm

元级

项目管理代理 - 默认编排代理，无缝协调所有子代理并管理工作流

语法

/sc:pm [选项] "[请求]"

选项

标志	值	描述
--strategy	brainstorm, direct, wave	定义执行模式：'brainstorm'（头脑风暴）用于通过交互式提问进行探索性构思和需求发现（适用于模糊或不明确的请求），'direct'（直接）用于无需大量规划的即时实施（最适合范围明确的清晰任务），或 'wave'（波次）用于具有结构化实施阶段的分阶段推出（最适合需要系统化推进的复杂多阶段项目）。当需求需要澄清时选择 brainstorm，对于直接任务选择 direct，对于大规模变更选择 wave。
--verbose	-	启用内部代理决策、子代理激活、工作流状态变化和委派模式的详细日志记录。用于理解 PM 代理的推理过程、调试工作流问题、学习编排策略，或跟踪为特定任务激活了哪些专业代理。提供策略选择、任务分解逻辑和执行流程的透明度。

示例

默认用法（无需命令，直接描述需求，PM 代理自动处理编排）

/sc:pm "需要为应用添加支付处理功能"

显式策略选择（使用 wave 策略）

/sc:pm --strategy wave "提升应用安全性"

头脑风暴模式（PM 代理自动检测探索需求）

/sc:pm "也许我们可以改进用户体验？"

显式头脑风暴策略（强制需求发现）

/sc:pm --strategy brainstorm "为仪表板添加新功能"

直接策略（明确需求的即时实施）

/sc:pm --strategy direct "修复移动端登录按钮对齐问题"

详细模式（跟踪代理编排决策）

/sc:pm --verbose "重构 API 层"

波次策略与详细日志（复杂项目的可见性）

/sc:pm --strategy wave --verbose "从 REST 迁移到 GraphQL"

多阶段项目工作流（认证系统）

/sc:pm --strategy wave "实现完整的用户认证，包括 OAuth、2FA 和会话管理"

调试工作流（性能调查）

/sc:pm --verbose "调查并修复仪表板加载性能问题"

性能优化项目（系统化改进）

/sc:pm --strategy wave "优化前端、后端和数据库的应用性能"

/sc:task

高级

具备智能工作流管理和委派的复杂任务执行

语法

/sc:task [选项] "[任务描述]"

选项

标志	值	描述
--strategy	systematic, agile, enterprise	定义任务执行方法：'systematic'（系统化）用于有条不紊的逐步推进，每个阶段都有全面的规划和验证（最适合需要仔细分析的复杂陌生任务），'agile'（敏捷）用于频繁验证周期的迭代快速开发（适用于不断演变的需求或实验性功能），或 'enterprise'（企业级）用于具有治理、文档和跨团队协调的大规模操作（适用于影响多个系统的关键任务变更）。选择 systematic 注重彻底性，agile 注重速度和灵活性，或 enterprise 注重组织规模。
--parallel	-	当任务可以分解为无依赖子任务时，启用独立操作的并行执行。自动识别并发处理的机会以减少总执行时间。对于多文件编辑、批量操作或具有清晰组件边界的任务特别有效。在优化速度且操作没有顺序依赖时使用。
--delegate	-	根据任务领域和复杂度启用对专业子代理的智能委派。任务代理分析需求并将子任务路由到适当的专家（例如，UI 任务到 frontend-architect，认证任务到 security-engineer，优化任务到 performance-engineer）。用于跨越多个领域或需要专业知识的复杂任务。通过专家级执行提高质量。

示例

系统化任务执行

/sc:task --strategy systematic "实现认证"

并行任务执行与委派

/sc:task --parallel --delegate "重构 API 端点"

敏捷策略（迭代开发）

/sc:task --strategy agile "构建交互式数据可视化仪表板"

企业级策略（大规模迁移）

/sc:task --strategy enterprise "将 50+ 个微服务迁移到 Kubernetes"

并行执行（独立操作）

/sc:task --parallel "将所有组件 prop 类型更新为 TypeScript"

委派给专家（复杂领域任务）

/sc:task --delegate "为消息功能实现端到端加密"

系统化与并行化（彻底 + 快速）

/sc:task --strategy systematic --parallel "将遗留代码库重构为现代模式"

敏捷与完全委派和并行化（快速多领域开发）

/sc:task --strategy agile --delegate --parallel "在前端和后端添加实时协作功能"

/sc:spawn

元级

具备智能分解和委派的元系统任务编排

语法

/sc:spawn [复杂任务] [选项]

选项

标志	值	描述
--strategy	sequential, parallel, adaptive	定义任务协调方法：'sequential'（顺序）用于逐步执行，每个阶段必须在下一个阶段开始前完成（适用于具有严格顺序要求的依赖任务），'parallel'（并行）用于独立子任务的并发执行以最大化速度（最适合具有清晰边界且无依赖关系的任务），或 'adaptive'（自适应）用于分析复杂度并自动调整策略的智能动态路由（推荐用于具有混合依赖模式的复杂多领域项目）。选择 sequential 用于有序工作流，parallel 用于最大吞吐量，或 adaptive 用于不确定的复杂度。
--depth	normal, deep	控制任务分解粒度：'normal'（标准）提供主要阶段和组件的标准分解（适用于大多数结构清晰的项目），'deep'（深度）执行细粒度子任务的递归分解，并进行全面的依赖性分析（对于复杂的遗留系统、架构迁移或彻底规划至关重要时必不可少）。对于典型项目使用 normal，对于最大规划细节和风险缓解使用 deep。

示例

复杂功能实现

/sc:spawn "实现用户认证系统"

大规模系统操作

/sc:spawn --strategy adaptive --depth deep "将遗留单体应用迁移到微服务"

跨领域基础设施

/sc:spawn "建立带安全扫描的 CI/CD 流水线"

顺序策略（有序工作流）

/sc:spawn --strategy sequential "重新设计数据库架构并迁移生产数据"

并行策略（独立组件）

/sc:spawn --strategy parallel "同时实现 API 文档、客户端 SDK 和使用分析"

标准深度（标准规划）

/sc:spawn --depth normal "为应用添加多语言支持"

深度分解（全面分析）

/sc:spawn --depth deep "将单体应用重构为领域驱动的微服务"

并行 + 标准深度（快速标准项目）

/sc:spawn --strategy parallel --depth normal "为 iOS 和 Android 平台构建移动应用"

顺序 + 深度（复杂有序迁移）

/sc:spawn --strategy sequential --depth deep "将遗留 COBOL 系统现代化为云原生架构"

任务层次可视化

spawn 编排创建多级分解：

级别 1：高级阶段（PM Agent 协调）
  ├─ 级别 2：主要组件（Task Agent 执行）
  │   ├─ 级别 3：具体实现（专家代理）
  │   └─ 级别 4：细粒度子任务（仅 depth=deep）

示例："构建电子商务平台"
  ├─ 阶段 1：架构和设计
  │   ├─ 数据库架构设计（backend-architect）
  │   ├─ API 契约定义（backend-architect）
  │   └─ UI/UX 线框图（frontend-architect）
  ├─ 阶段 2：核心实现
  │   ├─ 产品目录（backend + frontend）
  │   ├─ 购物车（backend + frontend）
  │   └─ 支付集成（security-engineer + backend）
  └─ 阶段 3：测试和部署
      ├─ E2E 测试（quality-engineer）
      └─ 生产部署（devops-architect）

/sc:select-tool

基础

基于复杂度评分和操作分析的智能 MCP 工具选择

语法

/sc:select-tool [选项]

选项

标志	值	描述
--analyze	-	对当前项目上下文、任务复杂度和可用 MCP 工具进行深度分析，以推荐最佳工具选择。评估因素包括：代码库大小、操作类型、性能要求和工具能力。输出复杂度评分（0-1）、推荐工具和置信度。用于在执行前了解哪些工具最适合您的特定场景。
--explain	-	提供工具选择推荐背后的详细推理和决策逻辑。解释为什么选择特定工具而不是替代方案，包括权衡分析、能力匹配和效率考虑。教育模式，帮助用户学习工具选择模式并理解智能路由系统。与 --analyze 结合使用可获得全面的工具选择教育。

示例

分析工具选择

/sc:select-tool --analyze

解释工具选择推理

/sc:select-tool --explain

组合分析和解释（学习模式）

/sc:select-tool --analyze --explain

使用工具选择的性能优化工作流

# 步骤 1：分析性能任务的最佳工具
/sc:select-tool --analyze --explain

# 步骤 2：使用推荐的工具执行
# （基于分析：用于分析的 Sequential，用于代码导航的 Serena）

/sc:index-repo

基础

用于上下文优化的仓库索引（94% token 削减：58K → 3K）

语法

/sc:index-repo [路径]

示例

索引当前仓库

/sc:index-repo .

索引特定目录

/sc:index-repo src/

大型仓库性能指标

/sc:index-repo .

增量重新索引工作流

# 初始索引
/sc:index-repo .

# 重大代码更改后（例如，功能分支合并、重构）
/sc:index-repo .  # 重新索引以更新项目理解

# 针对特定更改区域进行更快更新
/sc:index-repo src/features/authentication/

多模块项目索引策略

# 包含多个包的 monorepo
/sc:index-repo packages/backend/    # 索引后端模块
/sc:index-repo packages/frontend/   # 索引前端模块
/sc:index-repo packages/shared/     # 索引共享工具

# 或一次索引整个 monorepo
/sc:index-repo .                    # 全面索引

研究与分析

3 个命令

/sc:research

高级

具备自适应规划和智能搜索的深度网络研究

语法

/sc:research [选项] "[查询]"

选项

标志	值	描述
--depth	quick, standard, deep, exhaustive	搜索深度：'quick'（快速摘要）、'standard'（标准）、'deep'（全面）或 'exhaustive'（详尽）。
--strategy	planning, intent, unified	研究方法：'planning'（规划）、'intent'（意图）或 'unified'（统一）。

示例

基础研究（默认深度）

/sc:research "2024 量子计算最新进展"

深度竞争分析

/sc:research --depth deep "AI 编码助手竞争分析"

统一策略研究

/sc:research --strategy unified "分布式系统最佳实践"

快速事实查询

/sc:research --depth quick "当前 React 版本"

学术级深度研究

/sc:research --depth exhaustive "机器学习优化技术"

意图规划研究

/sc:research --strategy intent "云架构模式"

深度 + 规划组合

/sc:research --depth deep --strategy planning "微服务安全最佳实践"

标准研究（显式）

/sc:research --depth standard "数据库扩展策略"

/sc:business-panel

高级

由 9 位著名商业思想家组成的多专家商业战略分析

语法

/sc:business-panel [选项] "[主题]"

选项

标志	值	描述
--mode	discussion, debate, socratic	分析模式
--experts	[name1,name2,...]	专家选择

示例

市场进入战略分析

/sc:business-panel --mode discussion "市场进入战略"

辩论模式

/sc:business-panel --mode debate --experts porter,godin "定价策略"

苏格拉底式探索

/sc:business-panel --mode socratic "数字化转型"

/sc:spec-panel

高级

由著名软件工程专家进行的多专家规格说明审查和改进

语法

/sc:spec-panel [选项] "[规格说明]"

选项

标志	值	描述
--mode	discussion, critique, socratic	审查模式
--experts	[name1,name2,...]	专家选择
--focus	requirements, architecture, testing, compliance	审查重点
--iterations	[N]	迭代次数
--format	standard, structured, detailed	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

需求规格说明审查

/sc:spec-panel --focus requirements "API 规格说明"

架构批判模式

/sc:spec-panel --mode critique --focus architecture "微服务设计"

详细迭代审查

/sc:spec-panel --iterations 3 --format detailed "安全策略"

苏格拉底式测试审查

/sc:spec-panel --mode socratic --focus testing "测试覆盖率策略"

合规讨论审查

/sc:spec-panel --mode discussion --focus compliance "GDPR 要求"

特定专家架构审查

/sc:spec-panel --experts fowler,beck --focus architecture "领域驱动设计"

多轮结构化需求审查

/sc:spec-panel --iterations 5 --format structured --focus requirements "用户故事"

批判模式测试审查（详细）

/sc:spec-panel --mode critique --focus testing --format detailed "集成测试"

综合规格说明审查

/sc:spec-panel --mode discussion --focus requirements --iterations 3 --format detailed "系统规格说明"

会话管理

3 个命令

/sc:load

基础

具备 Serena MCP 集成的会话生命周期管理，用于项目上下文加载

语法

/sc:load [目标] [选项]

选项

标志	值	描述
--type	project, config, deps, checkpoint	加载类型
--refresh	-	刷新缓存
--analyze	-	启用分析

示例

加载项目上下文

/sc:load --type project src/

加载检查点

/sc:load --type checkpoint "auth-feature"

刷新并分析

/sc:load --refresh --analyze

/sc:save

基础

具备 Serena MCP 集成的会话生命周期管理，用于会话上下文持久化

语法

/sc:save [名称] [选项]

选项

标志	值	描述
--type	session, learnings, context, all	保存类型
--summarize	-	生成摘要
--checkpoint	-	创建检查点

示例

保存会话

/sc:save --type session "auth-complete"

保存学习成果

/sc:save --type learnings --summarize

创建检查点

/sc:save --checkpoint "midpoint"

/sc:agent

高级

SC 代理 - 编排调查、实施和审查完整工作流的会话控制器

语法

示例

代理在会话开始时自动启动，用户描述任务后接管完整工作流

/sc:agent # 无需手动调用，自动激活

测试与质量

4 个命令

/sc:test

高级

执行测试，提供覆盖率分析和自动化质量报告

语法

/sc:test [选项] [目标]

选项

标志	值	描述
--type	unit, integration, e2e, all	测试范围：'unit'（单元）、'integration'（集成）、'e2e'（端到端）或 'all'（全部）。
--coverage	-	生成代码覆盖率报告，标识未测试的代码行。
--watch	-	检测到文件更改时自动重新运行测试。
--fix	-	尝试自动解决格式化或快照不匹配等轻微测试失败。

示例

基础测试执行

/sc:test

单元测试覆盖率分析

/sc:test --type unit --coverage src/components

端到端浏览器测试

/sc:test --type e2e

开发监听模式（自动修复）

/sc:test --watch --fix

集成测试

/sc:test --type integration

综合测试（含覆盖率）

/sc:test --type all --coverage

单元测试监听模式

/sc:test --type unit --watch

端到端测试（自动修复）

/sc:test --type e2e --fix

覆盖率监听模式

/sc:test --coverage --watch

/sc:analyze

基础

跨质量、安全、性能和架构领域的综合代码分析

语法

/sc:analyze [选项] [目标]

选项

标志	值	描述
--focus	quality, security, performance, architecture	分析领域：'quality'（质量）、'security'（安全）、'performance'（性能）或 'architecture'（架构）。
--depth	quick, deep	控制分析深度：'shallow'（快速扫描）、'deep'（全面审查）。
--format	text, json, report	结果格式：'text'（文本）、'json' 或 'report'（报告）。

示例

综合项目分析

/sc:analyze

聚焦安全评估（深度）

/sc:analyze --focus security --depth deep src/auth

性能优化分析（报告格式）

/sc:analyze --focus performance --format report

快速质量检查

/sc:analyze --focus quality --depth quick src/components

架构深度分析（JSON 输出）

/sc:analyze --focus architecture --depth deep --format json

安全快速扫描

/sc:analyze --focus security --depth quick

性能深度分析

/sc:analyze --focus performance --depth deep api/

质量报告（深度）

/sc:analyze --focus quality --depth deep --format report src/

/sc:troubleshoot

基础

诊断和解决代码、构建、部署和系统行为中的问题

语法

/sc:troubleshoot [选项] "[问题描述]"

选项

标志	值	描述
--type	bug, build, performance, deployment	问题类别：'bug'（缺陷）、'build'（构建）、'performance'（性能）或 'deployment'（部署）。
--trace	-	输出详细的执行跟踪以精确定位故障源。
--fix	-	尝试自动为已识别的问题应用补丁。

示例

缺陷诊断

/sc:troubleshoot --type bug "登录表单无法提交"

构建问题

/sc:troubleshoot --type build --trace "CI 构建失败"

性能问题

/sc:troubleshoot --type performance --fix "API 响应缓慢"

/sc:reflect

基础

使用 Serena MCP 分析能力进行任务反思和验证

语法

/sc:reflect [选项] [目标]

选项

标志	值	描述
--type	task, session, completion	反思范围：'task'（当前任务）、'session'（会话历史）或 'completion'（目标检查）。
--analyze	-	执行详尽推理以发现隐藏的模式或风险。
--validate	-	应用更改后运行验证步骤（如 linters、测试）。

示例

任务反思

/sc:reflect --type task --analyze

会话审查

/sc:reflect --type session

完成验证

/sc:reflect --type completion --validate

实用工具

2 个命令

/sc:help

基础

列出所有可用的 /sc 命令及其功能

语法

/sc:help [命令名称]

示例

显示所有命令帮助

/sc:help

特定命令帮助

/sc:help implement

系统指南

MCP 服务器集成

可用服务器

服务器	用途	API 密钥	自动激活触发器
context7	官方库文档	否	导入语句、框架关键词
sequential	多步推理	否	`--think`、调试、复杂分析
magic	UI 组件生成	是	`component`、`UI`、前端请求
playwright	浏览器自动化	否	`test`、`e2e`、`browser`
morphllm	代码转换	是	多文件编辑、重构
serena	语义代码理解	否	大型项目、会话管理
tavily	网络搜索	是（免费层）	`/sc:research`、`latest`
chrome-devtools	性能分析	否	`performance`、`debug`

服务器组合

yaml

免费（无需 API 密钥）:
  - context7 + sequential + playwright + serena

学习:
  - context7 + sequential

Web 开发:
  - magic + context7 + playwright

深度研究:
  - tavily + sequential + serena

企业级重构:
  - serena + morphllm + sequential

配置

MCP 服务器在 ~/.claude.json 中配置：

json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"}
    }
  }
}

最佳实践

1. 命令选择指南

场景	推荐命令	原因
新项目启动	`/sc:brainstorm`	结构化需求发现
功能实现	`/sc:implement`	智能角色协调
代码审查	`/sc:analyze`	多维度分析
测试执行	`/sc:test`	覆盖率和质量报告
深度研究	`/sc:research`	自适应多源搜索
日常任务	`/sc:pm`	自动编排（默认）

2. 标志组合模式

bash

# 深度安全分析
/sc:analyze --focus security --depth deep

# 全面测试
/sc:test --type all --coverage

# 安全实现
/sc:implement "功能" --safe --with-tests

# 详细研究
/sc:research "主题" --depth exhaustive --strategy unified

3. 工作流模式

新功能开发:

bash

/sc:brainstorm "功能创意" --strategy systematic
/sc:design "功能" --type architecture
/sc:workflow "实施计划"
/sc:implement "功能" --with-tests
/sc:test --coverage
/sc:document --type api

缺陷修复:

bash

/sc:troubleshoot "缺陷描述" --trace
/sc:analyze --focus quality --depth deep
/sc:implement "修复" --safe
/sc:test --type regression

代码优化:

bash

/sc:analyze --focus performance
/sc:improve --type performance --safe
/sc:cleanup --type all --interactive
/sc:test --coverage

4. Token 效率

任务复杂度	Token 预算	推荐方法
简单（拼写错误）	200	直接修复
中等（缺陷修复）	1,000	置信度检查
复杂（新功能）	2,500	完整工作流

置信度检查投资回报率: 花费 100-200 个 token 可节省 5,000-50,000 个 token

快速参考卡

核心命令

bash

# 发现与规划
/sc:brainstorm "创意"        # 结构化头脑风暴
/sc:design "系统"            # 架构设计
/sc:workflow "任务"          # 工作流规划

# 开发
/sc:implement "功能"         # 代码实现
/sc:improve path/            # 代码改进
/sc:test --coverage          # 测试执行

# 研究
/sc:research "主题"          # 网络研究
/sc:analyze path/            # 代码分析

# 会话管理
/sc:save "检查点"            # 保存会话
/sc:load "会话"              # 加载会话
/sc                          # 列出所有命令

常用标志

bash

--think         # 启用序列推理
--think-hard    # 启用深度分析
--c7            # 强制激活 Context7
--no-mcp        # 禁用 MCP 服务器
--all-mcp       # 启用所有 MCP 服务器
--coverage      # 包含测试覆盖率
--depth quick   # 研究深度控制
--safe          # 安全模式
--with-tests    # 包含测试
--interactive   # 交互模式

安装与升级

安装

安装 SuperClaude Framework CLI：

bash

npm install -g @superclaude/cli

或通过 npx 运行：

bash

npx @superclaude/cli init

升级

升级到最新版本：

bash

npm update -g @superclaude/cli

检查版本：

bash

/sc:version