544 lines
17 KiB
Markdown
544 lines
17 KiB
Markdown
# 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 实际上很简单使用。只需开始输入命令！🚀*
|