跳到主要内容

工作流介绍

CCW 提供两类工作流体系：主干工作流 (Main Workflow) 和 Issue 工作流 (Issue Workflow)，它们协同覆盖软件开发的完整生命周期。

工作流架构概览​

主干工作流 vs Issue 工作流​

维度主干工作流Issue 工作流
定位主要开发周期开发后的维护补充
时机功能开发阶段主干开发完成后
范围完整功能实现针对性修复/增强
并行策略依赖分析 + Agent 并行Worktree 隔离 (可选)
分支模型在当前分支工作可使用独立 worktree

为什么主干工作流不自动使用 Worktree？​

依赖分析已解决并行问题：

  1. 规划阶段 (/workflow:plan) 执行依赖分析
  2. 自动识别任务依赖和关键路径
  3. 划分并行组 (独立任务) 和串行链 (依赖任务)
  4. Agent 并行执行独立任务，无需文件系统隔离

为什么 Issue 工作流支持 Worktree？​

Issue 工作流作为补充机制，场景不同：

  1. 主干开发完成，已合并到 main
  2. 发现需要修复的问题
  3. 需要在不影响当前开发的情况下修复
  4. Worktree 隔离让主分支保持稳定

15 个工作流层级详解​

层级 1: 急速执行​

复杂度: 低 | 产物: 无 | 状态: 无状态

工作流描述
lite-lite-lite超轻量直接执行，零开销

适用于: 快速修复、简单功能、配置调整

层级 2: 轻量规划​

复杂度: 低-中 | 产物: 内存/轻量文件 | 状态: 会话内

工作流描述
lite-plan内存规划，适用于明确需求
lite-fix智能漏洞诊断和修复
multi-cli-plan多 CLI 协作分析

适用于: 单模块功能、漏洞修复、技术选型

层级 2.5: 桥接工作流​

复杂度: 低-中 | 用途: 轻量到 Issue 工作流的过渡

工作流描述
rapid-to-issue从快速规划桥接到 Issue 工作流

适用于: 将轻量规划转换为 Issue 跟踪

层级 3: 标准规划​

复杂度: 中-高 | 产物: 持久化会话文件 | 状态: 完整会话管理

工作流描述
plan复杂功能开发，5 个阶段
tdd-plan测试驱动开发，Red-Green-Refactor
test-fix-gen测试修复生成，渐进式层级

适用于: 多模块改动、重构、TDD 开发

With-File 工作流 (层级 3-4)​

复杂度: 中-高 | 产物: 文档化探索 | 多 CLI: 支持

工作流描述层级
brainstorm-with-file多视角创意构思4
debug-with-file假设驱动调试3
analyze-with-file协作分析3

适用于: 需要多 CLI 协作的文档化探索

层级 4: 头脑风暴​

复杂度: 高 | 产物: 多角色分析文档 | 角色数: 3-9

工作流描述
brainstorm:auto-parallel多角色头脑风暴与综合

适用于: 新功能设计、架构重构、探索性需求

层级 5: 智能编排​

复杂度: 所有层级 | 产物: 完整状态持久化 | 自动化: 完全自动

工作流描述
ccw-coordinator自动分析并推荐命令链

适用于: 复杂多步骤工作流、不确定命令、端到端自动化

Issue 工作流​

复杂度: 可变 | 产物: Issue 记录 | 隔离: Worktree 可选

阶段命令
积累discover, discover-by-prompt, new
解决plan --all-pending, queue, execute

适用于: 开发后 Issue 修复、维护主分支稳定性

选择合适的工作流​

快速选择表​

场景推荐工作流层级
快速修复、配置调整lite-lite-lite1
明确的单模块功能lite-plan -> lite-execute2
漏洞诊断和修复lite-fix2
生产环境紧急修复lite-fix --hotfix2
技术选型、方案对比multi-cli-plan -> lite-execute2
多模块改动、重构plan -> verify -> execute3
测试驱动开发tdd-plan -> execute -> tdd-verify3
测试失败修复test-fix-gen -> test-cycle-execute3
新功能、架构设计brainstorm:auto-parallel -> plan -> execute4
复杂多步骤工作流、不确定命令ccw-coordinator5
开发后 Issue 修复Issue 工作流-

决策流程图​

复杂度指标​

系统基于关键词自动评估复杂度：

权重关键词
+2refactor(重构), migrate(迁移), architect(架构), system(系统)
+2multiple(多个), across(跨), all(所有), entire(整个)
+1integrate(集成), api, database(数据库)
+1security(安全), performance(性能), scale(扩展)
  • 高复杂度 (>=4): 自动选择层级 3-4
  • 中等复杂度 (2-3): 自动选择层级 2
  • 低复杂度 (<2): 自动选择层级 1

最小执行单元​

定义: 必须作为原子组一起执行以实现有意义的工作流里程碑的一组命令。

单元名称命令用途
快速实现lite-plan -> lite-execute轻量规划和执行
多 CLI 规划multi-cli-plan -> lite-execute多视角分析和执行
漏洞修复lite-fix -> lite-execute漏洞诊断和修复执行
验证式规划plan -> plan-verify -> execute带验证的规划和执行
TDD 规划tdd-plan -> execute测试驱动开发规划和执行
测试验证test-fix-gen -> test-cycle-execute生成测试任务并执行测试修复循环
代码审查review-session-cycle -> review-cycle-fix完整审查循环并应用修复

下一步​