17 KiB
SuperClaude 标志用户指南 🏁
🤖 大多数标志自动激活 - 不要为此烦恼！
诚实的真相：您不需要记住这些标志。SuperClaude 通常会根据您正在做的事情尝试添加有用的标志！
实际发生的情况：
- 您输入
/analyze auth.js - SuperClaude 检测到这是安全相关代码
- 通常添加
--persona-security、--focus security、--validate - 您通常无需管理任何标志就能获得专家安全分析
何时可能手动使用标志？
- 您想要覆盖 SuperClaude 选择的内容（罕见）
- 您对特定方面感到好奇（
--focus performance） - 您想要尝试不同的方法
底线：只需使用基本命令，让自动激活工作。这些标志在您需要时就在这里，不是因为您需要它们。🎯
🚀 直接尝试这些（无需标志知识）
# 这些零标志知识也能很好地工作：
/sc:analyze src/ # 自动选择正确的分析标志
/sc:build # 基于您的项目自动优化
/sc:improve messy-code.js # 自动激活质量和安全标志
/sc:troubleshoot "weird error" # 自动激活调试和分析标志
看到？不需要标志。 下面的一切都是当您对幕后发生的事情感到好奇时。
SuperClaude 标志系统的实用指南。标志就像改变 SuperClaude 行为的命令行选项 - 将它们视为命令的超能力。
什么是标志？🤔
标志是修饰符，改变 SuperClaude 处理您请求的方式。它们出现在命令之后，以 -- 开头。
基本语法（但您通常不需要知道这个）：
/sc:command --flag-name
/sc:command --flag-name value
/sc:analyze src/ --focus security --depth deep
标志在实际中如何工作：
- 自动激活 - SuperClaude 基于上下文添加它们（这是主要方式！🎯）
- 手动覆盖 - 如果您想要不同行为，可以显式添加它们
为什么存在标志（主要是自动好处）：
- 获得更好、更专注的结果
- 自动启用正确的思考深度
- 在有用时连接到特殊能力
- 根据任务优化速度或细节
- 将注意力集中在您实际正在做的事情上
关键点：SuperClaude 智能处理标志选择，因此您不必考虑它！🧠
标志类别 📂
规划和分析标志 🧠
这些控制 SuperClaude 对您请求思考的深度。
--plan
功能：在执行任何操作之前显示执行计划
何时使用：当您想首先看到 SuperClaude 将做什么时
示例：/build --plan - 运行前查看构建步骤
--think
功能：多文件分析（约 4K 令牌）
何时使用：涉及多个文件的复杂问题
自动激活：导入链 >5 个文件，跨模块调用 >10 个引用
示例：/analyze complex-system/ --think
--think-hard
功能：深度架构分析（约 10K 令牌）
何时使用：系统范围问题、架构决策
自动激活：系统重构、瓶颈 >3 个模块
示例：/improve legacy-system/ --think-hard
--ultrathink
功能：最大深度分析（约 32K 令牌）
何时使用：关键系统重新设计、复杂调试
自动激活：遗留现代化、关键漏洞
示例：/troubleshoot "entire auth system broken" --ultrathink
💡 提示：从 --think 开始，只有在需要时才深入。更深的思考 = 更慢但更彻底。
效率和控制标志 ⚡
控制输出样式、安全性和性能。
--uc / --ultracompressed
功能：使用符号减少 60-80% 的令牌
何时使用：大型操作、上下文变满时
自动激活：上下文使用 >75%、大规模操作
示例：/analyze huge-codebase/ --uc
--safe-mode
功能：最大验证、保守执行
何时使用：生产环境、风险操作
自动激活：资源使用 >85%、生产环境
示例：/improve production-code/ --safe-mode
--validate
功能：操作前验证和风险评估
何时使用：想要在更改前检查
自动激活：风险分数 >0.7
示例：/cleanup legacy/ --validate
--verbose
功能：最大详细程度和解释
何时使用：学习、调试、需要完整上下文
示例：/build --verbose - 查看每个构建步骤
--answer-only
功能：直接响应而不创建任务
何时使用：快速问题、不需要工作流程自动化
示例：/explain React hooks --answer-only
💡 提示：--uc 对大操作很棒。重要内容使用 --safe-mode。学习时使用 --verbose。
MCP 服务器标志 🔧
通过 MCP 服务器启用特殊能力。
--c7 / --context7
功能：启用 Context7 获取官方库文档
何时使用：使用框架、需要官方文档
自动激活：外部库导入、框架问题
示例：/build react-app/ --c7 - 获取 React 最佳实践
--seq / --sequential
功能：启用 Sequential 进行复杂的多步分析
何时使用：复杂调试、系统设计
自动激活：复杂调试、--think 标志
示例：/troubleshoot "auth flow broken" --seq
--magic
功能：启用 Magic 生成 UI 组件
何时使用：创建 UI 组件、设计系统
自动激活：UI 组件请求、前端角色
示例：/build dashboard --magic - 获取现代 UI 组件
--play / --playwright
功能：启用 Playwright 进行浏览器自动化和测试
何时使用：E2E 测试、性能监控
自动激活：测试工作流程、QA 角色
示例：/test e2e --play
--all-mcp
功能：同时启用所有 MCP 服务器
何时使用：复杂多域问题
自动激活：问题复杂性 >0.8、多域指标
示例：/analyze entire-app/ --all-mcp
--no-mcp
功能：禁用所有 MCP 服务器，仅本地工具
何时使用：更快执行、不需要特殊功能
示例：/analyze simple-script.js --no-mcp
💡 提示：MCP 服务器增加能力但使用更多令牌。文档使用 --c7，思考使用 --seq，UI 使用 --magic。
高级编排标志 🎭
用于复杂操作和工作流程。
--delegate [files|folders|auto]
功能：启用子代理委派进行并行处理 何时使用：大型代码库、复杂分析 自动激活：>7 个目录或 >50 个文件 选项：
files- 委派单个文件分析folders- 委派目录级分析auto- 智能委派策略
示例：/analyze monorepo/ --delegate auto
--wave-mode [auto|force|off]
功能：多阶段执行与复合智能
何时使用：复杂改进、系统分析
自动激活：复杂性 >0.8 AND 文件 >20 AND 操作类型 >2
示例：/improve legacy-system/ --wave-mode force
--loop
功能：迭代改进模式
何时使用：质量改进、精化操作
自动激活：polish、refine、enhance 关键词
示例：/improve messy-code.js --loop
--concurrency [n]
功能：控制最大并发子代理（1-15）
何时使用：控制资源使用
示例：/analyze --delegate auto --concurrency 3
💡 提示：这些很强大但复杂。大项目从 --delegate auto 开始，改进使用 --loop。
焦点和范围标志 🎯
将 SuperClaude 的注意力引导到特定区域。
--scope [level]
选项：file、module、project、system
功能：设置分析范围
示例：/analyze --scope module auth/
--focus [domain]
选项：performance、security、quality、architecture、accessibility、testing
功能：将分析聚焦到特定域
示例：/analyze --focus security --scope project
角色标志
可用角色：architect、frontend、backend、analyzer、security、mentor、refactorer、performance、qa、devops、scribe
功能：激活专家行为模式
示例：/analyze --persona-security - 安全聚焦分析
💡 提示：--focus 适合有针对性的分析。角色自动激活但手动控制有帮助。
常见标志模式 🔄
快速分析
/sc:analyze src/ --focus quality # 快速质量检查
/sc:analyze --uc --focus security # 快速安全扫描
深度调查
/sc:troubleshoot "bug" --think --seq # 系统调试
/sc:analyze --think-hard --focus architecture # 架构分析
大型项目工作
/sc:analyze monorepo/ --delegate auto --uc # 高效大型分析
/sc:improve legacy/ --wave-mode auto --safe-mode # 安全系统改进
学习和文档
/sc:explain React hooks --c7 --verbose # 带文档的详细解释
/sc:document api/ --persona-scribe # 专业文档
性能聚焦
/sc:analyze --focus performance --play # 带测试的性能分析
/sc:build --uc --no-mcp # 没有额外功能的快速构建
安全聚焦
/sc:analyze --focus security --think --validate # 全面的安全分析
/sc:scan --persona-security --safe-mode # 保守安全扫描
实用示例 💡
之前/之后：基本分析
之前（基本）：
/sc:analyze auth.js
# → 简单文件分析
之后（带标志）：
/sc:analyze auth.js --focus security --think --c7
# → 带深度思考和官方文档的安全聚焦分析
# → 更彻底，找到安全模式，检查最佳实践
之前/之后：大型项目
之前（慢）：
/sc:analyze huge-monorepo/
# → 尝试一次分析所有内容，可能超时或使用太多令牌
之后（高效）：
/sc:analyze huge-monorepo/ --delegate auto --uc --focus architecture
# → 委派工作给子代理，压缩输出，聚焦架构
# → 更快、更专注、更好的结果
之前/之后：改进工作
之前（有风险）：
/sc:improve legacy-system/
# → 可能进行太多更改，可能破坏东西
之后（安全）：
/sc:improve legacy-system/ --safe-mode --loop --validate --preview
# → 仅安全更改、迭代方法、先验证、显示预览
# → 更安全、渐进改进
自动激活示例 🤖
SuperClaude 通常基于上下文添加标志。以下是它尝试的时候：
基于复杂性
/sc:analyze huge-codebase/
# 自动添加：--delegate auto --uc
# 为什么：检测到 >50 个文件，需要上下文管理
/sc:troubleshoot "complex system issue"
# 自动添加：--think --seq
# 为什么：检测到多组件问题
基于域
/sc:build react-app/
# 自动添加：--c7 --persona-frontend
# 为什么：检测到前端框架
/sc:analyze --focus security
# 自动添加：--persona-security --validate
# 为什么：安全焦点触发安全专家
基于性能
# 当上下文使用 >75%
/sc:analyze large-project/
# 自动添加：--uc
# 为什么：需要令牌优化
# 当风险分数 >0.7
/sc:improve production-code/
# 自动添加：--safe-mode --validate
# 为什么：检测到高风险操作
高级使用 🚀
复杂标志组合
全面的代码审查：
/sc:review codebase/ --persona-qa --think-hard --focus quality --validate --c7
# → QA 专家 + 深度思考 + 质量焦点 + 验证 + 文档
遗留系统现代化：
/sc:improve legacy/ --wave-mode force --persona-architect --safe-mode --loop --c7
# → 波浪编排 + 架构师视角 + 安全 + 迭代 + 文档
安全审计：
/sc:scan --persona-security --ultrathink --focus security --validate --seq
# → 安全专家 + 最大思考 + 安全焦点 + 验证 + 系统分析
性能优化
为了速度：
/sc:analyze --no-mcp --uc --scope file
# → 禁用额外功能，压缩输出，限制范围
为了彻底性：
/sc:analyze --all-mcp --think-hard --delegate auto
# → 所有能力，深度思考，并行处理
自定义工作流程
错误调查工作流程：
/sc:troubleshoot "specific error" --seq --think --validate
/sc:analyze affected-files/ --focus quality --persona-analyzer
/sc:test --play --coverage
功能开发工作流程：
/sc:design new-feature --persona-architect --c7
/sc:build --magic --persona-frontend --validate
/sc:test --play --coverage
/sc:document --persona-scribe --c7
快速参考 📋
最有用的标志
| 标志 | 目的 | 何时使用 |
|---|---|---|
--think |
更深入分析 | 复杂问题 |
--uc |
压缩输出 | 大型操作 |
--safe-mode |
保守执行 | 重要代码 |
--c7 |
官方文档 | 框架工作 |
--seq |
系统分析 | 调试 |
--focus security |
安全焦点 | 安全问题 |
--delegate auto |
并行处理 | 大型代码库 |
--validate |
操作前检查 | 风险操作 |
效果良好的标志组合
# 安全改进
--safe-mode --validate --preview
# 深度分析
--think --seq --c7
# 大型项目
--delegate auto --uc --focus
# 学习
--verbose --c7 --persona-mentor
# 安全工作
--persona-security --focus security --validate
# 性能工作
--persona-performance --focus performance --play
自动激活触发器
- --think：复杂导入、跨模块调用
- --uc：上下文 >75%、大型操作
- --safe-mode：资源使用 >85%、生产环境
- --delegate：>7 个目录或 >50 个文件
- --c7：框架导入、文档请求
- --seq：调试关键词、--think 标志
- 角色：域特定关键词和模式
故障排除标志问题 🚨
常见问题
"标志似乎不起作用"
- 检查拼写（常见拼写错误：
--ultracompresed、--persona-fronted） - 某些标志需要值：
--scope project、--focus security - 标志冲突：
--no-mcp覆盖--c7、--seq等
"操作太慢"
- 尝试
--uc压缩 - 使用
--no-mcp禁用额外功能 - 限制范围：
--scope file而不是--scope project
"输出太多"
- 添加
--uc压缩 - 如果存在，移除
--verbose - 对简单问题使用
--answer-only
"不够彻底"
- 添加
--think或--think-hard - 启用相关 MCP 服务器：
--seq、--c7 - 使用适当的角色：
--persona-analyzer
"更改太有风险"
- 对重要代码始终使用
--safe-mode - 添加
--validate先检查 - 使用
--preview在应用前查看更改
标志冲突
这些覆盖其他：
--no-mcp覆盖所有 MCP 标志（--c7、--seq等）--safe-mode覆盖优化标志- 最后一个角色标志获胜：
--persona-frontend --persona-backend→ backend
优先级顺序：
- 安全标志（
--safe-mode）优于优化 - 显式标志优于自动激活
- 思考深度：
--ultrathink>--think-hard>--think - 范围：system > project > module > file
有效标志使用技巧 💡
初学阶段（诚实真相）
- 首先忽略标志 - 自动激活在大多数情况下效果很好
- 观察自动激活的内容 - 通过观察 SuperClaude 选择什么来学习
- 好奇时使用
--help- 许多命令显示可用标志 - 相信自动化 - SuperClaude 通常选择合理默认值
高级阶段（如果您想要）
- 尝试覆盖 - 在非安全代码上尝试
--persona-security获得不同视角 - 学习有用的组合 - 重要内容使用
--safe-mode --validate - 理解性能权衡 - 快速（
--uc --no-mcp）vs 彻底（--think-hard --all-mcp） - 使用标志学习 - 想要理解正在发生的事情时使用
--verbose
性能提示（对于高级用户）
- 为了速度：
--uc --no-mcp --scope file - 为了彻底性：
--think-hard --all-mcp --delegate auto - 为了安全：
--safe-mode --validate --preview - 为了学习：
--verbose --c7 --persona-mentor
最后说明 📝
关于标志的真相 💯：
- 自动激活通常比手动标志选择效果更好
- 您可以忽略本指南的大部分并只使用基本命令
- 标志在您需要时就在这里 - 不是因为您需要它们
- 学习通过使用自然发生，而不是通过研究指南 😊
不要感到不知所措 🧘♂️：
- SuperClaude 试图在不了解标志知识的情况下很好地工作
- 上面的详细信息是为了好奇，而非必要
- 基于使用模式，自动激活变得越来越智能
- 不记住标志，您不会错过什么
当您实际需要标志时：
- 覆盖自动激活（罕见）
- 尝试不同方法（有趣）
- 为特定性能需求优化（高级）
- 了解发生了什么（教育性）
保持简单，保持简单 🎯：
- 使用基本命令：
/analyze、/build、/improve - 让自动激活处理复杂性
- 只在想要实验时添加手动标志
- 相信 SuperClaude 知道它在做什么
请记住：在所有这些表面复杂性背后，SuperClaude 实际上很简单使用。只需开始输入命令！🚀