CCW 工作流指南

March 5, 2026 · View on GitHub

概述

CCW 提供了基于 Team 架构 v2 和 Skill 工作流系统 的完整工作流体系，覆盖从快速原型到完整团队编排的软件开发全生命周期。

v7.0 新增功能

主要新特性:

  • Team 架构 v2: team-coordinate 和 team-executor 统一 team-worker 代理
  • team-lifecycle: 完整生命周期统一团队技能 (规格 -> 实现 -> 测试 -> 审查)
  • 队列调度器: 具有依赖解析的后台任务执行
  • 工作流会话命令: 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轻量规划与探索（Skill 交接给 lite-execute）5 阶段

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-planTDD 规划
workflow-tdd-verifyTDD 验证

6 阶段 TDD 规划 + Red-Green-Refactor：

阶段 1: 测试设计
阶段 2: Red（编写失败测试）
阶段 3: Green（最小实现）
阶段 4: Refactor（重构）
阶段 5: 验证
阶段 6: 下一循环

测试修复工作流

Skill 触发词用途
workflow-test-fix测试生成与修复
workflow-test-fix执行测试循环

渐进式测试层级 (L0-L3)：

层级名称焦点
L0静态分析编译、导入、类型、AI 代码问题
L1单元测试函数/类行为
L2集成测试组件交互、API 契约
L3E2E 测试用户旅程、关键路径

会话生命周期

会话命令

/workflow:session:start     # 启动新工作流会话
/workflow:session:resume    # 恢复暂停的会话
/workflow:session:list      # 列出所有会话
/workflow:session:sync      # 同步会话工作
/workflow:session:complete  # 完成会话
/workflow:session:solidify  # 将学习结晶为永久记忆

会话类型

类型前缀描述
工作流WFS-通用开发会话
审查WFS-review-代码审查会话
TDDWFS-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动态角色生成与协调
team-executor现有会话的纯执行
team-lifecycle完整生命周期（规格 -> 实现 -> 测试）
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-planworkflow-lite-plan
workflow-multi-cli-planworkflow-multi-cli-plan
workflow-planworkflow-plan, workflow-plan-verify, workflow:replan
workflow-executeworkflow-execute
workflow-tdd-planworkflow-tdd-plan, workflow-tdd-verify
workflow-test-fixworkflow-test-fix, workflow-test-fix

专项 Skills

Skill触发词
brainstormbrainstorm
review-codereview code
review-cycleworkflow:review-cycle
spec-generatorworkflow:spec, generate spec
skill-generatorcreate skill
skill-tuningskill tuning

记忆 Skills

Skill触发词
memory-capturememory capture
memory-managememory 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
  │
  └─ 是架构/新系统？
       └─> 是：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