mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-28 09:23:08 +08:00
365 lines
11 KiB
Markdown
365 lines
11 KiB
Markdown
# CCW 工作流指南
|
||
|
||
## 概述
|
||
|
||
CCW 提供了基于 **Team 架构 v2** 和 **Skill 工作流系统** 的完整工作流体系，覆盖从快速原型到完整团队编排的软件开发全生命周期。
|
||
|
||
## v7.0 新增功能
|
||
|
||
**主要新特性**:
|
||
- **Team 架构 v2**: `team-coordinate-v2` 和 `team-executor-v2` 统一 team-worker 代理
|
||
- **team-lifecycle-v5**: 完整生命周期统一团队技能 (规格 -> 实现 -> 测试 -> 审查)
|
||
- **队列调度器**: 具有依赖解析的后台任务执行
|
||
- **工作流会话命令**: `start`、`resume`、`complete`、`sync` 完整生命周期管理
|
||
- **节拍/韵律编排模型**: 事件驱动的协调模型
|
||
- **新仪表板视图**: 分析查看器、终端仪表板、编排器模板编辑器
|
||
|
||
---
|
||
|
||
## Skills 与 Commands
|
||
|
||
CCW 使用两种调用方式：
|
||
|
||
| 类型 | 格式 | 示例 |
|
||
|------|------|------|
|
||
| **Skills** | 触发短语（无斜杠） | `workflow:lite-plan`, `brainstorm`, `workflow:plan` |
|
||
| **Commands** | 斜杠命令 | `/ccw`, `/workflow/session:start`, `/issue/new` |
|
||
|
||
---
|
||
|
||
## 工作流 Skills
|
||
|
||
### 轻量规划
|
||
|
||
| Skill 触发词 | 用途 | 阶段 |
|
||
|--------------|------|------|
|
||
| `workflow:lite-plan` | 轻量规划与探索 | 5 阶段 |
|
||
| `workflow:lite-execute` | 执行 lite-plan 输出 | 执行 |
|
||
|
||
**5 阶段交互式工作流**：
|
||
```
|
||
阶段 1: 任务分析与探索 (30-90秒)
|
||
阶段 2: 澄清（用户参与）
|
||
阶段 3: 规划 (20-60秒)
|
||
阶段 4: 三维确认
|
||
阶段 5: 执行与跟踪
|
||
```
|
||
|
||
### 多 CLI 规划
|
||
|
||
| Skill 触发词 | 用途 |
|
||
|--------------|------|
|
||
| `workflow:multi-cli-plan` | 多 CLI 协同分析 |
|
||
|
||
**5 阶段工作流**：
|
||
```
|
||
阶段 1: 上下文收集（ACE 语义搜索）
|
||
阶段 2: 多 CLI 讨论（迭代）
|
||
阶段 3: 展示选项
|
||
阶段 4: 用户决策
|
||
阶段 5: 规划生成
|
||
```
|
||
|
||
### 标准规划
|
||
|
||
| Skill 触发词 | 用途 | 阶段 |
|
||
|--------------|------|------|
|
||
| `workflow:plan` | 完整规划与会话 | 5 阶段 |
|
||
| `workflow:plan-verify` | 规划验证 | 验证 |
|
||
| `workflow:replan` | 交互式重新规划 | 重规划 |
|
||
|
||
### TDD 工作流
|
||
|
||
| Skill 触发词 | 用途 |
|
||
|--------------|------|
|
||
| `workflow:tdd-plan` | TDD 规划 |
|
||
| `workflow:tdd-verify` | TDD 验证 |
|
||
|
||
**6 阶段 TDD 规划 + Red-Green-Refactor**：
|
||
```
|
||
阶段 1: 测试设计
|
||
阶段 2: Red（编写失败测试）
|
||
阶段 3: Green（最小实现）
|
||
阶段 4: Refactor（重构）
|
||
阶段 5: 验证
|
||
阶段 6: 下一循环
|
||
```
|
||
|
||
### 测试修复工作流
|
||
|
||
| Skill 触发词 | 用途 |
|
||
|--------------|------|
|
||
| `workflow:test-fix-gen` | 测试生成与修复 |
|
||
| `workflow:test-cycle-execute` | 执行测试循环 |
|
||
|
||
**渐进式测试层级 (L0-L3)**：
|
||
|
||
| 层级 | 名称 | 焦点 |
|
||
|------|------|------|
|
||
| **L0** | 静态分析 | 编译、导入、类型、AI 代码问题 |
|
||
| **L1** | 单元测试 | 函数/类行为 |
|
||
| **L2** | 集成测试 | 组件交互、API 契约 |
|
||
| **L3** | E2E 测试 | 用户旅程、关键路径 |
|
||
|
||
---
|
||
|
||
## 会话生命周期
|
||
|
||
### 会话命令
|
||
|
||
```bash
|
||
/workflow:session:start # 启动新工作流会话
|
||
/workflow:session:resume # 恢复暂停的会话
|
||
/workflow:session:list # 列出所有会话
|
||
/workflow:session:sync # 同步会话工作
|
||
/workflow:session:complete # 完成会话
|
||
/workflow:session:solidify # 将学习结晶为永久记忆
|
||
```
|
||
|
||
### 会话类型
|
||
|
||
| 类型 | 前缀 | 描述 |
|
||
|------|------|------|
|
||
| **工作流** | `WFS-` | 通用开发会话 |
|
||
| **审查** | `WFS-review-` | 代码审查会话 |
|
||
| **TDD** | `WFS-tdd-` | TDD 工作流会话 |
|
||
| **测试** | `WFS-test-` | 测试生成会话 |
|
||
|
||
### 会话目录结构
|
||
|
||
```
|
||
.workflow/active/{session-id}/
|
||
├── workflow-session.json # 会话元数据
|
||
├── IMPL_PLAN.md # 实现计划
|
||
├── TODO_LIST.md # 任务清单
|
||
├── .task/ # 任务 JSON 文件
|
||
└── .process/ # 过程产物
|
||
```
|
||
|
||
---
|
||
|
||
## Team 架构 v2
|
||
|
||
### 核心概念
|
||
|
||
- **team-worker 智能体**: 所有角色的统一工作者智能体
|
||
- **role-spec 文件**: 轻量级 YAML frontmatter + 阶段 2-4 逻辑
|
||
- **内循环框架**: 同前缀任务的批处理
|
||
- **节拍/节奏模型**: 事件驱动协调
|
||
|
||
### 可用团队 Skills
|
||
|
||
| Skill | 用途 |
|
||
|-------|------|
|
||
| `team-coordinate-v2` | 动态角色生成与协调 |
|
||
| `team-executor-v2` | 现有会话的纯执行 |
|
||
| `team-lifecycle-v5` | 完整生命周期（规格 -> 实现 -> 测试） |
|
||
| `team-brainstorm` | 头脑风暴团队 |
|
||
| `team-frontend` | 前端开发团队 |
|
||
| `team-testing` | 测试团队 |
|
||
| `team-review` | 代码审查团队 |
|
||
|
||
### 可用角色
|
||
|
||
| 角色 | 职责 |
|
||
|------|------|
|
||
| analyst | 代码分析、需求 |
|
||
| writer | 文档、内容 |
|
||
| planner | 规划、架构 |
|
||
| executor | 实现、编码 |
|
||
| tester | 测试、QA |
|
||
| reviewer | 代码审查、反馈 |
|
||
| architect | 系统设计、架构 |
|
||
| fe-developer | 前端开发 |
|
||
| fe-qa | 前端 QA |
|
||
|
||
---
|
||
|
||
## 命令分类
|
||
|
||
### 根命令
|
||
|
||
| 命令 | 描述 |
|
||
|------|------|
|
||
| `/ccw` | 主工作流编排器 |
|
||
| `/ccw-coordinator` | 智能链编排器 |
|
||
| `/flow-create` | 流程模板生成器 |
|
||
|
||
### Issue 命令
|
||
|
||
| 命令 | 描述 |
|
||
|------|------|
|
||
| `/issue/new` | 创建新 issue |
|
||
| `/issue/plan` | 批量规划 issue 解决方案 |
|
||
| `/issue/queue` | 形成执行队列 |
|
||
| `/issue/execute` | 执行队列 |
|
||
| `/issue/discover` | 发现潜在问题 |
|
||
| `/issue/discover-by-prompt` | 从提示发现 |
|
||
|
||
### 工作流命令
|
||
|
||
| 命令 | 描述 |
|
||
|------|------|
|
||
| `/workflow/init` | 初始化项目状态 |
|
||
| `/workflow/init-specs` | 创建规格文件 |
|
||
| `/workflow/init-guidelines` | 填充规格文件 |
|
||
| `/workflow/clean` | 代码清理 |
|
||
| `/workflow/analyze-with-file` | 协同分析 |
|
||
| `/workflow/brainstorm-with-file` | 头脑风暴 |
|
||
| `/workflow/collaborative-plan-with-file` | 协同规划 |
|
||
| `/workflow/debug-with-file` | 调试工作流 |
|
||
| `/workflow/refactor-cycle` | 重构工作流 |
|
||
| `/workflow/integration-test-cycle` | 集成测试 |
|
||
| `/workflow/roadmap-with-file` | 路线图规划 |
|
||
| `/workflow/unified-execute-with-file` | 统一执行 |
|
||
|
||
### UI 设计命令
|
||
|
||
| 命令 | 描述 |
|
||
|------|------|
|
||
| `/workflow/ui-design/style-extract` | 提取样式 |
|
||
| `/workflow/ui-design/layout-extract` | 提取布局 |
|
||
| `/workflow/ui-design/animation-extract` | 提取动画 |
|
||
| `/workflow/ui-design/generate` | 生成 UI 原型 |
|
||
| `/workflow/ui-design/import-from-code` | 从代码导入设计 |
|
||
| `/workflow/ui-design/codify-style` | 编码样式 |
|
||
| `/workflow/ui-design/design-sync` | 同步设计引用 |
|
||
|
||
---
|
||
|
||
## Skill 分类
|
||
|
||
### 工作流 Skills
|
||
|
||
| Skill | 触发词 |
|
||
|-------|--------|
|
||
| workflow-lite-plan | `workflow:lite-plan`, `workflow:lite-execute` |
|
||
| workflow-multi-cli-plan | `workflow:multi-cli-plan` |
|
||
| workflow-plan | `workflow:plan`, `workflow:plan-verify`, `workflow:replan` |
|
||
| workflow-execute | `workflow:execute` |
|
||
| workflow-tdd | `workflow:tdd-plan`, `workflow:tdd-verify` |
|
||
| workflow-test-fix | `workflow:test-fix-gen`, `workflow:test-cycle-execute` |
|
||
|
||
### 专项 Skills
|
||
|
||
| Skill | 触发词 |
|
||
|-------|--------|
|
||
| brainstorm | `brainstorm` |
|
||
| review-code | `review code` |
|
||
| review-cycle | `workflow:review-cycle` |
|
||
| spec-generator | `workflow:spec`, `generate spec` |
|
||
| skill-generator | `create skill` |
|
||
| skill-tuning | `skill tuning` |
|
||
|
||
### 记忆 Skills
|
||
|
||
| Skill | 触发词 |
|
||
|-------|--------|
|
||
| memory-capture | `memory capture` |
|
||
| memory-manage | `memory manage` |
|
||
|
||
---
|
||
|
||
## 工作流选择指南
|
||
|
||
```
|
||
任务复杂度
|
||
低 中 高
|
||
│ │ │
|
||
────────────────────┼────────────┼─────────────┼────────────
|
||
│ │ │
|
||
快速修复 │ │ │
|
||
配置变更 ────┼──> │ │
|
||
单模块功能 │ │ │
|
||
│ lite-plan │ │
|
||
│ │ │
|
||
────────────────────┼────────────┼─────────────┼────────────
|
||
│ │ │
|
||
多模块功能 │ │ │
|
||
功能开发 ────┼────────────┼──> │
|
||
│ │ plan │
|
||
│ │ │
|
||
────────────────────┼────────────┼─────────────┼────────────
|
||
│ │ │
|
||
架构设计 │ │ │
|
||
新系统 ────┼────────────┼─────────────┼──>
|
||
│ │ │ brainstorm
|
||
│ │ │ + plan
|
||
│ │ │ + execute
|
||
```
|
||
|
||
### 决策流程图
|
||
|
||
```
|
||
开始
|
||
│
|
||
├─ 是快速修复或配置变更？
|
||
│ └─> 是：workflow:lite-plan
|
||
│
|
||
├─ 是单模块功能？
|
||
│ └─> 是：workflow:lite-plan
|
||
│
|
||
├─ 需要多 CLI 分析？
|
||
│ └─> 是：workflow:multi-cli-plan
|
||
│
|
||
├─ 是多模块且需要会话？
|
||
│ └─> 是：workflow:plan
|
||
│
|
||
├─ 是 TDD 开发？
|
||
│ └─> 是：workflow:tdd-plan
|
||
│
|
||
├─ 是测试生成？
|
||
│ └─> 是：workflow:test-fix-gen
|
||
│
|
||
└─ 是架构/新系统？
|
||
└─> 是：brainstorm + workflow:plan
|
||
```
|
||
|
||
---
|
||
|
||
## Issue 工作流
|
||
|
||
### Issue 生命周期
|
||
|
||
```
|
||
/issue/new 创建带解决方案的 issue
|
||
↓
|
||
/issue/plan 批量规划解决方案
|
||
↓
|
||
/issue/queue 形成执行队列（DAG）
|
||
↓
|
||
/issue/execute 并行编排执行
|
||
```
|
||
|
||
### Issue 命令
|
||
|
||
| 命令 | 用途 |
|
||
|------|------|
|
||
| `/issue/new` | 从 URL 或描述创建结构化 issue |
|
||
| `/issue/discover` | 从多视角发现问题 |
|
||
| `/issue/plan` | 使用 issue-plan-agent 批量规划 |
|
||
| `/issue/queue` | 使用 issue-queue-agent 形成队列 |
|
||
| `/issue/execute` | 基于 DAG 的并行执行 |
|
||
|
||
---
|
||
|
||
## 快速参考
|
||
|
||
### 最常用 Skills
|
||
|
||
| Skill | 何时使用 |
|
||
|-------|----------|
|
||
| `workflow:lite-plan` | 快速修复、单功能 |
|
||
| `workflow:plan` | 多模块开发 |
|
||
| `brainstorm` | 架构、新功能 |
|
||
| `workflow:execute` | 执行已规划的工作 |
|
||
|
||
### 最常用 Commands
|
||
|
||
| 命令 | 何时使用 |
|
||
|------|----------|
|
||
| `/ccw` | 自动工作流选择 |
|
||
| `/workflow/session:start` | 启动新会话 |
|
||
| `/workflow/session:resume` | 继续暂停的工作 |
|
||
| `/issue/new` | 创建新 issue |
|