Claude-Code-Workflow/docs/zh/skills/claude-collaboration.md

# Claude Skills - 团队协作类

## 一句话定位

**团队协作类 Skills 是多角色协同工作的编排系统** — 通过协调器、工作者角色和消息总线实现复杂任务的并行处理和状态同步。

## 解决的痛点

| 痛点 | 现状 | Claude Code Workflow 方案 |
| --- | --- | --- |
| **单模型局限** | 只能调用一个 AI 模型 | 多角色并行协作，发挥各自专长 |
| **任务编排混乱** | 手动管理任务依赖和状态 | 自动任务发现、依赖解析、流水线编排 |
| **协作流程割裂** | 团队成员各自为战 | 统一消息总线、共享状态、进度同步 |
| **资源浪费** | 重复上下文加载 | Wisdom 累积、探索缓存、产物复用 |

## Skills 列表

| Skill | 功能 | 触发方式 |
| --- | --- | --- |
| `team-coordinate` | 通用团队协调器（动态角色生成） | `/team-coordinate` |
| `team-lifecycle-v5` | 全生命周期团队（规范→实现→测试→审查） | `/team-lifecycle` |
| `team-planex` | 规划-执行流水线（边规划边执行） | `/team-planex` |
| `team-review` | 代码审查团队（扫描→审查→修复） | `/team-review` |
| `team-testing` | 测试团队（策略→生成→执行→分析） | `/team-testing` |

## Skills 详解

### team-coordinate

**一句话定位**: 通用团队协调器 — 根据任务分析动态生成角色并编排执行

**触发**:
```
/team-coordinate <task-description>
/team-coordinate --role=coordinator <task>
/team-coordinate --role=<worker> --session=<path>
```

**功能**:
- 只有 coordinator 是内置的，所有工作者角色都是运行时动态生成
- 支持内循环角色（处理多个同前缀任务）
- Fast-Advance 机制跳过协调器直接派生后继任务
- Wisdom 累积跨任务知识

**角色注册表**:
| 角色 | 文件 | 任务前缀 | 类型 |
|------|------|----------|------|
| coordinator | roles/coordinator/role.md | (无) | 编排器 |
| (动态) | `<session>/roles/<role>.md` | (动态) | 工作者 |

**流水线**:
```
任务分析 → 生成角色 → 初始化会话 → 创建任务链 → 派生首批工作者 → 循环推进 → 完成报告
```

**会话目录**:
```
.workflow/.team/TC-<slug>-<date>/
├── team-session.json           # 会话状态 + 动态角色注册表
├── task-analysis.json          # Phase 1 输出
├── roles/                      # 动态角色定义
├── artifacts/                  # 所有 MD 交付产物
├── wisdom/                     # 跨任务知识
├── explorations/               # 共享探索缓存
├── discussions/                # 内联讨论记录
└── .msg/                       # 团队消息总线日志
```

---

### team-lifecycle-v5

**一句话定位**: 全生命周期团队 — 从规范到实现到测试到审查的完整流水线

**触发**:
```
/team-lifecycle <task-description>
```

**功能**:
- 基于 team-worker agent 架构，所有工作者共享同一代理定义
- 角色特定的 Phase 2-4 从 markdown 规范加载
- 支持规范流水线、实现流水线、前端流水线

**角色注册表**:
| 角色 | 规范 | 任务前缀 | 内循环 |
|------|------|----------|--------|
| coordinator | roles/coordinator/role.md | (无) | - |
| analyst | role-specs/analyst.md | RESEARCH-* | false |
| writer | role-specs/writer.md | DRAFT-* | true |
| planner | role-specs/planner.md | PLAN-* | true |
| executor | role-specs/executor.md | IMPL-* | true |
| tester | role-specs/tester.md | TEST-* | false |
| reviewer | role-specs/reviewer.md | REVIEW-* | false |
| architect | role-specs/architect.md | ARCH-* | false |
| fe-developer | role-specs/fe-developer.md | DEV-FE-* | false |
| fe-qa | role-specs/fe-qa.md | QA-FE-* | false |

**流水线定义**:
```
规范流水线 (6 任务):
  RESEARCH-001 → DRAFT-001 → DRAFT-002 → DRAFT-003 → DRAFT-004 → QUALITY-001

实现流水线 (4 任务):
  PLAN-001 → IMPL-001 → TEST-001 + REVIEW-001

全生命周期 (10 任务):
  [规范流水线] → PLAN-001 → IMPL-001 → TEST-001 + REVIEW-001

前端流水线:
  PLAN-001 → DEV-FE-001 → QA-FE-001 (GC 循环，最多 2 轮)
```

**质量关卡** (QUALITY-001 完成后):
```
═════════════════════════════════════════
SPEC PHASE COMPLETE
Quality Gate: <PASS|REVIEW|FAIL> (<score>%)

Dimension Scores:
  Completeness:  <bar> <n>%
  Consistency:   <bar> <n>%
  Traceability:  <bar> <n>%
  Depth:         <bar> <n>%
  Coverage:      <bar> <n>%

Available Actions:
  resume              -> Proceed to implementation
  improve             -> Auto-improve weakest dimension
  improve <dimension> -> Improve specific dimension
  revise <TASK-ID>    -> Revise specific document
  recheck             -> Re-run quality check
  feedback <text>     -> Inject feedback, create revision
═════════════════════════════════════════
```

**用户命令** (唤醒暂停的协调器):
| 命令 | 动作 |
|------|------|
| `check` / `status` | 输出执行状态图，不推进 |
| `resume` / `continue` | 检查工作者状态，推进下一步 |
| `revise <TASK-ID> [feedback]` | 创建修订任务 + 级联下游 |
| `feedback <text>` | 分析反馈影响，创建定向修订链 |
| `recheck` | 重新运行 QUALITY-001 质量检查 |
| `improve [dimension]` | 自动改进 readiness-report 中最弱维度 |

---

### team-planex

**一句话定位**: 边规划边执行团队 — 通过逐 Issue 节拍流水线实现 planner 和 executor 并行工作

**触发**:
```
/team-planex <task-description>
/team-planex --role=planner <input>
/team-planex --role=executor --input <solution-file>
```

**功能**:
- 2 成员团队（planner + executor），planner 担任 lead 角色
- 逐 Issue 节拍：planner 每完成一个 issue 的 solution 后立即创建 EXEC-* 任务
- Solution 写入中间产物文件，executor 从文件加载
- 支持多种执行后端（agent/codex/gemini）

**角色注册表**:
| 角色 | 文件 | 任务前缀 | 类型 |
|------|------|----------|------|
| planner | roles/planner.md | PLAN-* | pipeline (lead) |
| executor | roles/executor.md | EXEC-* | pipeline |

**输入类型**:
| 输入类型 | 格式 | 示例 |
|----------|------|------|
| Issue IDs | 直接传入 ID | `--role=planner ISS-20260215-001 ISS-20260215-002` |
| 需求文本 | `--text '...'` | `--role=planner --text '实现用户认证模块'` |
| Plan 文件 | `--plan path` | `--role=planner --plan plan/2026-02-15-auth.md` |

**Wave Pipeline** (逐 Issue 节拍):
```
Issue 1:  planner 规划 solution → 写中间产物 → 冲突检查 → 创建 EXEC-* → issue_ready
                ↓ (executor 立即开始)
Issue 2:  planner 规划 solution → 写中间产物 → 冲突检查 → 创建 EXEC-* → issue_ready
                ↓ (executor 并行消费)
Issue N:  ...
Final:    planner 发送 all_planned → executor 完成剩余 EXEC-* → 结束
```

**执行方法选择**:
| 执行器 | 后端 | 适用场景 |
|--------|------|----------|
| `agent` | code-developer subagent | 简单任务、同步执行 |
| `codex` | `ccw cli --tool codex --mode write` | 复杂任务、后台执行 |
| `gemini` | `ccw cli --tool gemini --mode write` | 分析类任务、后台执行 |

**用户命令**:
| 命令 | 动作 |
|------|------|
| `check` / `status` | 输出执行状态图，不推进 |
| `resume` / `continue` | 检查工作者状态，推进下一步 |
| `add <issue-ids or --text '...' or --plan path>` | 追加新任务到 planner 队列 |

---

### team-review

**一句话定位**: 代码审查团队 — 统一的代码扫描、漏洞审查、优化建议和自动修复

**触发**:
```
/team-review <target-path>
/team-review --full <target-path>      # scan + review + fix
/team-review --fix <review-files>      # fix only
/team-review -q <target-path>          # quick scan only
```

**功能**:
- 4 角色团队（coordinator, scanner, reviewer, fixer）
- 多维度审查：安全性、正确性、性能、可维护性
- 自动修复循环（审查 → 修复 → 验证）

**角色注册表**:
| 角色 | 文件 | 任务前缀 | 类型 |
|------|------|----------|------|
| coordinator | roles/coordinator/role.md | RC-* | 编排器 |
| scanner | roles/scanner/role.md | SCAN-* | 只读分析 |
| reviewer | roles/reviewer/role.md | REV-* | 只读分析 |
| fixer | roles/fixer/role.md | FIX-* | 代码生成 |

**流水线** (CP-1 Linear):
```
coordinator dispatch
  → SCAN-* (scanner: 工具链 + LLM 扫描)
  → REV-*  (reviewer: 深度分析 + 报告)
  → [用户确认]
  → FIX-*  (fixer: 规划 + 执行 + 验证)
```

**检查点**:
| 触发 | 位置 | 行为 |
|------|------|------|
| Review→Fix 过渡 | REV-* 完成 | 暂停，展示审查报告，等待用户 `resume` 确认修复 |
| 快速模式 (`-q`) | SCAN-* 后 | 流水线在扫描后结束，无审查/修复 |
| 仅修复模式 (`--fix`) | 入口 | 跳过扫描/审查，直接进入 fixer |

**审查维度**:
| 维度 | 检查点 |
|------|--------|
| 安全性 (sec) | 注入漏洞、敏感信息泄露、权限控制 |
| 正确性 (cor) | 边界条件、错误处理、类型安全 |
| 性能 (perf) | 算法复杂度、I/O 优化、资源使用 |
| 可维护性 (maint) | 代码结构、命名规范、注释质量 |

---

### team-testing

**一句话定位**: 测试团队 — 通过 Generator-Critic 循环实现渐进式测试覆盖

**触发**:
```
/team-testing <task-description>
```

**功能**:
- 5 角色团队（coordinator, strategist, generator, executor, analyst）
- 三种流水线：Targeted、Standard、Comprehensive
- Generator-Critic 循环自动改进测试覆盖率

**角色注册表**:
| 角色 | 文件 | 任务前缀 | 类型 |
|------|------|----------|------|
| coordinator | roles/coordinator.md | (无) | 编排器 |
| strategist | roles/strategist.md | STRATEGY-* | pipeline |
| generator | roles/generator.md | TESTGEN-* | pipeline |
| executor | roles/executor.md | TESTRUN-* | pipeline |
| analyst | roles/analyst.md | TESTANA-* | pipeline |

**三种流水线**:
```
Targeted (小范围变更):
  STRATEGY-001 → TESTGEN-001(L1 unit) → TESTRUN-001

Standard (渐进式):
  STRATEGY-001 → TESTGEN-001(L1) → TESTRUN-001(L1) → TESTGEN-002(L2) → TESTRUN-002(L2) → TESTANA-001

Comprehensive (完整覆盖):
  STRATEGY-001 → [TESTGEN-001(L1) + TESTGEN-002(L2)](并行) → [TESTRUN-001(L1) + TESTRUN-002(L2)](并行) → TESTGEN-003(L3) → TESTRUN-003(L3) → TESTANA-001
```

**Generator-Critic 循环**:
```
TESTGEN → TESTRUN → (如果覆盖率 < 目标) → TESTGEN-fix → TESTRUN-2
                     (如果覆盖率 >= 目标) → 下一层或 TESTANA
```

**测试层定义**:
| 层级 | 覆盖目标 | 示例 |
|------|----------|------|
| L1: Unit | 80% | 单元测试、函数级测试 |
| L2: Integration | 60% | 集成测试、模块间交互 |
| L3: E2E | 40% | 端到端测试、用户场景 |

**共享内存** (shared-memory.json):
| 角色 | 字段 |
|------|------|
| strategist | `test_strategy` |
| generator | `generated_tests` |
| executor | `execution_results`, `defect_patterns` |
| analyst | `analysis_report`, `coverage_history` |

## 相关命令

- [Claude Commands - Workflow](../commands/claude/workflow.md)
- [Claude Commands - Session](../commands/claude/session.md)

## 最佳实践

1. **选择合适的团队类型**:
   - 通用任务 → `team-coordinate`
   - 完整功能开发 → `team-lifecycle`
   - Issue 批处理 → `team-planex`
   - 代码审查 → `team-review`
   - 测试覆盖 → `team-testing`

2. **利用内循环角色**: 对于有多个同前缀串行任务的角色，设置 `inner_loop: true` 让单个工作者处理全部任务，避免重复派生开销

3. **Wisdom 累积**: 团队会话中的所有角色都会累积知识到 `wisdom/` 目录，后续任务可复用这些模式、决策和约定

4. **Fast-Advance**: 简单线性后继任务会自动跳过协调器直接派生，减少协调开销

5. **断点恢复**: 所有团队技能支持会话恢复，通过 `--resume` 或用户命令 `resume` 继续中断的会话