translation/translated/documents/SuperClaude/Docs/commands-guide.md

SuperClaude 命令指南 🛠️

💡 不要想太多 - SuperClaude 试图提供帮助

关于这 17 个命令的真相：您不需要记住它们。只需从 /sc:analyze 或 /sc:implement 开始，看看会发生什么！

通常它是这样工作的：

• 在 Claude Code 中输入 / → 查看可用命令
• 使用基本命令如 /sc:analyze、/sc:build、/sc:improve
• SuperClaude 尝试为每种情况选择有用的工具和专家
• 当您适应时，更多命令会变得有用

自动激活相当 neat 🪄 - SuperClaude 尝试检测您想要做什么并激活相关专家（安全专家、性能优化器等），而无需您管理。通常效果很好！😊

---

快速"直接试试这些"列表 🚀

从这里开始（无需阅读）：

/sc:index                    # 查看可用内容
/sc:analyze src/            # 尝试智能分析您的代码
/sc:workflow feature-100-prd.md  # 从 PRD 创建分步实施工作流程
/sc:implement user-auth     # 创建功能和组件（替换 v2 的 /build）
/sc:build                   # 尝试智能项目构建
/sc:improve messy-file.js   # 尝试清理代码
/sc:troubleshoot "error"    # 尝试帮助解决问题

说实话，这足以开始。 当您对其他可用工具感到好奇时，下面的所有内容都在这里。🛠️

---

SuperClaude 全部 16 个斜杠命令的实用指南。我们将诚实地说出哪些工作得好，哪些仍然有粗糙边缘。

快速参考 📋

（您真的不需要记住这个 - 只需选择听起来有用的）

命令	目的	自动激活	最适合
/sc:analyze	智能代码分析	安全/性能专家	查找问题、理解代码库
/sc:build	智能构建	前端/后端专家	编译、打包、部署准备
/sc:implement	功能实现	领域特定专家	创建功能、组件、API、服务
/sc:improve	自动代码清理	质量专家	重构、优化、质量修复
/sc:troubleshoot	问题调查	调试专家	调试、问题调查
/sc:test	智能测试	QA 专家	运行测试、覆盖率分析
/sc:document	自动文档	写作专家	README 文件、代码注释、指南
/sc:git	增强 git 工作流程	DevOps 专家	智能提交、分支管理
/sc:design	系统设计帮助	架构专家	架构规划、API 设计
/sc:explain	学习助手	教学专家	学习概念、理解代码
/sc:cleanup	减少债务	重构专家	删除死代码、组织文件
/sc:load	上下文理解	分析专家	项目分析、代码库理解
/sc:estimate	智能估算	规划专家	时间/精力规划、复杂性分析
/sc:spawn	复杂工作流程	编排系统	多步操作、工作流程自动化
/sc:task	项目管理	规划系统	长期功能规划、任务跟踪
/sc:workflow	实施规划	工作流程系统	从 PRD 创建分步工作流程
/sc:index	命令导航	帮助系统	为您的任务找到正确的命令

专业提示：只需尝试听起来有用的命令。SuperClaude 通常会为每种情况尝试激活有用的专家和工具！🎯

开发命令 🔨

/workflow - 工作流程实施生成器 🗺️

功能：分析 PRD 和功能要求，创建全面的分步实施工作流程。

有用的部分：获取您的 PRD 并将其分解为结构化的实施计划，包含专家指导、依赖映射和任务编排！🎯

何时使用：

• 从 PRD 或规范开始新功能
• 需要清晰的实施路线图
• 希望获得实施策略的专家指导
• 规划具有多个依赖项的复杂功能

神奇之处：根据您的功能要求自动激活适当的专家角色（架构师、安全、前端、后端）和 MCP 服务器（Context7 用于模式，Sequential 用于复杂分析）。

示例：

/sc:workflow docs/feature-100-prd.md --strategy systematic --c7 --sequential
/sc:workflow "user authentication system" --persona security --output detailed
/sc:workflow payment-api --strategy mvp --risks --dependencies

您得到的：

• 路线图格式：基于阶段的时间表实施计划
• 任务格式：组织化的史诗、故事和可操作任务
• 详细格式：带时间估算的分步说明
• 风险评估：潜在问题和缓解策略
• 依赖映射：内部和外部依赖
• 专家指导：领域特定的最佳实践和模式

/implement - 功能实施

功能：通过智能专家激活实现功能、组件和功能。

有用的部分：SuperClaude 根据您正在实现的内容自动激活正确的专家（前端、后端、安全）和工具！🎯

何时使用：

• 创建新功能或组件（替换 v2 的 /build 功能）
• 实现 API、服务或模块
• 使用现代框架构建 UI 组件
• 开发业务逻辑和集成

基本语法：

/sc:implement user authentication system      # 实现完整功能
/sc:implement --type component LoginForm      # 创建特定组件
/sc:implement --type api user-management      # 构建 API 端点
/sc:implement --framework react dashboard     # 特定于框架的实施

有用的标志：

• --type component|api|service|feature|module - 实施类型
• --framework react|vue|express|django|etc - 目标框架
• --safe - 保守的实施方法
• --iterative - 带验证的分步开发
• --with-tests - 包含测试实施
• --documentation - 随代码生成文档

实际示例：

/sc:implement user authentication --type feature --with-tests
/sc:implement dashboard component --type component --framework react
/sc:implement REST API for orders --type api --safe
/sc:implement payment processing --type service --iterative
/sc:implement search functionality --framework vue --documentation

自动激活模式：

• 前端：UI 组件、React/Vue/Angular → 前端角色 + Magic MCP
• 后端：API、服务、数据库 → 后端角色 + Context7
• 安全：身份验证、支付、敏感数据 → 安全角色 + 验证
• 复杂功能：多步实施 → Sequential MCP + 架构师角色

注意事项：

• 指定 --type 以获得更好的结果（组件 vs 服务 vs 功能）
• 使用特定技术栈时使用 --framework
• 生产代码尝试 --safe 或复杂功能尝试 --iterative
• 记住：这替换了 v2 的 /build 用于实际代码实施

---

/build - 项目构建

功能：构建、编译和打包项目，具有智能错误处理。

简单方法：只需输入 /sc:build，SuperClaude 尝试弄清楚您的构建系统！🎯

何时使用：

• 您需要编译/捆绑项目（只需尝试 /sc:build）
• 构建过程失败，您想要调试帮助
• 设置构建优化（它尝试检测您需要什么）
• 为部署做准备

基本语法：

/sc:build                          # 构建当前项目
/sc:build --type prod              # 生产构建
/sc:build --clean                  # 清理构建（删除旧构件）
/sc:build --optimize               # 启用优化
/sc:build src/                     # 构建特定目录

有用的标志：

• --type dev|prod|test - 构建类型
• --clean - 构建前清理
• --optimize - 启用构建优化
• --verbose - 显示详细构建输出

实际示例：

/sc:build --type prod --optimize   # 带优化的生产构建
/sc:build --clean --verbose        # 带详细输出的清理构建
/sc:build src/components           # 仅构建组件文件夹

注意事项：

• 与常见构建工具（npm、webpack 等）配合使用效果最好
• 可能在非常定制的构建设置中遇到困难
• 检查您的构建工具在 PATH 中

---

/design - 系统和组件设计

功能：创建系统架构、API 设计和组件规范。

何时使用：

• 规划新功能或系统
• 需要 API 或数据库设计
• 创建组件架构
• 记录系统关系

基本语法：

/sc:design user-auth-system        # 设计用户认证系统
/sc:design --type api auth         # 仅设计 API 部分
/sc:design --format spec payment   # 创建正式规范

有用的标志：

• --type architecture|api|component|database - 设计焦点
• --format diagram|spec|code - 输出格式
• --iterative - 通过迭代优化设计

实际示例：

/sc:design --type api user-management    # 设计用户管理 API
/sc:design --format spec chat-system     # 创建聊天系统规范
/sc:design --type database ecommerce     # 设计数据库模式

注意事项：

• 更多是概念性的而非代码生成
• 输出质量取决于您描述需求的清晰程度
• 适合规划阶段，不适合实施细节

分析命令 🔍

/analyze - 代码分析

功能：对代码质量、安全性、性能和架构进行全面分析。

有用的部分：SuperClaude 尝试检测您需要什么类型的分析，通常会选择相关专家！🔍

何时使用：

• 理解不熟悉的代码库（只需将其指向任何文件夹）
• 查找安全漏洞（安全专家通常会介入）
• 性能瓶颈搜索（性能专家通常会帮助）
• 代码质量评估（质量专家通常会接管）

基本语法：

/sc:analyze src/                   # 分析整个 src 目录
/sc:analyze --focus security       # 关注安全问题
/sc:analyze --depth deep app.js    # 深度分析特定文件

有用的标志：

• --focus quality|security|performance|architecture - 分析焦点
• --depth quick|deep - 分析彻底性
• --format text|json|report - 输出格式

实际示例：

/sc:analyze --focus security --depth deep     # 深度安全分析
/sc:analyze --focus performance src/api/      # API 性能分析
/sc:analyze --format report .                 # 生成分析报告

注意事项：

• 在大型代码库上可能需要一段时间
• 安全分析相当好，性能分析因情况而异
• 与常见语言（JS、Python 等）配合使用效果最好

---

/troubleshoot - 问题调查

功能：系统调试和问题调查。

何时使用：

• 某些东西坏了，您不确定为什么
• 需要系统调试方法
• 错误消息令人困惑
• 性能问题调查

基本语法：

/sc:troubleshoot "login not working"     # 调查登录问题
/sc:troubleshoot --logs error.log        # 分析错误日志
/sc:troubleshoot performance             # 性能故障排除

有用的标志：

• --logs <file> - 包含日志文件分析
• --systematic - 使用结构化调试方法
• --focus network|database|frontend - 焦点区域

实际示例：

/sc:troubleshoot "API returning 500" --logs server.log
/sc:troubleshoot --focus database "slow queries"
/sc:troubleshoot "build failing" --systematic

注意事项：

• 在特定错误描述下效果更好
• 尽可能包含相关错误消息和日志
• 可能首先建议显而易见的事情（这通常很好！）

---

/explain - 教育解释

功能：以教育方式解释代码、概念和技术。

何时使用：

• 学习新技术或模式
• 理解复杂代码
• 需要为团队成员提供清晰解释
• 记录棘手概念

基本语法：

/sc:explain async/await               # 解释 async/await 概念
/sc:explain --code src/utils.js       # 解释特定代码文件
/sc:explain --beginner React hooks    # 适合初学者的解释

有用的标志：

• --beginner - 更简单的解释
• --advanced - 技术深度
• --code <file> - 解释特定代码
• --examples - 包含实际示例

实际示例：

/sc:explain --beginner "what is REST API"
/sc:explain --code src/auth.js --advanced
/sc:explain --examples "React context patterns"

注意事项：

• 对于知名概念很棒，对于非常小众的话题可能困难
• 比模糊的"解释这个代码库"更适合具体问题
• 包含您经验水平的背景

质量命令 ✨

/improve - 代码增强

功能：对代码质量、性能和可维护性进行系统性改进。

何时使用：

• 重构混乱的代码
• 性能优化
• 应用最佳实践
• 现代化旧代码

基本语法：

/sc:improve src/legacy/            # 改进遗留代码
/sc:improve --type performance     # 关注性能
/sc:improve --safe src/utils.js    # 仅安全、低风险改进

有用的标志：

• --type quality|performance|maintainability|style - 改进焦点
• --safe - 仅应用低风险更改
• --preview - 显示将要更改的内容而不执行

实际示例：

/sc:improve --type performance --safe src/api/
/sc:improve --preview src/components/LegacyComponent.js
/sc:improve --type style . --safe

注意事项：

• 始终首先使用 --preview 查看它想要更改什么
• --safe 是您的朋友 - 防止风险重构
• 在较小的文件/模块上比在整个代码库上效果更好

---

/cleanup - 技术债务减少

功能：删除死代码、未使用的导入并组织文件结构。

何时使用：

• 代码库感觉杂乱
• 大量未使用的导入/变量
• 文件组织混乱
• 重大重构之前

基本语法：

/sc:cleanup src/                   # 清理 src 目录
/sc:cleanup --dead-code            # 关注删除死代码
/sc:cleanup --imports package.js   # 清理特定文件中的导入

有用的标志：

• --dead-code - 删除未使用的代码
• --imports - 清理导入语句
• --files - 重新组织文件结构
• --safe - 仅保守清理

实际示例：

/sc:cleanup --dead-code --safe src/utils/
/sc:cleanup --imports src/components/
/sc:cleanup --files . --safe

注意事项：

• 可能激进 - 始终仔细审查更改
• 可能无法捕获所有死代码（特别是动态导入）
• 最好在较小部分而不是整个项目上运行

---

/test - 测试和质量保证

功能：运行测试、生成覆盖率报告并维护测试质量。

何时使用：

• 运行测试套件
• 检查测试覆盖率
• 生成测试报告
• 设置持续测试

基本语法：

/sc:test                           # 运行所有测试
/sc:test --type unit               # 仅运行单元测试
/sc:test --coverage                # 生成覆盖率报告
/sc:test --watch src/              # 开发观察模式

有用的标志：

• --type unit|integration|e2e|all - 测试类型
• --coverage - 生成覆盖率报告
• --watch - 在观察模式下运行测试
• --fix - 尝试自动修复失败的测试

实际示例：

/sc:test --type unit --coverage
/sc:test --watch src/components/
/sc:test --type e2e --fix

注意事项：

• 需要您的测试框架正确配置
• 覆盖率报告取决于您现有的测试设置
• --fix 是实验性的 - 审查它更改的内容

文档命令 📝

/document - 专注文档

功能：为特定组件、函数或功能创建文档。

何时使用：

• 需要 README 文件
• 编写 API 文档
• 添加代码注释
• 创建用户指南

基本语法：

/sc:document src/api/auth.js       # 记录认证模块
/sc:document --type api            # API 文档
/sc:document --style brief README  # 简短 README 文件

有用的标志：

• --type inline|external|api|guide - 文档类型
• --style brief|detailed - 详细程度
• --template - 使用特定文档模板

实际示例：

/sc:document --type api src/controllers/
/sc:document --style detailed --type guide user-onboarding
/sc:document --type inline src/utils/helpers.js

注意事项：

• 与整个项目相比，更适合特定文件/函数
• 质量取决于代码结构化程度
• 可能需要一些编辑以匹配您项目的文档风格

项目管理命令 📊

/estimate - 项目估算

功能：估算开发任务的时间、精力和复杂性。

何时使用：

• 规划新功能
• 冲刺规划
• 理解项目复杂性
• 资源分配

基本语法：

/sc:estimate "add user authentication"    # 估算身份验证功能
/sc:estimate --detailed shopping-cart     # 详细分解
/sc:estimate --complexity user-dashboard  # 复杂性分析

有用的标志：

• --detailed - 任务详细分解
• --complexity - 关注技术复杂性
• --team-size <n> - 在估算中考虑团队规模

实际示例：

/sc:estimate --detailed "implement payment system"
/sc:estimate --complexity --team-size 3 "migrate to microservices"
/sc:estimate "add real-time chat" --detailed

注意事项：

• 估算是粗略的 - 用作起点，而非金科玉律
• 在清晰、具体的功能描述下效果更好
• 考虑您团队在技术栈方面的经验

---

/task - 长期项目管理

功能：管理复杂的多会话开发任务和功能。

何时使用：

• 规划需要数天/数周的功能
• 分解大型项目
• 跨会话跟踪进度
• 协调团队工作

基本语法：

/sc:task create "implement user dashboard"  # 创建新任务
/sc:task status                            # 检查任务状态
/sc:task breakdown "payment integration"    # 分解为子任务

有用的标志：

• create - 创建新的长期任务
• status - 检查当前任务状态
• breakdown - 将大任务分解为小任务
• --priority high|medium|low - 设置任务优先级

实际示例：

/sc:task create "migrate from REST to GraphQL" --priority high
/sc:task breakdown "e-commerce checkout flow"
/sc:task status

注意事项：

• 仍在实验中 - 并不总是能可靠地跨会话持久化 😅
• 更适合规划而非实际项目管理
• 当您对需求具体时效果最好

---

/spawn - 复杂操作编排

功能：协调复杂的多步操作和工作流程。

何时使用：

• 涉及多个工具/系统的操作
• 协调并行工作流程
• 复杂部署流程
• 多阶段数据处理

基本语法：

/sc:spawn deploy-pipeline          # 编排部署
/sc:spawn --parallel migrate-data  # 并行数据迁移
/sc:spawn setup-dev-environment    # 复杂环境设置

有用的标志：

• --parallel - 可能时并行运行操作
• --sequential - 强制顺序执行
• --monitor - 监控操作进度

实际示例：

/sc:spawn --parallel "test and deploy to staging"
/sc:spawn setup-ci-cd --monitor
/sc:spawn --sequential database-migration

注意事项：

• 最复杂的命令 - 预期一些粗糙边缘
• 对于定义明确的工作流程比临时操作更好
• 可能需要多次迭代才能正确

版本控制命令 🔄

/git - 增强 Git 操作

功能：Git 操作具有智能提交消息和工作流程优化。

何时使用：

• 制作具有更好消息的提交
• 分支管理
• 复杂 git 工作流程
• Git 故障排除

基本语法：

/sc:git commit                     # 智能提交，自动生成消息
/sc:git --smart-commit add .       # 添加并智能提交
/sc:git branch feature/new-auth    # 创建并切换到新分支

有用的标志：

• --smart-commit - 生成智能提交消息
• --branch-strategy - 应用分支命名约定
• --interactive - 复杂操作的交互模式

实际示例：

/sc:git --smart-commit "fixed login bug"
/sc:git branch feature/user-dashboard --branch-strategy
/sc:git merge develop --interactive

注意事项：

• 智能提交消息相当不错，但请审查它们
• 假设您遵循常见 git 工作流程
• 不会修复不良 git 习惯 - 只是让它们更容易

实用命令 🔧

/index - 命令导航

功能：帮助您为任务找到正确的命令。

何时使用：

• 不确定使用哪个命令
• 探索可用命令
• 了解命令能力

基本语法：

/sc:index                          # 列出所有命令
/sc:index testing                  # 查找与测试相关的命令
/sc:index --category analysis      # 分析类别中的命令

有用的标志：

• --category <cat> - 按命令类别过滤
• --search <term> - 搜索命令描述

实际示例：

/sc:index --search "performance"
/sc:index --category quality
/sc:index git

注意事项：

• 简单但对发现有用
• 比尝试记住所有 16 个命令更好

---

/load - 项目上下文加载

功能：加载和分析项目上下文以获得更好理解。

何时使用：

• 开始不熟悉项目上的工作
• 需要理解项目结构
• 进行重大更改之前
• 团队成员入职

基本语法：

/sc:load                           # 加载当前项目上下文
/sc:load src/                      # 加载特定目录上下文
/sc:load --deep                    # 深度分析项目结构

有用的标志：

• --deep - 全面的项目分析
• --focus <area> - 关注特定项目区域
• --summary - 生成项目摘要

实际示例：

/sc:load --deep --summary
/sc:load src/components/ --focus architecture
/sc:load . --focus dependencies

注意事项：

• 在大型项目上可能需要时间
• 在项目开始时比开发期间更有用
• 有助于入职，但不能替代良好的文档

命令提示和模式 💡

有效标志组合

# 安全改进工作流程
/sc:improve --preview src/component.js    # 查看会更改什么
/sc:improve --safe src/component.js       # 仅应用安全更改

# 全面的分析
/sc:analyze --focus security --depth deep
/sc:test --coverage
/sc:document --type api

# 智能 git 工作流程
/sc:git add .
/sc:git --smart-commit --branch-strategy

# 项目理解工作流程
/sc:load --deep --summary
/sc:analyze --focus architecture
/sc:document --type guide

常见工作流程

新项目入职：

/sc:load --deep --summary
/sc:analyze --focus architecture
/sc:test --coverage
/sc:document README

错误调查：

/sc:troubleshoot "specific error message" --logs
/sc:analyze --focus security
/sc:test --type unit affected-component

代码质量改进：

/sc:analyze --focus quality
/sc:improve --preview src/
/sc:cleanup --safe
/sc:test --coverage

部署前检查清单：

/sc:test --type all --coverage
/sc:analyze --focus security
/sc:build --type prod --optimize
/sc:git --smart-commit

故障排除命令问题

命令未按预期工作？

• 尝试添加 --help 查看所有选项
• 可用时使用 --preview 或 --safe 标志
• 从较小范围开始（单个文件 vs 整个项目）

分析花费时间太长？

• 使用 --focus 缩小范围
• 尝试 --depth quick 而不是深度分析
• 首先分析较小的目录

构建/测试命令失败？

• 确保您的工具在 PATH 中
• 检查配置文件在预期位置
• 首先尝试直接运行底层命令

不确定使用哪个命令？

• 使用 /index 浏览可用命令
• 查看上面的快速参考表
• 首先尝试最具体的命令，然后是更宽泛的命令

---

最后说明 📝

关于这些命令的真相 💯：

• 只需尝试它们 - 您无需首先研究此指南
• 从基础开始 - /analyze、/build、/improve 涵盖大多数需求
• 让自动激活工作 - SuperClaude 通常会选择有用的专家
• 自由实验 - 如果您想先看到会发生什么，使用 --preview

仍然有粗糙边缘：

• 复杂编排（spawn、task）可能有点不稳定
• 某些分析很大程度上取决于您的项目设置
• 某些命令中的错误处理可以更好

一直在改进：

• 我们根据用户反馈积极改进命令
• 较新的命令（analyze、improve）往往效果更好
• 自动激活变得越来越智能

不要为记住这个而压力 🧘‍♂️

• SuperClaude 设计为通过使用即可发现
• 输入 / 查看可用命令
• 当您使用 --help 时，命令建议它们能做什么
• 智能路由处理大部分复杂性

需要帮助？ 查看 GitHub 问题或在卡住时创建一个新问题！🚀

---

快乐编码！请记住 - 您可以跳过本指南的大部分内容并通过实践学习。🎯