# SuperClaude 标志用户指南 🏁

## 🤖 大多数标志自动激活 - 不要为此烦恼！

**诚实的真相**：您不需要记住这些标志。SuperClaude 通常会根据您正在做的事情尝试添加有用的标志！

**实际发生的情况：**
- 您输入 `/analyze auth.js`
- SuperClaude 检测到这是安全相关代码
- **通常添加** `--persona-security`、`--focus security`、`--validate`
- 您通常无需管理任何标志就能获得专家安全分析

**何时可能手动使用标志？**
- 您想要**覆盖** SuperClaude 选择的内容（罕见）
- 您对特定方面感到**好奇**（`--focus performance`）
- 您想要**尝试**不同的方法

**底线**：只需使用基本命令，让自动激活工作。这些标志在您需要时就在这里，不是因为您需要它们。🎯

---

## 🚀 直接尝试这些（无需标志知识）

```bash
# 这些零标志知识也能很好地工作：
/sc:analyze src/                    # 自动选择正确的分析标志
/sc:build                          # 基于您的项目自动优化
/sc:improve messy-code.js          # 自动激活质量和安全标志
/sc:troubleshoot "weird error"     # 自动激活调试和分析标志
```

**看到？不需要标志。** 下面的一切都是当您对幕后发生的事情感到好奇时。

---

SuperClaude 标志系统的实用指南。标志就像改变 SuperClaude 行为的命令行选项 - 将它们视为命令的超能力。

## 什么是标志？🤔

**标志是修饰符**，改变 SuperClaude 处理您请求的方式。它们出现在命令之后，以 `--` 开头。

**基本语法**（但您通常不需要知道这个）：
```bash
/sc:command --flag-name
/sc:command --flag-name value
/sc:analyze src/ --focus security --depth deep
```

**标志在实际中如何工作**：
1. **自动激活** - SuperClaude 基于上下文添加它们（这是主要方式！🎯）
2. **手动覆盖** - 如果您想要不同行为，可以显式添加它们

**为什么存在标志**（主要是自动好处）：
- 获得更好、更专注的结果
- 自动启用正确的思考深度
- 在有用时连接到特殊能力
- 根据任务优化速度或细节
- 将注意力集中在您实际正在做的事情上

**关键点**：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` 适合有针对性的分析。角色自动激活但手动控制有帮助。

---

## 常见标志模式 🔄

### 快速分析
```bash
/sc:analyze src/ --focus quality          # 快速质量检查
/sc:analyze --uc --focus security         # 快速安全扫描
```

### 深度调查
```bash
/sc:troubleshoot "bug" --think --seq      # 系统调试
/sc:analyze --think-hard --focus architecture  # 架构分析
```

### 大型项目工作
```bash
/sc:analyze monorepo/ --delegate auto --uc     # 高效大型分析
/sc:improve legacy/ --wave-mode auto --safe-mode  # 安全系统改进
```

### 学习和文档
```bash
/sc:explain React hooks --c7 --verbose    # 带文档的详细解释
/sc:document api/ --persona-scribe        # 专业文档
```

### 性能聚焦
```bash
/sc:analyze --focus performance --play     # 带测试的性能分析
/sc:build --uc --no-mcp                   # 没有额外功能的快速构建
```

### 安全聚焦
```bash
/sc:analyze --focus security --think --validate  # 全面的安全分析
/sc:scan --persona-security --safe-mode         # 保守安全扫描
```

## 实用示例 💡

### 之前/之后：基本分析
**之前**（基本）：
```bash
/sc:analyze auth.js
# → 简单文件分析
```

**之后**（带标志）：
```bash
/sc:analyze auth.js --focus security --think --c7
# → 带深度思考和官方文档的安全聚焦分析
# → 更彻底，找到安全模式，检查最佳实践
```

### 之前/之后：大型项目
**之前**（慢）：
```bash
/sc:analyze huge-monorepo/
# → 尝试一次分析所有内容，可能超时或使用太多令牌
```

**之后**（高效）：
```bash
/sc:analyze huge-monorepo/ --delegate auto --uc --focus architecture
# → 委派工作给子代理，压缩输出，聚焦架构
# → 更快、更专注、更好的结果
```

### 之前/之后：改进工作
**之前**（有风险）：
```bash
/sc:improve legacy-system/
# → 可能进行太多更改，可能破坏东西
```

**之后**（安全）：
```bash
/sc:improve legacy-system/ --safe-mode --loop --validate --preview
# → 仅安全更改、迭代方法、先验证、显示预览
# → 更安全、渐进改进
```

## 自动激活示例 🤖

SuperClaude 通常基于上下文添加标志。以下是它尝试的时候：

### 基于复杂性
```bash
/sc:analyze huge-codebase/
# 自动添加：--delegate auto --uc
# 为什么：检测到 >50 个文件，需要上下文管理

/sc:troubleshoot "complex system issue"
# 自动添加：--think --seq
# 为什么：检测到多组件问题
```

### 基于域
```bash
/sc:build react-app/
# 自动添加：--c7 --persona-frontend
# 为什么：检测到前端框架

/sc:analyze --focus security
# 自动添加：--persona-security --validate
# 为什么：安全焦点触发安全专家
```

### 基于性能
```bash
# 当上下文使用 >75%
/sc:analyze large-project/
# 自动添加：--uc
# 为什么：需要令牌优化

# 当风险分数 >0.7
/sc:improve production-code/
# 自动添加：--safe-mode --validate
# 为什么：检测到高风险操作
```

## 高级使用 🚀

### 复杂标志组合

**全面的代码审查**：
```bash
/sc:review codebase/ --persona-qa --think-hard --focus quality --validate --c7
# → QA 专家 + 深度思考 + 质量焦点 + 验证 + 文档
```

**遗留系统现代化**：
```bash
/sc:improve legacy/ --wave-mode force --persona-architect --safe-mode --loop --c7
# → 波浪编排 + 架构师视角 + 安全 + 迭代 + 文档
```

**安全审计**：
```bash
/sc:scan --persona-security --ultrathink --focus security --validate --seq
# → 安全专家 + 最大思考 + 安全焦点 + 验证 + 系统分析
```

### 性能优化

**为了速度**：
```bash
/sc:analyze --no-mcp --uc --scope file
# → 禁用额外功能，压缩输出，限制范围
```

**为了彻底性**：
```bash
/sc:analyze --all-mcp --think-hard --delegate auto
# → 所有能力，深度思考，并行处理
```

### 自定义工作流程

**错误调查工作流程**：
```bash
/sc:troubleshoot "specific error" --seq --think --validate
/sc:analyze affected-files/ --focus quality --persona-analyzer
/sc:test --play --coverage
```

**功能开发工作流程**：
```bash
/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` | 操作前检查 | 风险操作 |

### 效果良好的标志组合
```bash
# 安全改进
--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

**优先级顺序**：
1. 安全标志（`--safe-mode`）优于优化
2. 显式标志优于自动激活
3. 思考深度：`--ultrathink` > `--think-hard` > `--think`
4. 范围：system > project > module > file

## 有效标志使用技巧 💡

### 初学阶段（诚实真相）
1. **首先忽略标志** - 自动激活在大多数情况下效果很好
2. **观察自动激活的内容** - 通过观察 SuperClaude 选择什么来学习
3. **好奇时使用 `--help`** - 许多命令显示可用标志
4. **相信自动化** - SuperClaude 通常选择合理默认值

### 高级阶段（如果您想要）
1. **尝试覆盖** - 在非安全代码上尝试 `--persona-security` 获得不同视角
2. **学习有用的组合** - 重要内容使用 `--safe-mode --validate`
3. **理解性能权衡** - 快速（`--uc --no-mcp`）vs 彻底（`--think-hard --all-mcp`）
4. **使用标志学习** - 想要理解正在发生的事情时使用 `--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 实际上很简单使用。只需开始输入命令！🚀*