SuperClaude命令参考手册：AI编程革命中的20个核心指令详解
一、通用体系 (Universal Flags & Personas)
在深入了解具体命令之前，我们首先需要掌握SuperClaude的通用体系。它主要由两部分组成：通用标志 (Universal Flags) 和 认知角色 (Personas)。这些标志和角色可以与几乎所有命令组合使用，极大地增强了指令的灵活性和深度。
1.1 通用标志 (Universal Flags)
这些标志为所有命令提供了通用的增强能力，覆盖了从思考深度到执行控制的方方面面。
| 分类 | 标志/别名 | 描述 |
|---|---|---|
| 🧠 思考深度 | --think | 启用多文件上下文分析（约4K Token）。 |
--think-hard | 启用架构级深度分析（约10K Token）。 | |
--ultrathink | 启用系统级全面分析，提供最大深度（约32K Token）。 | |
| 📦 效率优化 | --uc, --ultracompressed | 激活超压缩模式，可节省约70%的Token消耗。 |
| 🔧 MCP集成 | --c7 | [研究员] 启用Context7进行官方文档查询。 |
--seq | [思想家] 启用Sequential进行多步骤复杂思考。 | |
--magic | [设计师] 启用Magic进行UI组件生成。 | |
--prit | [测试员] 启用Playwright进行浏览器自动化测试。 | |
--all-mcp | 启用所有已配置的MCP服务器。 | |
--no-mcp | 禁用所有MCP服务器，仅使用原生功能。 | |
| 🔍 自我审视 | --introspect | 启用框架自我分析模式，用于调试或理解SuperClaude的行为。 |
| 📋 执行控制 | --plan | 在执行前，展示详细的行动计划。 |
--dry-run | 预演操作，显示将要发生的变更，但不实际执行。 | |
--interactive | 启动交互式模式，引导用户分步完成操作。 | |
--force | 强制执行，跳过安全检查（请谨慎使用）。 | |
| ✅ 质量与安全 | --validate | 在执行前进行增强的安全与质量验证。 |
--security | 切换到安全优先模式进行分析和操作。 | |
--coverage | 生成全面的代码测试覆盖率分析。 |
1.2 认知角色 (Personas)
通过切换认知角色，您可以让AI以特定领域的专家视角来分析问题和执行任务。
| 角色标志 | 专家角色 | 核心职责与专长 |
|---|---|---|
--persona-architect | 架构师 | 系统设计、可扩展性、设计模式、权衡分析。 |
--persona-frontend | 前端开发者 | UI/UX、组件化设计、用户体验、可访问性。 |
--persona-backend | 后端开发者 | API、数据库、服务器架构、数据建模、可靠性。 |
--persona-analyzer | 分析师 | 根本原因分析、复杂问题调试、证据驱动的调查。 |
--persona-security | 安全专家 | 威胁建模、漏洞评估、OWASP标准、零信任原则。 |
--persona-mentor | 导师 | 生成清晰的文档、知识传递、概念解释。 |
--persona-refactorer | 重构者 | 改善代码质量、减少技术债、提升代码可维护性。 |
--persona-performance | 性能专家 | 性能调优、瓶颈分析、资源利用率优化。 |
--persona-qa | QA工程师 | 质量保证、测试策略、边缘案例发现、自动化验证。 |
二、命令详解辞典 (Command-by-Command Dictionary)
接下来，我们将逐一解析SuperClaude的20个核心命令。
/analyze
用途: 对代码、架构、性能和依赖进行多维度、深层次的分析。
--code: 专注于代码质量、复杂度和风格。--architecture: 专注于系统设计、组件关系和模式评估。--profile: 专注于性能分析，识别瓶颈。--deps: 专注于项目依赖关系、版本冲突和安全漏洞。
用法示例:
# 以性能专家的视角，对整个项目的性能瓶颈进行深度分析
/analyze --profile --persona-performance --think-hard
/build
用途: 通用的项目构建器，用于创建新项目、实现新功能或生成组件。
--init: 初始化一个全新的项目。--feature: 在现有项目中实现一个新功能。--tdd: 采用测试驱动开发（TDD）的工作流。--react,--api,--fullstack,--mobile,--cli: 指定要构建的项目技术栈模板。
用法示例:
# 采用TDD模式，初始化一个新的React项目
/build --init --react --tdd# 在现有项目中开发一个名为"用户认证系统"的新功能
/build --feature "用户认证系统"
/cleanup
用途: 对项目进行维护和清理，移除无用代码、文件和依赖。
--code: 清理未使用的变量、函数和无法访问的代码。--files: 清理构建产物、日志和临时文件。--deps: 移除package.json中未使用的依赖。--all: 执行以上所有清理操作。
用法示例:
# 预览将要进行的所有清理操作，但不实际执行
/cleanup --all --dry-run
/deploy
用途: 安全地将应用程序部署到指定环境，支持多种部署策略和回滚。
--env [dev|staging|prod]: 指定目标环境。--canary,--blue-green: 指定部署策略。--checkpoint: 在部署前创建一个可回滚的Git检查点。--rollback: 回滚到上一个检查点。
用法示例:
# 计划一次到生产环境的金丝雀部署，并进行安全验证
/deploy --env prod --canary --plan --validate
/design
用途: 进行专业的系统和软件架构设计。
--api: 专注于REST或GraphQL API的设计。--ddd: 采用领域驱动设计（DDD）的原则。--microservices: 设计微服务架构。--openapi: 生成OpenAPI规范。
用法示例:
# 使用架构师角色，通过DDD思想设计API，并进行多步深度思考
/design --api --ddd --persona-architect --seq
/dev-setup
用途: 配置一个完整的、专业的开发环境。
--ci: 配置CI/CD流水线 (如GitHub Actions)。--monitor: 配置监控和可观察性工具。--docker: 配置项目的容器化环境。--testing: 配置测试基础设施 (如Jest, Playwright)。
用法示例:
# 为项目配置CI/CD和容器化环境
/dev-setup --ci --docker
/document
用途: 生成专业的面向用户或开发者的技术文档。
--user: 生成用户手册或指南。--technical: 生成面向开发者的技术文档。--api: 专注于生成API文档。
用法示例:
# 为项目的API生成包含代码示例的技术文档
/document --api --technical --examples
/estimate
用途: 对项目或功能进行专业的开发工作量估算。
--detailed: 提供详细的任务分解和估算。--worst-case: 提供悲观情况下的估算。--risk: 进行风险评估。
用法示例:
# 对新功能进行详细估算，并同步评估相关风险
/estimate --detailed --risk
/explain
用途: 对复杂的概念、代码或架构进行解释。
--depth [ELI5|expert]: 指定解释的深度 (ELI5: 像对5岁小孩解释)。--visual: 尝试使用图表（如Mermaid.js）进行解释。--examples: 提供代码示例。
用法示例:
# 用专家级的深度，并结合图表和多步推理来解释"React Hooks"
/explain "React Hooks" --depth expert --visual --seq
/git
用途: 执行专业的Git工作流操作，提供额外的安全保障。
--commit: 生成符合规范的、信息丰富的Git提交信息。--checkpoint [message]: 创建一个Git检查点，用于后续回滚。--history: 分析提交历史。
用法示例:
# 在进行大型重构前，创建一个名为"before-refactor"的安全检查点
/git --checkpoint "before-refactor"
/improve
用途: 对现有代码进行以证据为基础的质量、性能或可读性改进。
--quality: 专注于代码结构和质量的改进。--performance: 专注于性能优化。--refactor: 进行系统性的代码重构。
用法示例:
# 以重构专家的视角，系统性地改进代码质量
/improve --quality --refactor --persona-refactorer
/load
用途: 加载和分析项目上下文，为后续操作建立AI的认知基础。
--depth [shallow|deep]: 指定分析的深度。--patterns: 识别项目中的设计模式。--health: 评估项目的整体健康状况。
用法示例:
# 对项目进行深度分析，评估其整体健康状况
/load --depth deep --health
/migrate
用途: 安全地执行数据库、代码或配置的迁移。
--database: 执行数据库schema迁移。--code: 执行代码库（如框架升级）迁移。--backup: 在迁移前强制创建备份。
用法示例:
# 预览一次数据库迁移，但不实际执行
/migrate --database --dry-run
/review
用途: 进行AI驱动的、基于证据的全面代码审查。
--files [path]: 审查指定的文件或目录。--commit [hash]: 审查指定commit的变更。--pr [url|id]: 审查指定的Pull Request。--evidence: 要求所有建议都必须提供文档或来源作为证据。
用法示例:
# 以安全专家的视角，对src/auth目录进行审查，并要求所有建议提供证据
/review --files src/auth --persona-security --evidence
/scan
用途: 对项目进行安全审计和合规性验证。
--owasp: 按照OWASP Top 10标准进行扫描。--secrets: 扫描代码库中是否存在硬编码的密钥。--compliance: 进行合规性检查（如GDPR）。
用法示例:
# 对项目进行OWASP安全扫描和密钥扫描
/scan --owasp --secrets
/spawn
用途: 启动一个或多个并行的、专门的AI代理来处理复杂任务。
--task [description]: 定义代理需要执行的具体任务。--parallel: 并行执行多个任务。--collaborative: 让多个代理协同工作。
用法示例:
# 启动两个协同工作的代理，共同完成一个复杂任务
/spawn --task "frontend tests" --task "backend tests" --collaborative
/task
用途: 管理跨会话的复杂功能开发，提供长期记忆。
/task:create [description]: 创建一个新任务，AI会自动进行分解。/task:status [id]: 查看任务当前状态和进展。/task:resume [id]: 恢复一个中断的任务，AI会加载所有相关上下文。
用法示例:
# 创建一个复杂的开发任务
/task:create "Implement a complete user authentication system with OAuth2"
/test
用途: 创建、运行和维护项目的测试策略。
--e2e: 执行端到端测试。--integration: 执行集成测试。--unit: 执行单元测试。--performance: 执行性能测试。
用法示例:
# 使用Playwright运行项目的端到端测试，并计算代码覆盖率
/test --e2e --coverage --prit
/troubleshoot
用途: 系统性地诊断和解决生产环境或开发环境中的问题。
--investigate: 进行系统性的问题调查。--five-whys: 采用“五个为什么”方法进行根本原因分析。--prod: 专门针对生产环境的问题。
用法示例:
# 采用“五个为什么”方法，对生产环境问题进行根本原因分析
/troubleshoot --prod --five-whys --seq