💡 欢迎使用 SuperClaude 框架！

本手册涵盖所有 25 个命令、15 个专业代理 + 商业专家团、7 种行为模式 和 8 个 MCP 服务器，包含详细的使用方法和丰富的实战案例。每个功能都经过精心设计，让您的开发工作更加高效、智能。

🎯 快速开始

安装 SuperClaude

# 推荐方式（pipx）
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install

# 或使用 npm
npm install -g @bifrost_inc/superclaude && superclaude install

# 或使用 pip
pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install

首次使用

安装完成后，在 Claude Code 中输入：

/sc:help

将显示所有可用命令列表。让我们开始探索吧！

💻 开发工作流

常见的开发工作流命令，助您从需求到部署的全周期开发：

/sc:brainstorm - 交互式需求探索
通过苏格拉底式对话，将模糊的想法转化为清晰的技术规格

语法

/sc:brainstorm [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel] [主题/想法]

参数

  • --strategy: : 探索策略
    • systematic
    • agile
    • enterprise
  • --depth: : 探索深度
    • shallow
    • normal
    • deep
  • --parallel: : 启用并行探索路径
示例 1: 系统化产品探索
/sc:brainstorm --strategy systematic --depth deep "AI-driven project management tool"
✨ 效果:
  • 多专家分析（架构师、分析师、项目经理）
  • 使用 Sequential MCP 提供结构化探索框架
  • 生成完整的需求文档

💡 实用场景

SaaS 产品概念探索
/sc:brainstorm --strategy systematic --depth shallow --parallel "Team collaboration project management tool with AI assistant"
背景:
产品概念场景：

  • 有一个模糊的想法：带 AI 助手集成的团队协作项目管理工具
  • 不确定核心价值主张和目标用户群体
  • 不清楚具体的 AI 集成场景
  • 需要系统化探索以明确产品定位和功能范围
结果:
需求探索完成,识别用户故事、核心功能和技术栈。准备进入设计阶段。
团队协作工具开发
/sc:brainstorm --strategy agile --depth normal "Team collaboration project management tool with AI assistant"
背景:
开发规划场景：

  • 想开发一个团队协作工具
  • 不确定哪些核心功能能提供真正价值
  • 需要识别竞争市场中的差异化优势
结果:
通过系统化对话澄清核心功能和价值主张。准备创建PRD。
功能优先级评估
/sc:brainstorm --strategy enterprise --depth deep "Feature prioritization: User feedback system vs Advanced analytics vs Third-party integrations"
背景:
优先级挑战：

  • 产品待办事项积累了来自各利益相关者的 20+ 个功能请求
  • 开发资源有限（小团队）
  • 需要数据驱动的优先级排序以最大化影响
  • 必须平衡快速胜利与长期战略功能
结果:
功能优先级排序完成,提供数据驱动的建议和实现路线图。
💡 最佳实践:
  • 想法越模糊，越适合使用这个命令
  • 让 Claude 引导对话，回答提出的问题
  • 保存生成的需求文档供后续开发使用
/sc:implement - 功能实现
使用智能专家协调和 MCP 集成实现功能和代码

语法

/sc:implement [--type component|api|service|feature] [--framework react|vue|express] [--safe] [--with-tests] [功能描述]

参数

  • --type: : 实现类型
    • component
    • api
    • service
    • feature
  • --framework: : 技术框架（如 react、vue、angular、express、fastify）
  • --safe: : 启用安全审查，激活安全工程师
  • --with-tests: : 自动生成测试代码
示例: React 组件实现
/sc:implement --type component --framework react "user login form"
✨ 效果:
  • 前端架构师专家激活
  • Magic MCP 生成现代 UI 组件
  • Context7 MCP 提供 React 最佳实践
  • 自动生成组件测试
示例 1.2: API 端点
/sc:implement --type api --framework express --safe "payment processing interface"
✨ 效果:
  • Express REST API
  • 包含错误处理和输入验证
  • 安全模式防止常见漏洞
示例 1.3: 完整功能模块
/sc:implement --type feature --framework react --with-tests --magic --c7 "real-time chat system"
✨ 效果:
  • 完整的前端和后端实现
  • 包含单元测试和集成测试
  • Magic 生成精美 UI
  • Context7 提供最佳实践
  • 自动设置 WebSocket 连接
示例 1.4: 微服务实现
/sc:implement --type service --framework express --with-tests --seq --think-hard "order processing microservice"
✨ 效果:
  • 独立微服务架构
  • 包含消息队列集成
  • Sequential 深度分析业务逻辑
  • 自动生成 Docker 配置

💡 实用场景

文件上传功能
/sc:implement --type feature --framework react --safe --with-tests "Large file upload with chunking and resume"
背景:
实现需求：

  • 需要实现大文件上传支持及分片机制
  • 必须支持最大 2GB 的文件
  • 需要实时更新的进度跟踪
  • 需要恢复能力以处理网络中断
  • 必须向用户显示准确的上传进度
结果:
文件上传功能实现完成,包含验证和进度跟踪。
用户认证系统
/sc:implement --type api --framework express --safe --with-tests "User authentication system (registration, login, JWT)"
背景:
系统需求：

  • 需要实现完整的用户认证系统
  • 必须包含带邮箱验证的用户注册
  • 需要带 JWT 令牌管理的安全登录
  • 技术栈：Express.js + JWT + bcrypt 密码哈希
  • 必须设计带加密密码的用户模型
  • 需要带适当验证的注册和登录 API 端点
  • 需要保护路由的认证中间件
结果:
认证系统实现完成,包含安全令牌处理和会话管理。
💡 最佳实践:
  • 描述要清晰明确，包含关键需求
  • 生产代码始终使用 --safe
  • 使用 --with-tests 确保测试覆盖
/sc:design - 系统设计
设计系统架构、API接口和组件结构，提供可扩展的技术方案

语法

/sc:design [--type architecture|api|component|database] [--format diagram|spec|code] "<系统/组件>"

参数

  • --type: : 设计类型
    • architecture
    • api
    • component
    • database
  • --format: : 输出格式
    • diagram
    • spec
    • code
示例: API设计
/sc:design --type api --format spec "User Authentication API"
✨ 效果:
  • OpenAPI 规范
  • 端点定义
  • 安全方案
示例: 数据库设计
/sc:design --type database --format code "E-commerce Order System"
✨ 效果:
  • 数据库架构
  • ER 图
  • SQL 脚本
示例 9.3: 微服务架构设计
/sc:design --type architecture --format diagram --ultrathink --c7 ""
✨ 效果:
  • 完整架构图
  • 服务通信设计
  • 数据流图
  • 技术栈选择
  • 可扩展性规划

💡 实用场景

实时协作 API 设计
/sc:design --type api --format spec "Real-time Document Collaboration API"
背景:
设计需求：

  • 需要设计实时协作文档编辑功能
  • 需要多用户编辑的合适 API 结构
  • 必须处理数据同步和冲突解决
  • 需要所有连接客户端的实时更新
结果:
API设计完成,规范和文档准备就绪待实现。
支付系统架构重构
/sc:design --type architecture --format diagram "Payment System Refactoring"
背景:
重构挑战：

  • 电商系统支付代码混乱，组件间高度耦合
  • 难以添加新支付提供商或修改现有流程
  • 需要在重构前重新设计架构
  • 必须确保清晰的关注点分离和可测试性
结果:
系统架构定义完成,记录组件交互和部署策略。
💡 最佳实践:
  • 先设计再编码，避免返工
  • 考虑系统的可扩展性和可维护性
  • 使用 --format diagram 生成可视化文档
  • 设计评审后再进入实现阶段

💾 会话管理

保存和加载您的开发会话，实现跨会话的上下文持久化：

/sc:save - 会话保存
使用 Serena MCP 保存会话上下文和发现

语法

/sc:save [--type session|learnings|context|all] [--summarize] [--checkpoint]

参数

  • --type: : 保存类型
    • session
    • learnings
    • context
    • all
  • --summarize: : 生成摘要
  • --checkpoint: : 创建可恢复检查点
示例: 综合检查点
/sc:save --type session
✨ 效果:
  • 完整会话保存和恢复检查点
  • 包含所有学习、上下文和进度
  • 可用于会话恢复
示例: 保存学习要点
/sc:save --type all --checkpoint --summarize
✨ 效果:
  • 保存当前会话中的学习要点和技术发现
  • 使用标签分类便于后续查找
  • 构建项目知识库和最佳实践

💡 实用场景

保存调试会话进度
/sc:save "payment-bug-analysis"
背景:
会话场景：

  • 正在处理复杂的支付集成 bug
  • 工作日即将结束
  • 取得了需要保留的重大调试进展
  • 希望明天继续调查而不丢失上下文
结果:
调试会话已保存,记录进度和发现以供未来继续。
记录项目架构学习
/sc:save "project-architecture-overview"
背景:
知识捕获场景：

  • 与团队完成深入架构讨论
  • 做出重要技术栈决策
  • 需要保留架构理由以供将来参考
  • 希望让知识可供团队入职使用
结果:
项目学习内容已保存到持久化存储以保留知识。
保存性能优化洞察
/sc:save "react-performance-optimization"
背景:
优化完成：

  • 刚完成 React 组件渲染性能优化
  • 发现关于不必要重新渲染的关键洞察
  • 应用 React.memo 和 useCallback 优化
  • 实现显著性能改进
  • 希望为类似场景记录解决方案
结果:
系统架构定义完成,记录组件交互。
💡 最佳实践:
  • 重要突破后立即保存
  • 长会话每 30 分钟创建检查点
  • 会话结束前使用 --summarize
/sc:load - 会话加载
使用 Serena MCP 加载项目上下文和历史会话

语法

/sc:load [--type session|learnings|context|all] [--checkpoint id]

参数

  • --type: : 加载类型
    • session
    • learnings
    • context
    • all
  • --checkpoint: : 指定要加载的检查点ID
  • --analyze: : 加载时自动分析项目结构
  • --refresh: : 刷新上下文
示例: 从检查点恢复
/sc:load --type project --analyze ""
✨ 效果:
  • 恢复特定检查点的会话状态
  • 重新加载进度和上下文
  • 继续中断的工作
示例: 加载最近会话
/sc:load --type checkpoint --refresh "session_20250118_1430"
✨ 效果:
  • 快速加载最近的工作会话
  • 恢复上一次的代码上下文和思路
  • 无缝继续之前的开发任务

💡 实用场景

继续昨天的调试会话
/sc:load "payment-bug-analysis"
背景:
工作恢复场景：

  • 开始新的工作日
  • 昨天正在调试认证问题
  • 需要快速恢复上下文并从离开的地方继续
  • 希望无缝工作流延续，无需重新分析问题
结果:
会话上下文恢复成功,完整项目状态可用。
加载项目记忆
/sc:load "ecommerce-platform"
背景:
项目激活场景：

  • 在处理另一个代码库后切换到不同项目
  • 需要回忆项目特定的上下文、架构和约定
  • 希望快速重新激活，无需手动审查文档
结果:
项目上下文已激活,加载架构和开发模式。
恢复学习上下文
/sc:load "nextjs-learning"
背景:
学习恢复：

  • 上周正在学习 Next.js App Router 架构
  • 做了笔记并用示例练习
  • 需要从停止的地方继续学习
  • 希望回忆关键概念和下一步学习步骤
结果:
系统架构定义完成,记录组件交互。
💡 最佳实践:
  • 启动新会话时立即加载项目上下文
  • 切换项目前先保存当前会话再加载新项目
  • 定期使用 --refresh 刷新过期上下文
  • 使用 --analyze 自动分析项目结构

🎯 高级功能

强大的高级命令，用于解决复杂的开发场景：

/sc:task - 复杂任务执行
使用智能工作流管理和委派执行复杂任务

语法

/sc:task [--parallel] [--validate] [任务描述] [--delegate auto|files|folders]
示例: 大规模重构
/sc:task --delegate auto --validate "refactor authentication system"
✨ 效果:
  • 自动任务分解和委派
  • 并行专家协作
  • 执行前风险评估

💡 实用场景

端到端功能实现
/sc:task --parallel --validate "Integrate Stripe payment (requirements → design → implementation → testing → deployment)"
背景:
需要完成从需求到部署的支付集成功能。
结果:
功能实现通过完整工作流编排完成,所有阶段成功完成。
问题诊断和修复
/sc:task --parallel --validate "Production environment memory leak"
背景:
生产环境出现内存泄漏，需要完整的诊断和修复工作流。
结果:
通过系统化故障排除工作流诊断并解决问题。
项目初始化
/sc:task --parallel --validate "Next.js + TypeScript + Tailwind project"
背景:
启动新的 Next.js 项目，需要完整的项目设置。
结果:
系统架构定义完成,记录组件交互。
/sc:workflow - 工作流生成
从PRD和功能需求生成结构化的实现工作流

语法

/sc:workflow [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel] [--delegate auto] "<功能描述或PRD文件>"

参数

  • --strategy: : 探索策略
    • systematic
    • agile
    • enterprise
  • --depth: : 探索深度
    • shallow
    • normal
    • deep
  • --parallel: : 启用并行探索路径
  • --delegate: : 自动任务分配
示例: 敏捷工作流
/sc:workflow --strategy agile "User Management System"
✨ 效果:
  • 敏捷方法论
  • 用户故事分解
  • 迭代计划
示例: 系统化工作流
/sc:workflow --strategy systematic --depth deep "@requirements.prd"
✨ 效果:
  • 系统化方法
  • 详细任务分解
  • 依赖关系图
示例 7.3: 企业并行工作流
/sc:workflow --strategy enterprise --depth deep --parallel --delegate auto "@product-spec.md"
✨ 效果:
  • 企业级流程
  • 并行任务执行
  • 自动任务分配
  • 甘特图生成
  • 团队协作计划

💡 实用场景

功能开发标准流程
/sc:workflow --strategy systematic --depth normal "New Feature Development Standard Process"
背景:
团队有许多新成员，需要标准化功能开发流程。
结果:
开发工作流结构化完成,定义清晰的阶段和团队协作指南。
Bug 修复流程
/sc:workflow --strategy agile --depth shallow "Bug Fix Standard Process"
背景:
Bug 修复流程不规范，经常遗漏步骤导致返工。
结果:
错误修复工作流标准化完成,记录调查、解决和验证步骤。
企业并行工作流
/sc:workflow --strategy enterprise --depth deep --parallel --delegate auto "@product-spec.md"
背景:
大型项目需要多团队协作，需要企业级工作流规划。
结果:
改进已应用,实现可测量的性能提升。
💡 最佳实践:
  • 确保PRD包含清晰的需求定义
  • 使用 --estimate 进行资源规划
  • 定期更新工作流跟踪进度
  • 考虑团队规模调整时间估算
/sc:spawn - 任务编排
元系统任务编排，智能分解和委派大型复杂任务

语法

/sc:spawn "任务描述" [--strategy sequential|parallel|adaptive] [--breakdown auto] [--delegate agents]

参数

  • --strategy: : 执行策略
    • sequential
    • parallel
    • adaptive
  • --breakdown: : 自动任务分解
  • --delegate: : 委派给专业代理
示例: 大型项目编排
/sc:spawn --strategy adaptive --breakdown auto --delegate agents "Build complete e-commerce admin system"
✨ 效果:
  • 任务分解: 用户管理、商品管理、订单系统、支付集成、数据分析
  • 代理分配: backend-architect（架构）、security-engineer（支付安全）、frontend-architect（管理界面）
  • 执行策略: 架构设计-并行开发-集成测试
  • 智能调度和进度跟踪
示例: 并行测试执行
/sc:spawn --strategy parallel "运行所有测试套件"
✨ 效果:
  • 并行执行单元测试、集成测试、E2E测试
  • 大幅缩短总体测试时间
  • 汇总测试结果和覆盖率报告

💡 实用场景

多功能并行开发
/sc:spawn --strategy adaptive --breakdown auto "user avatar upload, comment system, search optimization"
背景:
Sprint 需要同时开发 3 个独立功能，希望通过并行处理加速开发。
结果:
任务编排完成,所有并行开发流成功执行。
多环境部署
/sc:spawn --strategy parallel --breakdown auto "Deploy to test, staging, and production environments"
背景:
需要同时部署到测试、预发布和生产环境。
结果:
并行部署在所有目标环境中成功完成。
复杂问题分而治之
/sc:spawn --strategy adaptive --breakdown auto "Analyze slow API, frontend lag, and database query performance"
背景:
系统性能问题复杂，需要分解为多个子问题并行分析。
结果:
系统架构定义完成,记录组件交互。
💡 最佳实践:
  • 适用于大型、多模块项目
  • 让系统智能分配代理和策略
  • 定期检查子任务进度
  • 复杂依赖使用 sequential 策略
/sc:reflect - 任务反思
任务反思和验证，使用Serena MCP分析能力进行质量评估

语法

/sc:reflect [--analyze outcomes|process|quality] [--improve] [--task 任务ID]

参数

  • --task: : 指定要反思的任务ID
  • --analyze: : 分析维度
    • outcomes
    • process
    • quality
  • --improve: : 自动应用改进建议
示例: 实现任务反思
/sc:reflect --task --analyze quality --improve "implement user authentication"
✨ 效果:
  • 分析实现质量（代码覆盖率、安全性）
  • 识别潜在问题（错误处理不足、性能隐患）
  • 生成改进建议
  • 自动应用可安全改进的部分
  • 标记需要人工审查的问题
示例: 代码评审反思
/sc:reflect --analyze process "代码评审改进点"
✨ 效果:
  • 分析评审流程效率和覆盖面
  • 识别评审中的盲点和改进机会
  • 优化评审清单和标准

💡 实用场景

任务完成验证
/sc:reflect --analyze outcomes --improve
背景:
完成用户认证功能开发，需要验证是否满足所有需求。
结果:
任务完成验证完毕,确认需求覆盖。
代码质量反思
/sc:reflect --analyze process
背景:
重构完成，需要评估代码质量是否符合标准。
结果:
代码质量验证完成,识别改进区域。
项目里程碑审查
/sc:reflect --analyze quality --improve
背景:
Sprint 结束，需要审查本次迭代的成就和问题。
结果:
Sprint回顾完成,记录成就并识别改进机会。
💡 最佳实践:
  • 重要任务完成后及时反思
  • 使用反思结果优化未来工作
  • 定期反思提升开发质量
  • 反思发现的问题及时修复
/sc:select-tool - 工具选择
基于复杂度评分和操作分析智能选择MCP工具

语法

/sc:select-tool "操作描述" [--suggest] [--compare] [--explain]

参数

  • --suggest: : 推荐最佳工具组合
  • --compare: : 对比多个工具方案
  • --explain: : 解释选择理由
示例: 工具选择建议
/sc:select-tool --suggest --explain "Need to rename function names in 100 files"
✨ 效果:
  • 分析操作复杂度: 中等（批量编辑）
  • 推荐工具: Morphllm MCP（批量模式编辑）
  • 备选方案: Serena MCP（符号重命名）
  • 解释: Morphllm更适合模式化的批量替换
  • 预估效率提升: 80%
示例: 性能优化工具选择
/sc:select-tool "优化数据库查询性能" --compare
✨ 效果:
  • 方案1: Sequential思考（系统分析瓶颈）
  • 方案2: Serena符号追踪（查找所有查询）
  • 方案3: 组合方案（Sequential分析 + Serena定位）

💡 实用场景

复杂任务工具选择
/sc:select-tool --suggest --explain "Implement user behavior data analysis and visualization reports"
背景:
需要实现复杂的数据分析功能，不确定哪些 MCP 工具最合适。
结果:
基于任务复杂度分析推荐最优工具组合。
性能优化工具选择
/sc:select-tool --suggest --explain "API performance optimization"
背景:
API 响应缓慢，需要选择适当的工具进行性能分析和优化。
结果:
工具工作流设计完成,为系统化优化选择合适的MCP服务器。
学习新框架工具选择
/sc:select-tool --suggest --explain "Learn Next.js 14 new features"
背景:
团队需要学习 Next.js 14，需要选择最佳学习路径和工具。
结果:
构建成功完成,生成优化的生产构件。
💡 最佳实践:
  • 不确定用什么工具时咨询此命令
  • 使用 --compare 了解不同方案优劣
  • 根据项目规模选择合适工具
  • 学习工具选择逻辑提升效率

其他核心命令

更多强大的功能命令

/sc:help - 查看所有命令
快速查看所有可用的 SuperClaude 命令及其功能说明

语法

/sc:help
/sc:analyze - 代码质量分析
全面分析代码质量、安全性、性能和架构

语法

/sc:analyze [--focus quality|security|performance|architecture] [--depth quick|deep] [--format text|json|report] [--all-mcp] [--validate] [目标]

参数

  • --focus: : 分析焦点
    • quality
    • security
    • performance
    • architecture
  • --depth: : 分析深度
    • quick
    • deep
  • --format: : 输出格式
    • text
    • json
    • report
  • --all-mcp: : 启用所有MCP服务器进行全方位分析
  • --validate: : 验证分析结果并生成改进计划
示例: 安全评估
/sc:analyze --focus security --depth quick "src/auth"
✨ 效果:
  • 认证组件的深度安全分析
  • 漏洞评估和详细的修复指导
  • OWASP 合规性检查
示例 2.2: 性能分析
/sc:analyze --focus performance --depth normal "api/"
✨ 效果:
  • 标准性能分析
  • 识别性能瓶颈
  • 提供优化建议
示例 2.3: 深度架构评估
/sc:analyze --focus architecture --depth deep --format report --think-hard --seq "."
✨ 效果:
  • 全面架构分析
  • 生成详细报告
  • 评估设计模式使用
  • 识别架构债务
  • Sequential 提供重构建议
示例 2.4: 综合质量审查
/sc:analyze --focus quality --depth deep --format json --all-mcp --validate "src/"
✨ 效果:
  • 全面代码质量审查
  • JSON 格式用于 CI/CD 集成
  • 覆盖率和复杂度分析
  • 自动生成改进计划

💡 实用场景

新功能性能分析
/sc:analyze --focus performance --depth deep --format report "src/search"
背景:
性能调查：

  • 新开发的搜索功能响应时间缓慢
  • 用户每次搜索延迟 2-3 秒
  • 需要分析性能瓶颈
  • 必须快速识别优化机会
结果:
性能分析完成,已识别瓶颈并提供优化建议。
遗留代码质量评估
/sc:analyze --focus quality --depth deep --format json "src/legacy"
背景:
技术债务评估：

  • 需要对遗留代码库进行全面质量分析
  • 从前团队继承的代码库，质量状况不明
  • 必须在计划重构工作前评估技术债务
  • 需要根据影响优先排序改进工作
结果:
代码质量评估完成,提供可执行的改进建议。
💡 最佳实践:
  • 首次分析使用 --depth quick 快速定位问题区域
  • 针对关键模块使用 --depth deep 进行深度分析
  • 定期对核心模块执行 --focus security 安全审计
  • 使用 --format report 生成团队可共享的分析报告
  • 结合 --all-mcp 使用多个MCP服务器进行全方位分析
/sc:research - 深度网络研究
使用自适应规划和智能搜索进行深度网络研究

语法

/sc:research [--depth quick|standard|deep|exhaustive] [--strategy planning_only|intent_planning|unified] [--domains "domain1,domain2"] "[查询]"

参数

  • --strategy: : 研究策略
    • planning_only
    • intent_planning
    • unified
  • --domains: : 限制搜索域名范围（如 "github.com,stackoverflow.com"）
示例: 技术最佳实践
/sc:research --depth quick "latest frontend framework comparison"
✨ 效果:
  • 协作式查询优化
  • 从官方文档和社区经验收集
  • 实用的实施指南
示例 8.2: 标准研究
/sc:research --depth standard --strategy planning "microservices architecture best practices"
✨ 效果:
  • 标准深度研究
  • 多源信息聚合
  • 实用建议
示例 8.3: 详尽技术研究
/sc:research --depth exhaustive --strategy unified --serena "zero trust security architecture implementation guide"
✨ 效果:
  • 最详尽研究
  • 全面信息收集
  • 比较分析表
  • Serena 保存研究发现
  • 趋势和预测分析

💡 实用场景

技术栈研究
/sc:research --strategy unified "React state management comparison 2024"
背景:
技术决策：

  • 需要为新 React 项目选择状态管理解决方案
  • 评估 Redux vs Zustand vs Jotai vs React Context
  • 团队经验水平参差不齐
  • 希望数据驱动决策，包含利弊
结果:
技术选项分析完成,基于项目需求提供建议。
安全最佳实践研究
/sc:research --strategy unified "OAuth 2.0 security best practices and common vulnerabilities"
背景:
安全审计准备：

  • 准备认证系统的安全审计
  • 需要了解当前最佳实践和标准
  • 希望识别当前实现中的差距
  • 必须提供改进建议
结果:
研究完成,记录安全最佳实践和实现建议。
/sc:improve - 代码改进
通过系统化重构和质量提升，改善现有代码的可维护性、性能和安全性

语法

/sc:improve [--type quality|performance|maintainability] [--safe] [--preview] [--interactive] [--iterations N] "<目标路径>"

参数

  • --type: : 改进类型
    • quality
    • performance
    • maintainability
  • --safe: : 安全模式，所有改动需经过测试验证
  • --preview: : 预览模式，不实际修改文件
  • --interactive: : 交互式确认每个改进
  • --iterations: : 迭代改进次数
示例: 性能优化
/sc:improve --type performance --safe "src/api/"
✨ 效果:
  • 性能优化
  • 安全模式
  • 基准测试
示例: 代码质量
/sc:improve --type quality --preview "src/"
✨ 效果:
  • 质量改进预览
  • 不实际修改
  • 改进清单
示例 10.3: 综合重构
/sc:improve --type maintainability --interactive --iterations 3 --morph ""
✨ 效果:
  • 渐进式重构
  • 3 轮迭代
  • 交互式确认
  • Morphllm 批量重构
  • 可维护性评分提升

💡 实用场景

代码质量改进
/sc:improve --type quality --safe "src/auth/legacy"
背景:
代码质量提升：

  • 遗留认证模块积累了技术债务
  • 代码功能正常但难以维护和测试
  • 需要在不破坏现有功能的情况下改进
  • 希望遵循现代最佳实践
结果:
代码质量改进完成,增强可维护性和测试覆盖率。
性能优化
/sc:improve --type performance --safe "src/api/products"
背景:
性能改进：

  • API 响应时间平均 800ms，目标是 <200ms
  • 数据库查询效率低
  • 未实现缓存层
  • React 组件不必要地重新渲染
结果:
性能优化已应用,实现可测量的改进。
💡 最佳实践:
  • 改进前先运行测试，确保有测试覆盖
  • 大范围改进建议分阶段进行，使用 --iterations 迭代改进
  • 生产代码务必使用 --safe 模式
  • 使用 --preview 预览改进效果后再应用
  • 改进后对比性能指标，确保正向提升
/sc:test - 测试执行
执行测试并生成覆盖率分析和质量报告

语法

/sc:test [--type unit|integration|e2e|all] [--coverage] [--watch] [--fix] [--parallel] [--concurrency N] [--validate] [目标]

参数

  • --type: : 测试类型
    • unit
    • integration
    • e2e
    • all
  • --coverage: : 生成测试覆盖率报告
  • --watch: : 监视模式，文件变化时自动重新运行测试
  • --fix: : 自动修复测试问题（超时、过时断言等）
  • --parallel: : 并行执行测试
  • --concurrency: : 并发数量（如 --concurrency 4）
  • --validate: : 结果验证和报告
示例: 覆盖率分析
/sc:test --type unit --coverage "src/utils"
✨ 效果:
  • 特定目录的单元测试
  • 详细的覆盖率指标（行、分支、函数）
  • 未覆盖代码的可视化
示例 3.2: 监视模式
/sc:test --type unit --watch "src/"
✨ 效果:
  • 文件更改时自动重新运行测试
  • 即时反馈
  • 适合 TDD 开发
示例 3.3: E2E 测试套件
/sc:test --type e2e --fix --play --verbose ""
✨ 效果:
  • 端到端测试
  • 自动修复失败测试用例
  • Playwright 浏览器自动化
  • 详细日志输出
示例 3.4: 完整测试管道
/sc:test --type all --coverage --parallel --concurrency 4 --validate "."
✨ 效果:
  • 所有测试并行执行
  • 4 倍速度提升
  • 完整覆盖率分析
  • 结果验证和报告

💡 实用场景

全面功能测试
/sc:test --type all --coverage --validate "src/auth"
背景:
功能验证：

  • 刚完成用户认证功能实现
  • 需要验证所有功能按规范工作
  • 必须测试边缘情况和错误场景
  • 合并前需要全面的测试覆盖
结果:
测试识别出需要在继续前修复的失败。
重构后回归测试
/sc:test --type all --coverage --validate "src/payments"
背景:
重构验证：

  • 刚完成支付处理模块的重大重构
  • 更改了内部实现但 API 应保持不变
  • 需要确保现有功能未被破坏
  • 必须验证向后兼容性
结果:
所有测试通过,生成全面的覆盖率报告。准备进行代码审查。
/sc:build - 项目构建
编译、打包和准备项目进行部署，支持多环境配置和优化

语法

/sc:build [--type dev|prod] [--clean] [--optimize] [--validate] [--parallel] <构建目标>

参数

  • --type: : 构建类型
    • dev
    • prod
  • --clean: : 清理旧构建
  • --optimize: : 启用构建优化
  • --validate: : 构建结果验证
  • --parallel: : 并行构建任务
示例 1: 开发构建
/sc:build --type dev --verbose "frontend/"
✨ 效果:
  • 开发环境构建
  • 详细输出日志
  • 快速热重载
示例 2: 生产构建
/sc:build --type prod --clean "."
✨ 效果:
  • 生产环境优化
  • 清理旧构建
  • 压缩和混淆
示例 5.3: 优化构建管道
/sc:build --type prod --clean --optimize --validate --parallel "."
✨ 效果:
  • 全面优化生产构建
  • 并行构建任务
  • 构建结果验证
  • 性能分析报告
  • Tree-shaking 和代码分割
示例 5.4: 多环境构建
/sc:build --type all --environments "dev,staging,prod" --dockerize ""
✨ 效果:
  • 同时构建多个环境
  • 生成 Docker 镜像
  • 环境特定配置
  • 准备部署

💡 实用场景

优化的生产构建
/sc:build --type prod --optimize --validate --clean
背景:
生产部署准备：

  • 准备 v2.0 生产版本发布
  • 需要带压缩和 tree-shaking 的优化构建
  • 必须确保所有资源正确打包
  • 需要 source maps 用于调试生产问题
结果:
构建成功完成,生成优化的生产构件。
CI/CD 集成构建
/sc:build --type prod --optimize --validate --parallel --clean
背景:
持续集成设置：

  • 在 GitHub Actions 中设置自动化构建管道
  • 需要跨环境一致、可重现的构建
  • 必须在构建前运行测试和质量检查
  • 需要构建产物用于部署自动化
结果:
构建成功完成,生成优化的生产构件。
💡 最佳实践:
  • 生产构建前运行测试，确保代码质量
  • 使用 --clean 避免旧文件残留导致的问题
  • 开发环境使用 --watch 提升开发效率
  • 检查构建大小报告，识别大型依赖
/sc:git - Git 操作
使用智能提交信息和工作流优化进行 Git 操作

语法

/sc:git [commit|merge|rebase|pr|flow] [--smart-commit] [--interactive] [--push] [--create-pr] [--squash] [--create] [--title "标题"] [--auto-description] [参数]

参数

  • commit: : 提交变更
  • merge: : 合并分支
  • rebase: : 变基操作
  • pr: : Pull Request操作
  • flow: : 完整Git工作流
  • --smart-commit: : 智能生成提交消息
  • --interactive: : 交互式操作
  • --push: : 推送到远程
  • --create-pr: : 创建Pull Request
  • --squash: : 压缩提交
  • --create: : 创建（PR）
  • --title: : PR标题
  • --auto-description: : 自动生成描述
示例: 智能提交
/sc:git commit --smart-commit
✨ 效果:
  • 从变更分析生成规范化提交信息
  • 应用最佳实践和一致格式
  • 自动分类变更类型（feat、fix、docs 等）
示例: 创建 Pull Request
/sc:git merge --interactive ""
✨ 效果:
  • 自动分析代码变更和提交历史
  • 生成详细的 PR 描述和变更说明
  • 推送到远程并创建 Pull Request
示例 4.3: 完整 Git 工作流
/sc:git flow --smart-commit --push --create-pr ""
✨ 效果:
  • 自动创建分支
  • 智能提交消息
  • 推送并创建 PR
  • 生成变更摘要

💡 实用场景

功能开发 Git 工作流
/sc:git flow --smart-commit --push --create-pr
背景:
功能分支管理：

  • 正在开发新的仪表板分析功能
  • 开发过程中进行了多次提交
  • 需要在 PR 前创建清晰的提交历史
  • 希望推送到远程并创建 Pull Request
结果:
更改已提交并按照项目约定提交代码审查。
热修复部署
/sc:git flow --smart-commit --push --create-pr --title "Hotfix: Payment callback race condition"
背景:
关键 bug 修复：

  • 发现生产支付处理 bug
  • 需要从生产分支创建紧急热修复
  • 必须快速部署修复，同时保持 Git 最佳实践
  • 合并前需要自动化测试
结果:
热修复部署到生产环境,记录验证和回滚计划。
/sc:document - 文档生成
为代码、API和组件生成清晰准确的技术文档

语法

/sc:document [--type api|code|readme|guide] [--format markdown|html|jsdoc] [目标]

参数

  • --type: : 文档类型
    • api
    • code
    • readme
    • guide
  • --format: : 输出格式
    • markdown
    • html
    • jsdoc
示例 1: API文档
/sc:document --type inline --style brief "utils.js"
✨ 效果:
  • 分析所有API端点
  • 生成请求/响应示例
  • 参数说明和类型定义
  • 状态码和错误处理文档
  • 生成 API.md 文件
示例 2: README生成
/sc:document --type api --style detailed "src/api/"
✨ 效果:
  • 项目简介和特性
  • 安装和快速开始
  • 配置说明
  • 使用示例
  • 贡献指南
示例 13.3: 用户指南
/sc:document --type guide --style detailed --format markdown --toc ""
✨ 效果:
  • 完整用户指南
  • 目录结构
  • 图表说明
  • 最佳实践
  • 便于搜索

💡 实用场景

API 文档生成
/sc:document --type api --format markdown "src/api/"
背景:
文档需求：

  • 后端 API 缺乏全面文档
  • 前端团队难以理解端点契约
  • 需要生成最新的 API 参考
  • 希望包含请求/响应示例
结果:
API文档已生成,包含全面的端点参考和示例。
组件库文档
/sc:document --type code --format markdown "src/components/"
背景:
组件文档：

  • React 组件库增长但缺少文档
  • 开发者不确定如何使用现有组件
  • 需要记录 props、使用示例和最佳实践
  • 希望创建交互式组件展示
结果:
组件文档创建完成,包含使用示例和属性规范。
💡 最佳实践:
  • 文档与代码同步更新
  • 提供丰富的使用示例
  • API文档包含完整的请求响应示例
  • 保持文档简洁易懂，避免过度技术化
/sc:cleanup - 代码清理
系统化清理代码库，移除无用代码、优化项目结构

语法

/sc:cleanup [--type imports|code|all] [--safe] [--preview] [--aggressive] [--interactive] [--backup]

参数

  • --type: : 清理类型
    • imports
    • code
    • all
  • --safe: : 安全模式，保守处理
  • --preview: : 预览模式，不实际修改
  • --aggressive: : 激进模式（谨慎使用）
  • --interactive: : 逐个确认清理项
  • --backup: : 自动备份
示例: 清理导入
/sc:cleanup --type imports --safe "src/"
✨ 效果:
  • 清理未使用导入
  • 保守处理
  • 快速执行
示例: 删除死代码
/sc:cleanup --type code --preview "."
✨ 效果:
  • 识别死代码
  • 预览模式
  • 清理报告
示例 11.3: 激进清理
/sc:cleanup --type all --aggressive --interactive --backup ""
✨ 效果:
  • 综合深度清理
  • 激进模式（谨慎使用）
  • 逐项确认
  • 自动备份
  • 清理统计报告

💡 实用场景

遗留代码清理
/sc:cleanup --type code --safe --preview "src/"
背景:
代码清理需求：

  • 项目积累了未使用的代码和废弃的功能
  • 死代码影响代码库可维护性
  • 需要安全移除过时组件
  • 必须确保不破坏活跃功能
结果:
遗留代码移除完成,验证测试确认无功能损失。
依赖清理和更新
/sc:cleanup --type all --safe --backup
背景:
依赖管理：

  • package.json 中有过时和存在漏洞的依赖
  • npm audit 报告多个安全漏洞
  • 需要安全更新包，避免破坏性变更
  • 需要移除未使用的依赖
结果:
代码库清理完成,移除未使用代码并更新依赖。
💡 最佳实践:
  • 定期清理，避免技术债务积累
  • 清理前运行测试，确保不破坏功能
  • 始终使用 --safe 模式进行备份
  • 清理后验证应用仍正常运行
/sc:troubleshoot - 故障诊断
系统化诊断和解决代码问题、构建失败和运行时错误

语法

/sc:troubleshoot [--type bug|performance|build] [--trace] [--fix] [--safe-mode] "<问题描述>"

参数

  • --type: : 问题类型
    • bug
    • performance
    • build
  • --trace: : 深度堆栈跟踪分析
  • --fix: : 尝试自动修复问题
  • --safe-mode: : 安全模式，使用保守修复策略
示例: 性能问题
/sc:troubleshoot --type performance --trace "API response slow"
✨ 效果:
  • 性能问题定位
  • 生成火焰图
  • 识别瓶颈
示例: 构建失败
/sc:troubleshoot --type build --fix
✨ 效果:
  • 自动检测构建问题
  • 尝试自动修复
  • 提供解决方案
示例 6.3: 生产环境调试
/sc:troubleshoot --type bug --trace --fix --safe-mode --seq ""
✨ 效果:
  • 安全模式调试
  • 深度堆栈跟踪
  • Sequential 根因分析
  • 保守修复策略
  • 性能影响评估

💡 实用场景

生产 API 故障调查
/sc:troubleshoot --type bug --trace --fix --safe-mode "checkout API 500 errors"
背景:
关键生产问题：

  • 用户报告结账 API 出现 500 错误
  • 错误率从正常的 0.1% 突然飙升至 15%
  • 需要快速识别根本原因
  • 必须尽快恢复服务
结果:
根本原因识别完成并实施修复,监控以防再次发生。
性能下降根因分析
/sc:troubleshoot --type performance --trace --fix "dashboard performance"
背景:
性能问题调查：

  • 仪表板加载时间在过去一周从 2 秒增加到 8 秒
  • 前端没有最近的代码更改
  • 用户抱怨体验缓慢
  • 需要找出变化并修复
结果:
性能问题诊断并解决完成,应用优化建议。
💡 最佳实践:
  • 提供完整的错误信息和上下文
  • 使用 --trace 进行深度堆栈跟踪分析
  • 生产环境问题使用 --safe-mode 确保安全
  • 应用修复后验证问题已解决
  • 记录诊断过程，防止问题复发
/sc:explain - 代码解释
用清晰的语言解释代码、概念和系统行为

语法

/sc:explain [--level beginner|intermediate|expert] [--focus logic|architecture|performance|security] [目标]

参数

  • --level: : 解释深度
    • beginner
    • intermediate
    • expert
  • --focus: : 解释重点
    • logic
    • architecture
    • performance
    • security
示例 1: 解释复杂函数
/sc:explain --level intermediate --focus security @utils/encryption.js
✨ 效果:
  • 逐步解释加密算法
  • 说明为什么选择这个方案
  • 指出安全关键点
  • 解释参数和返回值
示例 2: 架构解释
/sc:explain --level beginner --focus architecture "Microservices Architecture"
✨ 效果:
  • 用简单语言解释微服务概念
  • 对比单体架构的区别
  • 说明适用场景
  • 提供入门示例

💡 实用场景

复杂算法解释
/sc:explain --level beginner "src/cache/lru-cache.ts"
背景:
学习场景：

  • 新团队成员加入项目
  • 难以理解自定义缓存算法
  • 代码缺少注释和文档
  • 需要清晰解释其工作原理
结果:
算法解释已提供,包含逐步分解和可视化示例。
架构模式解释
/sc:explain --level intermediate --focus architecture "Event sourcing pattern in payment service"
背景:
代码审查讨论：

  • 团队讨论微服务事件驱动架构
  • 一些开发者不熟悉事件溯源模式
  • 需要解释模式及其使用原因
  • 希望展示优缺点
结果:
架构模式解释完成,包含实现指导和最佳实践。
💡 最佳实践:
  • 根据受众选择合适的 --level
  • 请求解释时提供具体上下文
  • 使用 --focus 聚焦感兴趣的方面
  • 解释后可以提问深入了解
/sc:business-panel - 商业专家面板
多专家商业分析，具有自适应交互模式

语法

/sc:business-panel [--mode discussion|debate|socratic] [--experts "expert1,expert2"] [--focus domain] [文档]

参数

  • --mode: : 分析模式
    • discussion
    • debate
    • socratic
  • --experts: : 指定专家列表（用逗号分隔）
  • --focus: : 聚焦领域（innovation, strategy, marketing, risk, systems, communication, organization）
示例: 创新评估
/sc:business-panel --mode discussion --focus strategy "SaaS pricing model evaluation"
✨ 效果:
  • Christensen 的 jobs-to-be-done（待完成任务理论）分析
  • Drucker 的客户价值视角
  • Godin 的市场推广策略
示例: 市场分析辩论
/sc:business-panel --mode debate "进入AI教育市场"
✨ 效果:
  • 正方：Porter 分析市场吸引力和竞争优势
  • 反方：Taleb 指出潜在风险和不确定性
  • 调和：Kim & Mauborgne 提出蓝海战略

💡 实用场景

产品策略审查
/sc:business-panel --mode sequential "SaaS project management tool - freemium vs paid subscription strategy"
背景:
战略规划：

  • 推出新的项目管理 SaaS 产品
  • 需要验证市场定位和定价策略
  • 评估免费增值 vs 订阅模式
  • 需要专家指导市场进入方法
结果:
业务战略专家组完成,提供市场定位和进入市场建议。
商业模式转型评估
/sc:business-panel --mode debate "Pivot from B2C to B2B enterprise model"
背景:
转型决策：

  • 当前 B2C 模式未达到增长目标
  • 考虑转向 B2B 企业销售
  • 需要评估可行性和风险
  • 需要对利弊进行结构化辩论
结果:
业务模型分析完成,包含转型决策框架和风险评估。
/sc:estimate - 开发估算
提供任务、功能或项目的开发时间和资源估算

语法

/sc:estimate [--detail brief|standard|comprehensive] [--team-size N] [--complexity auto|low|medium|high] [任务描述]

参数

  • --detail: : 估算详细程度
    • brief
    • standard
    • comprehensive
  • --team-size: : 团队人数（影响并行度）
  • --complexity: : 复杂度评估（自动或手动指定）
示例: 功能估算
/sc:estimate --type time --unit hours "Implement login functionality"
✨ 效果:
  • 复杂度分析: 中等偏高
  • 开发时间: 4-6周（3人团队）
  • 分解任务: WebSocket服务(1.5周)、消息存储(1周)、前端UI(1.5周)、测试(1周)
  • 风险因素: 实时性能、并发连接
示例: 快速估算
/sc:estimate --type complexity "Microservice decomposition"
✨ 效果:
  • 复杂度: 中等
  • 预估时间: 2-3天
  • 主要工作: 代码重构、测试更新、文档修改
示例 14.3: 详细项目估算
/sc:estimate --type effort --unit days --breakdown --team-size 5 ""
✨ 效果:
  • 完整工作量分解
  • 考虑团队规模
  • 任务依赖关系
  • 燃尽图预测
  • 成本估算

💡 实用场景

功能开发估算
/sc:estimate --type time --unit days --breakdown --team-size 3 "Analytics dashboard with charts, filters, CSV export"
背景:
Sprint 规划：

  • 产品经理请求新分析仪表板的估算
  • 功能包括数据可视化、过滤和导出能力
  • 需要为 Sprint 规划提供现实时间线
  • 团队有 3 名开发者可用
结果:
开发工作量估算完成,定义时间线和资源需求。
技术债务重构估算
/sc:estimate --type time --unit days --breakdown "Refactor authentication system to modern architecture"
背景:
重构规划：

  • 需要重构遗留认证系统
  • 当前代码难以维护和测试
  • 必须保持向后兼容性
  • 希望在投入资源前获得现实估算
结果:
重构工作量估算完成,定义分阶段方法和时间线。
💡 最佳实践:
  • 提供详细的功能描述以提高准确性
  • 考虑团队经验调整估算
  • 预留20-30%的缓冲时间
  • 使用历史数据校准估算模型
/sc:spec-panel - 规格评审
多专家规格评审，使用著名规格和软件工程专家进行改进

语法

/sc:spec-panel @规格文档 [--mode review|critique|improve] [--focus clarity|completeness|feasibility]

参数

  • --mode: : 评审模式
    • review
    • critique
    • improve
  • --focus: : 评审重点
    • clarity
    • completeness
    • feasibility
示例: API规格评审
/sc:spec-panel --mode improve --focus completeness @specs/api-design.md
✨ 效果:
  • 专家面板评审（架构师、技术写作专家）
  • 识别缺失的端点和参数
  • 指出错误处理不完整
  • 提供改进建议和示例
  • 生成更完善的规格版本

💡 实用场景

API 规格评审
/sc:spec-panel --mode improve --focus completeness "docs/api-spec.yaml"
背景:
规格评审：

  • 为微服务起草了新的 REST API 规格
  • 需要专家审查最佳实践和潜在问题
  • 希望确保可扩展性和可维护性
  • 需要关于命名约定和结构的反馈
结果:
专家组审查完成,提供可执行建议并设定实现优先级。
数据库模式评审
/sc:spec-panel --mode critique --focus feasibility "schemas/ecommerce.sql"
背景:
模式验证：

  • 为电商平台设计数据库模式
  • 包含 users、products、orders、payments 表
  • 需要专家验证规范化和性能
  • 希望识别潜在的扩展问题
结果:
专家审查数据库架构完成,记录优化建议和最佳实践。
💡 最佳实践:
  • 规格初稿完成后立即评审
  • 使用 critique 模式发现隐藏问题
  • 评审后根据建议修正规格
  • 重复评审直到达到质量标准
/sc:index - 项目索引
生成全面的项目文档和知识库索引，智能组织项目信息

语法

/sc:index [--type codebase|docs|all] [--depth shallow|deep] [--output markdown|json|html]

参数

  • --type: : 索引类型
    • codebase
    • docs
    • all
  • --depth: : 索引深度
    • shallow
    • deep
  • --output: : 输出格式
示例: 代码库索引
/sc:index --type codebase --depth deep --output markdown
✨ 效果:
  • 扫描整个代码库
  • 生成目录结构树
  • 列出所有模块和依赖
  • 提取主要函数和类
  • 生成 PROJECT_INDEX.md
示例: 快速项目概览
/sc:index --type docs --format summary
✨ 效果:
  • 快速生成项目文档概览
  • 汇总README和主要文档
  • 适合快速了解新项目

💡 实用场景

项目知识库索引
/sc:index --type codebase --depth shallow --output markdown
背景:
新员工需要快速理解项目，建立全面的代码索引。
结果:
项目知识库索引完成,支持快速语义搜索和导航。
增量索引更新
/sc:index --type docs --depth deep --output json
背景:
项目频繁更新，需要定期更新索引以保持最新。
结果:
索引已更新,整合最新变更以提高搜索准确性。
特定模块索引
/sc:index --type all --depth shallow --output html
背景:
正在重构支付模块，只需索引相关代码。
结果:
模块索引已生成,依赖关系图和文档准备就绪待审查。
💡 最佳实践:
  • 新项目加入时先运行索引
  • 定期更新索引保持同步
  • 使用索引快速导航大型项目
  • 索引可作为新成员的入门文档

🤖 专业代理

什么是专业代理？

SuperClaude 框架内置了 15 个专业代理，每个代理都在特定领域拥有深厚的专业知识。代理可以自动激活，也可以通过标志参数手动指定。

🎨 前端开发代理

frontend-architect
创建可访问、高性能的用户界面，专注于用户体验和现代框架

专长领域：

  • 现代框架如 React、Vue、Angular
  • 响应式设计和移动端优化
  • Web 无障碍访问（WCAG 2.1）
  • 性能优化和代码分割

⚙️ 后端开发代理

backend-architect
设计可靠的后端系统，专注于数据完整性、安全性和容错性

专长领域：

  • RESTful 和 GraphQL API 设计
  • 数据库架构和优化
  • 身份验证和授权
  • 微服务架构

🏗️ 系统架构代理

system-architect
设计可扩展的系统架构，专注于可维护性和长期技术决策

专长领域：

  • 系统设计模式
  • 可扩展性架构
  • 技术选型
  • 架构文档

🐍 Python 专家代理

python-expert
交付生产就绪、安全、高性能的 Python 代码，遵循 SOLID 原则

专长领域：

  • Python 最佳实践
  • FastAPI、Django、Flask
  • 数据处理和分析
  • 异步编程

🚀 DevOps 代理

devops-architect
自动化基础设施和部署流程，专注于可靠性和可观察性

专长领域：

  • CI/CD 流水线
  • Docker 和 Kubernetes
  • 监控和日志
  • 基础设施即代码

🔧 重构专家代理

refactoring-expert
通过系统化的重构和清晰的代码原则提高代码质量并减少技术债务

专长领域：

  • 代码异味识别
  • 重构模式
  • 代码质量指标
  • 技术债务管理

🎓 其他专业代理

SuperClaude 还包括以下专业代理：

  • security-engineer - 安全漏洞识别和合规性
  • quality-engineer - 全面的测试策略
  • performance-engineer - 性能优化
  • learning-guide - 编程教育
  • root-cause-analyst - 根本原因分析
  • requirements-analyst - 需求探索
  • technical-writer - 技术文档
  • socratic-mentor - 苏格拉底式教学法
  • business-panel-experts - 商业策略专家团（9 位专家）

🚩 标志参数参考

标志参数允许您自定义命令行为。以下是所有可用的标志：

⚡ 模式激活标志

这些标志激活特定的工作模式，以增强 AI 能力和交互方法

标志说明Token成本适用命令
--brainstorm激活协作探索思考模式，通过苏格拉底式对话探索需求+2-3K所有命令
--introspect显示思考过程透明度，让 AI 展示推理步骤+1-2K所有命令
--task-manage启用多步骤任务管理，自动跟踪和组织复杂任务+1K所有命令
--orchestrate启用多工具并行执行，协调多个 MCP 服务器和工具+3-5K所有命令
--token-efficient启用令牌优化模式，在保持质量的同时减少令牌消耗-30-50%所有命令
--plan启用规划模式，执行前生成详细计划标准implement, design, refactor
--validate启用验证模式，自动验证输出和结果标准implement, test, build
--parallel启用并行执行，同时处理多个任务标准test, analyze, research
--interactive启用交互模式，逐步确认和调整标准brainstorm, design

🔍 分析深度标志

控制 AI 的分析深度，平衡速度和细节

标志Token成本说明适用场景
--think~4K标准分析深度，适合常规开发任务日常开发
--think-hard~10K深度分析，多角度思考和验证复杂问题
--ultrathink~32K最大深度分析，穷尽所有可能性关键决策
--depth shallow低快速概览，适合时间紧迫情况快速检查
--depth normal标准平衡速度和细节（默认）常规分析
--depth deep高全面深入分析，用于复杂场景详细评估

🔌 MCP 服务器控制

选择性激活 MCP 服务器以获得专业能力

标志别名MCP服务器用途
--c7--context7Context7框架文档查询，获取官方最新文档和最佳实践
--seq--sequentialSequential复杂推理分析，多步骤系统性思考
--magic--magicMagic基于 21st.dev 现代组件库的 UI 组件生成
--morph--morphllmMorphllm批量代码编辑，基于模式的快速修改
--serena--serenaSerena项目记忆管理，语义代码理解和会话持久化
--play--playwrightPlaywright浏览器自动化测试，E2E 测试和 UI 验证

⚙️ 执行控制标志

控制命令执行方法和行为

标志说明示例
--dry-run模拟执行而不做实际更改/sc:implement --dry-run
--force强制执行，跳过确认提示/sc:cleanup --force
--auto-commit自动提交更改到 Git/sc:implement --auto-commit
--no-test跳过测试步骤/sc:build --no-test

💡 组合使用示例

标志可以组合使用以获得更强大的功能：

  • /sc:analyze --think-hard --serena --c7 "src/api"
    使用深度思考、项目记忆和官方文档分析 API 代码
  • /sc:implement --brainstorm --plan --validate "用户认证"
    协作探索需求、规划实施并验证结果
  • /sc:improve --token-efficient --morph --dry-run "src/"
    使用令牌优化和批量编辑工具预览代码改进

💡 实用技巧

以下是一些真实的开发场景和推荐的命令组合：

📦 从零开发新功能
/sc:brainstorm "用户认证功能" --depth deep
/sc:design --think
/sc:implement --plan --validate
/sc:test --parallel
/sc:document
/sc:git "feat: 添加用户认证"

工作流说明：

  1. 需求探索：明确功能范围和技术方案
  2. 系统设计：设计认证流程和数据模型
  3. 功能实现：编写代码并验证
  4. 测试验证：并行运行测试套件
  5. 生成文档：自动生成 API 文档
  6. 提交代码：创建标准 Git 提交
🐛 紧急 Bug 修复流程
/sc:troubleshoot --depth deep
/sc:analyze --focus security
/sc:implement --validate
/sc:test --parallel
/sc:git "fix: 解决认证绕过问题"
🔧 代码重构和性能优化
/sc:analyze --depth deep
/sc:improve --plan
/sc:test --validate
/sc:cleanup
🎨 React 组件开发
/sc:design "用户资料卡组件"
/sc:implement --persona frontend-architect
/sc:test --focus accessibility
/sc:document

🎓 学习资源

官方文档

社区资源

💡 提示：

遇到问题？查看 常见问题 或在 GitHub 提交 Issue。