CCW 速查手册:命令、决策树与快速参考
CCW 速查手册:命令、决策树与快速参考
ProriseCCW 速查手册:命令、决策树与快速参考
这篇文章适合谁? 如果你已经理解了 CCW 的工作原理,需要一份快速参考手册来查找命令、决策流程和解决方案,这篇文章就是你的工具箱。
第一章. 完整命令索引
1.1. 主干工作流命令
Level 1:即时执行
1 | /workflow:lite-lite-lite "任务描述" |
适用场景:
- 快速修复
- 配置调整
- 简单重命名
- 小范围修改
特点:零产物,秒级响应
Level 2:轻量规划
lite-plan(明确需求)
1 | # 基础用法 |
适用场景:
- 单模块功能开发
- 明确需求的任务
- 快速迭代
lite-fix(Bug 修复)
1 | # 标准修复 |
适用场景:
- Bug 诊断与修复
- 生产事故
- 紧急问题
multi-cli-plan(多视角分析)
1 | # 多 CLI 协作规划 |
适用场景:
- 技术选型
- 方案比较
- 需要多视角分析
Level 3:标准规划
plan(多模块开发)
1 | # 完整规划 |
适用场景:
- 多模块改动
- 复杂功能开发
- 系统重构
tdd-plan(测试驱动)
1 | # TDD 规划 |
适用场景:
- 测试驱动开发
- 高质量要求
- 需要高覆盖率
test-fix-gen(测试修复)
1 | # 基于 Session 生成测试任务 |
适用场景:
- 测试失败修复
- 提升测试覆盖率
- 补充测试用例
Level 4:头脑风暴
1 | # 启动头脑风暴(默认 3 个角色) |
适用场景:
- 新功能设计
- 架构重构
- 探索性需求
- 不知道怎么做
可用角色:
- system-architect(系统架构师)
- ui-designer(UI 设计师)
- ux-expert(UX 专家)
- product-manager(产品经理)
- data-architect(数据架构师)
- test-strategist(测试策略师)
Level 5:智能编排
1 | # 自动分析并推荐命令链 |
适用场景:
- 不知道用什么命令
- 需要端到端自动化
- 复杂多步骤任务
- 需要可恢复会话
ccw 自动编排
1 | # 自动工作流选择(主进程) |
适用场景:
- 通用任务
- 快速开发
- 自动执行
1.2. 代码审查命令
基础审查
1 | # 审查当前代码 |
专项审查
1 | # 安全审查 |
Session 审查
1 | # 审查整个 Session |
1.3. 调试与冲突命令
调试模式
1 | # 调试错误 |
冲突解决
1 | # 解决 Git 冲突 |
1.4. Issue 工作流命令
积累阶段
1 | # 自动发现 Issue |
批量解决阶段
1 | # 查看待处理队列 |
1.5. 记忆与文档命令
更新记忆
1 | # 更新相关记忆(高频使用) |
生成文档
1 | # 生成项目文档 |
技能包
1 | # 加载技能包 |
1.6. Session 管理命令
1 | # 启动新 Session |
1.7. CLI 工具命令
1 | # 安装 CCW |
第二章. 场景到命令映射表
2.1. 日常开发场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 快速修复配置 | lite-lite-lite | Level 1 |
| 批量重命名 | lite-lite-lite | Level 1 |
| 添加小功能 | lite-plan → lite-execute | Level 2 |
| 实现 API 接口 | lite-plan -e → lite-execute | Level 2 |
| 修复 Bug | lite-fix → lite-execute | Level 2 |
| 生产事故 | lite-fix --hotfix | Level 2 |
| 多模块功能 | plan → execute | Level 3 |
| 系统重构 | plan → plan-verify → execute | Level 3 |
2.2. 测试场景
| 场景 | 命令 | 层级 |
|---|---|---|
| TDD 开发 | tdd-plan → execute → tdd-verify | Level 3 |
| 测试失败修复 | test-fix-gen → test-cycle-execute | Level 3 |
| 提升覆盖率 | test-fix-gen WFS-xxx | Level 3 |
| 补充测试 | test-fix-gen → test-cycle-execute | Level 3 |
2.3. 决策与设计场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 技术选型 | multi-cli-plan → lite-execute | Level 2 |
| 方案比较 | multi-cli-plan → lite-execute | Level 2 |
| 新功能设计 | brainstorm:auto-parallel → plan | Level 4 |
| 架构重构 | brainstorm:auto-parallel → plan | Level 4 |
| 不知道怎么做 | brainstorm:auto-parallel | Level 4 |
2.4. 审查与优化场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 代码审查 | review | - |
| 审查并修复 | review-fix | - |
| 安全审查 | review --type security | - |
| 性能审查 | review --type performance | - |
| 架构审查 | review --type architecture | - |
| Session 审查 | review-session-cycle → review-fix | - |
2.5. 调试与维护场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 程序报错 | debug "错误描述" | - |
| 文件调试 | debug-with-file path/to/file | - |
| Git 冲突 | tools:conflict-resolution | - |
| 自动发现问题 | issue:discover | Issue |
| 批量修复 | issue:plan --all-pending → issue:execute | Issue |
2.6. 记忆与文档场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 提交前更新 | memory:update-related | - |
| 新项目初始化 | memory:update-full | - |
| 生成项目文档 | memory:docs | - |
| 生成 API 文档 | memory:swagger-docs | - |
| 加载技能包 | memory:load-skill-memory | - |
2.7. 智能编排场景
| 场景 | 命令 | 层级 |
|---|---|---|
| 不知道用什么命令 | ccw-coordinator "任务描述" | Level 5 |
| 复杂多步骤任务 | ccw-coordinator "任务描述" | Level 5 |
| 快速自动执行 | ccw "任务描述" | Level 5 |
第三章. 决策流程图
3.1. 主干工作流决策树
1 | 开始新任务 |
3.2. 不知道用什么命令的决策树
1 | 不知道用什么命令 |
3.3. Issue 工作流决策树
1 | 开发完成后 |
3.4. 复杂度评估决策树
1 | 评估任务复杂度 |
第四章. 最小执行单元速查
4.1. 规划+执行单元
| 单元名称 | 命令组合 | 目的 | 输出 |
|---|---|---|---|
| Quick Implementation | lite-plan → lite-execute | 轻量规划与立即执行 | 工作代码 |
| Multi-CLI Planning | multi-cli-plan → lite-execute | 多视角分析与执行 | 工作代码 |
| Bug Fix | lite-fix → lite-execute | Bug 诊断与修复 | 修复代码 |
| Full Planning | plan → execute | 详细规划与执行 | 工作代码 |
| Verified Planning | plan → plan-verify → execute | 规划验证与执行 | 工作代码 |
| Replanning | replan → execute | 更新规划与执行 | 工作代码 |
| TDD Planning | tdd-plan → execute | 测试驱动开发 | 工作代码 |
| Test Generation | test-gen → execute | 测试套件生成 | 生成的测试 |
4.2. 测试单元
| 单元名称 | 命令组合 | 目的 | 输出 |
|---|---|---|---|
| Test Validation | test-fix-gen → test-cycle-execute | 测试修复循环 | 测试通过 |
4.3. 审查单元
| 单元名称 | 命令组合 | 目的 | 输出 |
|---|---|---|---|
| Session Review | review-session-cycle → review-fix | 完整审查循环 | 修复代码 |
| Module Review | review-module-cycle → review-fix | 模块审查循环 | 修复代码 |
第五章. 命令端口映射表
5.1. 命令端口定义
| 命令 | 输入端口 | 输出端口 | 最小单元 |
|---|---|---|---|
lite-plan | requirement | plan | Quick Implementation |
lite-execute | plan, multi-cli-plan, lite-fix | code | Quick Implementation, Multi-CLI Planning, Bug Fix |
plan | requirement | detailed-plan | Full Planning |
execute | detailed-plan, verified-plan, tdd-tasks | code | Full Planning, TDD Planning |
multi-cli-plan | requirement | multi-cli-plan | Multi-CLI Planning |
lite-fix | bug-report | lite-fix | Bug Fix |
tdd-plan | requirement | tdd-tasks | TDD Planning |
test-fix-gen | code, session | test-tasks | Test Validation |
test-cycle-execute | test-tasks | test-passed | Test Validation |
5.2. 任务类型到端口流映射
| 任务类型 | 输入端口 | 输出端口 | 示例管道 |
|---|---|---|---|
bugfix | bug-report | test-passed | Bug报告 → lite-fix → 修复 → test-passed |
tdd | requirement | tdd-verified | 需求 → tdd-plan → execute → tdd-verify |
test-fix | failing-tests | test-passed | 失败测试 → test-fix-gen → test-cycle-execute |
test-gen | code/session | test-passed | 代码 → test-gen → execute → test-passed |
review | code/session | review-verified | 代码 → review-* → review-fix |
feature | requirement | code/test-passed | 需求 → plan → execute → code |
第六章. 多 CLI 协同速查
6.1. 协同模式
| 模式 | 提示词模板 | 说明 |
|---|---|---|
| 协同分析 | “使用 {CLI1} 和 {CLI2} 协同分析 {任务}” | 两个 AI 分别分析,合并结果 |
| 并行执行 | “让 {CLI1}、{CLI2}、{CLI3} 并行分析 {任务}” | 多个 AI 同时工作,多视角 |
| 流水线 | “{CLI1} 设计,{CLI2} 实现,{CLI3} 审查” | 顺序执行,流水线作业 |
| 迭代优化 | “用 {CLI1} 诊断,{CLI2} 修复,迭代直到解决” | 循环执行,直到问题解决 |
6.2. CLI 工具特性
| CLI 工具 | 擅长领域 | 推荐场景 |
|---|---|---|
| Gemini | 架构分析、代码理解 | 系统设计、架构评审 |
| Codex | 代码生成、自主编码 | 功能实现、代码重构 |
| Qwen | 中文场景、代码审查 | 中文项目、质量审查 |
| Claude | 通用开发 | 日常开发、综合任务 |
6.3. 自定义 CLI 注册
1 | # 打开 Dashboard |
| 字段 | 说明 | 示例 |
|---|---|---|
| 名称 | CLI 标识符 | deepseek |
| 端点 | API 端点 | https://api.deepseek.com/v1/chat |
| API Key | 认证密钥 | your-api-key |
第七章. 产物与文件结构
7.1. 主干工作流产物
Level 1(lite-lite-lite)
1 | 无产物 |
Level 2(lite-plan)
1 | 内存中的规划(无文件) |
Level 2(lite-fix)
1 | .workflow/.lite-fix/{bug-slug}-{date}/ |
Level 2(multi-cli-plan)
1 | .workflow/.multi-cli-plan/{MCP-task-slug-date}/ |
Level 3(plan)
1 | .workflow/active/{WFS-session}/ |
Level 3(tdd-plan)
1 | .workflow/active/{WFS-session}/ |
Level 3(test-fix-gen)
1 | .workflow/active/WFS-test-{session}/ |
Level 4(brainstorm)
1 | .workflow/active/WFS-{topic}/ |
Level 5(ccw-coordinator)
1 | .workflow/.ccw-coordinator/{session_id}/ |
7.2. Issue 工作流产物
1 | .workflow/.issues/ |
7.3. 记忆文件
1 | .claude/memory/ |
7.4. 技能包文件
1 | .claude/skills/ |
第八章. 常见问题快速解决
8.1. 命令执行问题
问题:命令执行失败
1 | # 查看错误日志 |
问题:Session 中断
1 | # 查看所有 Session |
问题:不知道用什么命令
1 | # 使用智能编排 |
8.2. 记忆问题
问题:AI 不理解我的代码
1 | # 更新记忆 |
问题:记忆更新失败
1 | # 检查记忆目录 |
问题:记忆文件太大
1 | # 清理旧记忆 |
8.3. CLI 工具问题
问题:CLI 调用失败
1 | # 检查 CLI 配置 |
问题:CLI 响应慢
1 | # 切换到其他 CLI |
8.4. 工作流选择问题
问题:不确定用哪个 Level
1 | # 使用智能编排自动选择 |
问题:任务太复杂不知道怎么做
1 | # 使用头脑风暴 |
问题:需要多视角分析
1 | # 使用多 CLI 规划 |
8.5. 测试问题
问题:测试失败
1 | # 使用测试修复循环 |
问题:测试覆盖率低
1 | # 基于现有 Session 生成测试 |
问题:想用 TDD 开发
1 | # 使用 TDD 工作流 |
8.6. Issue 工作流问题
问题:如何发现潜在问题
1 | # 自动发现 |
问题:Issue 太多怎么办
1 | # 批量规划 |
问题:只想修复某个 Issue
1 | # 针对性修复 |
第九章. 快速参考卡片
9.1. 5 秒决策卡
1 | ┌─────────────────────────────────────────┐ |
9.2. 每日工作流卡
1 | ┌─────────────────────────────────────────┐ |
9.3. 紧急情况卡
1 | ┌─────────────────────────────────────────┐ |
9.4. 周期性维护卡
1 | ┌─────────────────────────────────────────┐ |
第十章. 本笔记总结
10.1. 完整命令清单
主干工作流(Level 1-5)
| 命令 | 说明 | 层级 |
|---|---|---|
lite-lite-lite | 即时执行 | Level 1 |
lite-plan | 轻量规划 | Level 2 |
lite-fix | Bug 修复 | Level 2 |
multi-cli-plan | 多 CLI 分析 | Level 2 |
plan | 标准规划 | Level 3 |
tdd-plan | TDD 规划 | Level 3 |
test-fix-gen | 测试修复 | Level 3 |
brainstorm:auto-parallel | 头脑风暴 | Level 4 |
ccw-coordinator | 智能编排 | Level 5 |
ccw | 自动编排 | Level 5 |
执行与验证
| 命令 | 说明 |
|---|---|
execute | 执行 Session |
lite-execute | 执行轻量规划 |
plan-verify | 验证计划 |
tdd-verify | 验证 TDD |
test-cycle-execute | 测试循环 |
审查与调试
| 命令 | 说明 |
|---|---|
review | 代码审查 |
review-fix | 审查并修复 |
review --type {type} | 专项审查 |
debug | 调试模式 |
tools:conflict-resolution | 冲突解决 |
Issue 工作流
| 命令 | 说明 |
|---|---|
issue:discover | 自动发现 |
issue:new | 创建 Issue |
issue:queue | 查看队列 |
issue:plan | 规划修复 |
issue:execute | 执行修复 |
记忆与文档
| 命令 | 说明 |
|---|---|
memory:update-related | 更新相关记忆 |
memory:update-full | 全量更新 |
memory:docs | 生成文档 |
memory:swagger-docs | 生成 API 文档 |
memory:load-skill-memory | 加载技能包 |
10.2. 核心决策原则
能用低级别就不用高级别
- 避免过度工程化
- 快速迭代优先
不确定时从 Level 2 开始
- lite-plan 是日常主力
- 90% 的功能够用
复杂任务用 Level 3
- 需要 Session 持久化
- 多模块改动
- 可恢复任务
不知道怎么做用 Level 4
- 头脑风暴
- 多角色协同
- 探索性需求
不知道用什么命令用 Level 5
- 智能编排
- 自动推荐
- 端到端自动化
10.3. 最佳实践总结
记忆管理
- 每次提交前:
memory:update-related - 新项目初始化:
memory:update-full - 每周维护:全量更新一次
Session 管理
- 命名规范:
WFS-{feature}-{version} - 定期清理:归档已完成,删除失败
- 中断恢复:
session resume WFS-xxx
工作流选择
- Bug 修复:
lite-fix - 小功能:
lite-plan - 大功能:
plan - 技术选型:
multi-cli-plan - TDD:
tdd-plan - 不确定:
ccw-coordinator
代码审查
- 开发中:
review-fix - 提交前:
review - 专项:
review --type {type}
测试策略
- TDD:
tdd-plan→execute→tdd-verify - 后置:
test-fix-gen→test-cycle-execute - 修复:
test-cycle-execute
Issue 管理
- 每天:
issue:discover - 每周:
issue:plan --all-pending→issue:execute
10.4. 三篇笔记导航
第一篇:CCW 实战指南
- 快速开始
- 主干工作流(Level 1-5)
- 核心概念
- 日常开发场景
第二篇:高级特性
- Issue 工作流
- Level 5 深度解析
- 多 CLI 协同原理
- 生产环境最佳实践
第三篇:速查手册(本篇)
- 完整命令索引
- 场景到命令映射
- 决策流程图
- 快速参考卡片
恭喜! 你已经掌握了 CCW 的完整知识体系。现在可以开始实战了!
需要帮助?
- 官方文档:github.com/catlog22/Claude-Code-Workflow
- 微信交流群:扫描 README 中的二维码
- Issue 反馈:github.com/catlog22/Claude-Code-Workflow/issues



