SuperClaude 命令指南

SuperClaude 为 Claude Code 提供 21 个命令：用于工作流的 /sc:* 命令和用于专家的 @agent-*。

命令类型

快速测试

# 终端：验证安装
python3 -m SuperClaude --version
# Claude Code CLI 验证：claude --version

# Claude Code：测试命令
/sc:brainstorm "test project"    # 应该询问发现性问题
/sc:analyze README.md           # 应该提供分析

工作流：/sc:brainstorm "idea" → /sc:implement "feature" → /sc:test

🎯 理解 SuperClaude 命令

SuperClaude 如何工作

SuperClaude 提供行为上下文文件，Claude Code 通过读取这些文件来采用专门的行为。当您键入 /sc:implement 时，Claude Code 读取 implement.md 上下文文件并遵循其行为指令。

SuperClaude 命令不是由软件执行的 - 它们是上下文触发器，通过读取框架中的专门指令文件来修改 Claude Code 的行为。

命令类型：

• 斜杠命令 (/sc:*)：触发工作流模式和行为模式
• 智能体调用 (@agent-*)：手动激活特定领域专家
• 标志 (--think、--safe-mode)：修改命令行为和深度

上下文机制：

1. 用户输入：您输入 /sc:implement "auth system"
2. 上下文加载：Claude Code 读取 ~/.claude/superclaude/Commands/implement.md
3. 行为采用：Claude 运用专业知识进行工具选择和验证
4. 增强输出：带有安全考虑和最佳实践的结构化实现

关键要点：这通过上下文管理而不是传统的软件执行来创建复杂的开发工作流。

安装命令 vs 使用命令

🖥️ 终端命令 （实际 CLI 软件）：

• SuperClaude install - 安装框架组件
• SuperClaude update - 更新现有安装
• SuperClaude uninstall - 卸载框架安装
• python3 -m SuperClaude --version - 检查安装状态

💬 Claude Code 命令 （上下文触发器）：

• /sc:brainstorm - 激活需求发现上下文
• /sc:implement - 激活特性开发上下文
• @agent-security - 激活安全专家上下文
• 所有命令仅在 Claude Code 聊天界面中工作

快速开始：尝试 /sc:brainstorm "your project idea" → /sc:implement "feature name" → /sc:test 体验核心工作流。

🧪 Testing Your Setup

🖥️ 终端验证（在终端/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 "test project"
# 示例行为：开始交互式需求发现

# 测试命令帮助
/sc:help
# 示例行为：显示可用命令列表

如果测试失败：检查 安装指南 或 故障排除

📝 Command Quick Reference

记住：所有 /sc: 命令和 @agent- 调用都在 Claude Code 聊天中工作，而不是在您的终端中。它们触发 Claude Code 从 SuperClaude 框架中读取特定的上下文文件。

目录

• 基本命令 - 从这里开始（8 个核心命令）
• 常用工作流 - 有效的命令组合
• 完整命令参考 - 所有 21 个命令按类别组织
• 故障排除 - 常见问题和解决方案
• 命令索引 - 按类别查找命令

基本命令

立即提高生产力的核心工作流命令：

/sc:brainstorm - 项目发现

目的：交互式需求发现和项目规划 语法：/sc:brainstorm "您的想法" [--strategy systematic|creative]

使用案例：

• 新项目规划：/sc:brainstorm "e-commerce platform"
• 特性探索：/sc:brainstorm "user authentication system"
• 问题解决：`/sc:brainstorm "slow database queries"``

/sc:implement - 功能开发

目的: 通过智能专家路由进行全栈功能实现
语法: /sc:implement "feature description" [--type frontend|backend|fullstack] [--focus security|performance]

使用场景:

• 身份验证: /sc:implement "JWT login system"
• UI 组件: /sc:implement "responsive dashboard"
• APIs: /sc:implement "REST user endpoints"
• 数据库: /sc:implement "user schema with relationships"

/sc:analyze - 代码评估

目的: 跨质量、安全性和性能的综合代码分析
语法: /sc:analyze [path] [--focus quality|security|performance|architecture]

使用场景:

• 项目健康: /sc:analyze .
• 安全审计: /sc:analyze --focus security
• 性能评审: /sc:analyze --focus performance

/sc:troubleshoot - 问题诊断

目的: 系统化问题诊断与根本原因分析
语法: /sc:troubleshoot "问题描述" [--type build|runtime|performance]

使用场景:

• 运行时错误: /sc:troubleshoot "登录时出现500错误"
• 构建失败: /sc:troubleshoot --type build
• 性能问题: /sc:troubleshoot "页面加载缓慢"

/sc:test - 质量保证

目的: 全面测试与覆盖率分析
语法: /sc:test [--type unit|integration|e2e] [--coverage] [--fix]

使用场景:

• 完整测试套件: /sc:test --coverage
• 单元测试: /sc:test --type unit --watch
• 端到端验证: /sc:test --type e2e

/sc:improve - 代码增强

目的: 应用系统化的代码改进和优化
语法: /sc:improve [path] [--type performance|quality|security] [--preview]

使用场景:

• 常规改进: /sc:improve src/
• 性能优化: /sc:improve --type performance
• 安全加固: /sc:improve --type security

/sc:document - 文档生成

目的: 为代码和API生成全面的文档
语法: /sc:document [path] [--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 "微服务迁移"

常用工作流

经过验证的命令组合：

新项目设置

/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                   # 验证变更

Bug调查

/sc:troubleshoot "问题描述"            # 诊断问题
/sc:analyze --focus problem-area      # 深度分析
/sc:improve --fix --safe-mode         # 应用针对性修复

完整命令参考

开发命令

分析命令

质量命令

项目管理

实用工具命令

会话命令

命令索引

按功能分类：

• 规划: brainstorm, design, workflow, estimate
• 开发: implement, build, git
• 分析: analyze, troubleshoot, explain
• 质量: improve, cleanup, test, document
• 管理: task, spawn, load, save, reflect
• 工具: index, select-tool

按复杂度分类：

• 初学者: brainstorm, implement, analyze, test
• 中级: workflow, design, improve, document
• 高级: spawn, task, select-tool, reflect

故障排除

命令问题：

• 命令未找到: 验证安装: python3 -m SuperClaude --version
• 无响应: 重启 Claude Code 会话
• 处理延迟: 使用 --no-mcp 测试不使用 MCP 服务器

快速修复：

• 重置会话: /sc:load 重新初始化
• 检查状态: SuperClaude install --list-components
• 获取帮助: 故障排除指南

下一步

• 标志指南 - 控制命令行为
• 智能体指南 - 专家激活
• 示例手册 - 真实使用模式