# 工作流命令

## 一句话定位

**工作流命令是 Claude Code Workflow 的执行引擎** — 提供从轻量级任务到复杂项目的完整工作流支持。

## 命令列表

### 轻量级工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`lite-plan`](#lite-plan) | 轻量级交互式规划工作流 | `/workflow-lite-plan [-y] [-e] "任务"` |

### 标准工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`plan`](#plan) | 5 阶段规划工作流 | `/workflow-plan [-y] "描述"\|file.md` |
| [`execute`](#execute) | 协调代理执行工作流任务 | `/workflow-execute [-y] [--resume-session=ID]` |
| [`replan`](#replan) | 交互式工作流重新规划 | `/workflow:replan [-y] [--session ID] [task-id] "需求"` |

### 协作工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`multi-cli-plan`](#multi-cli-plan) | 多 CLI 协作规划 | `/workflow-multi-cli-plan [-y] <任务> [--max-rounds=N]` |
| [`brainstorm-with-file`](#brainstorm-with-file) | 交互式头脑风暴 | `/workflow:brainstorm-with-file [-y] [-c] "想法"` |
| [`analyze-with-file`](#analyze-with-file) | 交互式协作分析 | `/workflow:analyze-with-file [-y] [-c] "主题"` |
| [`debug-with-file`](#debug-with-file) | 交互式假设驱动调试 | `/workflow:debug-with-file [-y] "Bug 描述"` |
| [`unified-execute-with-file`](#unified-execute-with-file) | 通用执行引擎 | `/workflow:unified-execute-with-file [-y] [-p path] [上下文]` |

### TDD 工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`tdd-plan`](#tdd-plan) | TDD 规划工作流 | `/workflow-tdd-plan "功能描述"` |
| [`tdd-verify`](#tdd-verify) | 验证 TDD 工作流合规性 | `/workflow-tdd-verify [--session ID]` |

### 测试工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`test-fix-gen`](#test-fix-gen) | 创建测试修复工作流会话 | `/workflow-test-fix (session-id\|"描述"\|file.md)` |
| [`test-gen`](#test-gen) | 从实现会话创建测试会话 | `/workflow:test-gen source-session-id` |
| [`test-cycle-execute`](#test-cycle-execute) | 执行测试修复工作流 | `/workflow-test-fix [--resume-session=ID]` |

### 审查工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`review`](#review) | 实现后审查 | `/workflow:review [--type=类型] [--archived] [session-id]` |
| [`review-module-cycle`](#review-module-cycle) | 独立多维度代码审查 | `/workflow:review-module-cycle <路径> [--dimensions=维度]` |
| [`review-session-cycle`](#review-session-cycle) | 基于会话的审查 | `/workflow:review-session-cycle [session-id] [--dimensions=维度]` |
| [`review-cycle-fix`](#review-cycle-fix) | 自动修复审查发现 | `/workflow:review-cycle-fix <export-file\|review-dir>` |

### 专用工作流

| 命令 | 功能 | 语法 |
| --- | --- | --- |
| [`clean`](#clean) | 智能代码清理 | `/workflow:clean [-y] [--dry-run] ["焦点区域"]` |
| [`init`](#init) | 初始化项目状态 | `/workflow:spec:setup  [--regenerate]` |
| [`plan-verify`](#plan-verify) | 验证规划一致性 | `/workflow-plan-verify [--session session-id]` |

## 命令详解

### lite-plan

**功能**: 轻量级交互式规划和执行工作流（Phase 1: 规划，Phase 2: 执行），支持内存规划、代码探索和确认后自动执行。

**语法**:
```bash
/workflow-lite-plan [-y|--yes] [-e|--explore] "任务描述" | file.md
```

**选项**:
- `-e, --explore`: 先执行代码探索

**示例**:
```bash
# 基础规划
/workflow-lite-plan "添加用户头像功能"

# 带探索
/workflow-lite-plan -e "重构认证模块"
```

### plan

**功能**: 5 阶段规划工作流，输出 IMPL_PLAN.md 和任务 JSON。

**语法**:
```bash
/workflow-plan [-y|--yes] "文本描述" | file.md
```

**阶段**:
1. 会话初始化
2. 上下文收集
3. 规范加载
4. 任务生成
5. 验证/重新规划

**示例**:
```bash
# 从描述规划
/workflow-plan "实现用户通知系统"

# 从文件规划
/workflow-plan requirements.md
```

### execute

**功能**: 协调代理执行工作流任务，支持自动会话发现、并行任务处理和状态跟踪。

**语法**:
```bash
/workflow-execute [-y|--yes] [--resume-session="session-id"]
```

**示例**:
```bash
# 执行当前会话
/workflow-execute

# 恢复并执行会话
/workflow-execute --resume-session=WFS-2024-01-15
```

### replan

**功能**: 交互式工作流重新规划，支持会话级工件更新和边界澄清。

**语法**:
```bash
/workflow:replan [-y|--yes] [--session session-id] [task-id] "需求" | file.md [--interactive]
```

**示例**:
```bash
# 重新规划整个会话
/workflow:replan --session=WFS-xxx "添加用户权限检查"

# 重新规划特定任务
/workflow:replan TASK-001 "改为使用 RBAC"
```

### multi-cli-plan

**功能**: 多 CLI 协作规划工作流，使用 ACE 上下文收集和迭代交叉验证。

**语法**:
```bash
/workflow-multi-cli-plan [-y|--yes] <任务描述> [--max-rounds=3] [--tools=gemini,codex] [--mode=parallel|serial]
```

**选项**:
- `--max-rounds=N`: 最大讨论轮数
- `--tools=工具`: 使用的 CLI 工具
- `--mode=模式`: 并行或串行模式

**示例**:
```bash
# 多 CLI 规划
/workflow-multi-cli-plan "设计微服务架构"

# 指定工具和轮数
/workflow-multi-cli-plan --tools=gemini,codex --max-rounds=5 "数据库迁移方案"
```

### brainstorm-with-file

**功能**: 交互式头脑风暴，多 CLI 协作、想法扩展和文档化思维演化。

**语法**:
```bash
/workflow:brainstorm-with-file [-y|--yes] [-c|--continue] [-m|--mode creative|structured] "想法或主题"
```

**选项**:
- `-c, --continue`: 继续现有会话
- `-m, --mode=模式`: creative 或 structured

**示例**:
```bash
# 创意头脑风暴
/workflow:brainstorm-with-file --mode creative "用户增长策略"

# 结构化头脑风暴
/workflow:brainstorm-with-file --mode structured "API 版本控制方案"
```

### analyze-with-file

**功能**: 交互式协作分析，有文档化的讨论、CLI 辅助探索和演化理解。

**语法**:
```bash
/workflow:analyze-with-file [-y|--yes] [-c|--continue] "主题或问题"
```

**示例**:
```bash
# 分析主题
/workflow:analyze-with-file "认证架构设计"

# 继续讨论
/workflow:analyze-with-file -c
```

### debug-with-file

**功能**: 交互式假设驱动调试，有文档化的探索、理解演化和 Gemini 辅助修正。

**语法**:
```bash
/workflow:debug-with-file [-y|--yes] "Bug 描述或错误信息"
```

**示例**:
```bash
# 调试 Bug
/workflow:debug-with-file "WebSocket 连接随机断开"

# 调试错误
/workflow:debug-with-file "TypeError: Cannot read property 'id'"
```

### unified-execute-with-file

**功能**: 通用执行引擎，消费任何规划/头脑风暴/分析输出，支持最小进度跟踪、多代理协调和增量执行。

**语法**:
```bash
/workflow:unified-execute-with-file [-y|--yes] [-p|--plan <path>] [-m|--mode sequential|parallel] ["执行上下文"]
```

**示例**:
```bash
# 执行规划
/workflow:unified-execute-with-file -p plan.md

# 并行执行
/workflow:unified-execute-with-file -m parallel
```

## 工作流程图

```mermaid
graph TD
    A[任务输入] --> B{任务复杂度}
    B -->|简单| C[Lite 工作流]
    B -->|标准| D[Plan 工作流]
    B -->|复杂| E[Multi-CLI 工作流]

    C --> F[直接执行]
    D --> G[规划] --> H[执行]
    E --> I[多 CLI 讨论] --> G

    F --> J[完成]
    H --> J
    I --> J
```

## 相关文档

- [会话管理](./session.md)
- [核心编排](./core-orchestration.md)
- [工作流指南](../../guide/ch04-workflow-basics.md)
