JSON 驱动的多智能体开发框架，支持四级工作流系统、多 CLI 智能编排与依赖感知并行执行，适用于自动化功能开发、Bug 修复与 TDD 测试驱动开发。

Claude Code Workflow (CCW)#

项目概述#

Claude Code Workflow (CCW) 是一个基于 TypeScript 和 Python 构建的智能开发编排框架，由 dyw (catlog22) 开发维护。它通过四级工作流系统（从即时执行到全自动编排）解决 AI 辅助开发中的上下文管理和工具割裂问题。

基础信息：

当前版本：v6.3.54
许可证：MIT License
NPM 包名：claude-code-workflow
运行环境：Node.js >= 18.0.0
主要语言：TypeScript (70%), Python (24.3%)

核心能力#

四级工作流系统#

级别	命令示例	特点
Level 1	`/workflow:lite-lite-lite`	即时执行，无中间产物
Level 2	`/workflow:lite-plan`, `/workflow:lite-fix`	轻量级规划
Level 3	`/workflow:plan`, `/workflow:tdd-plan`	标准规划，会话持久化
Level 4	`/workflow:brainstorm:auto-parallel`	多角色头脑风暴 → 规划 → 执行
Level 5	`/ccw`, `/ccw-coordinator`	全自动智能编排

多 CLI 编排#

支持语义化调用外部 CLI 工具：Gemini CLI、Qwen Code、OpenAI Codex、OpenCode。

协作模式：Collaborative（协作式）、Parallel（并行式）、Iterative（迭代式）、Pipeline（流水线式）

依赖感知并行执行#

规划阶段自动进行依赖分析，识别任务依赖关系和关键路径，分区为并行组和串行链，无需 worktree 即可实现代理并行执行。

CodexLens 代码搜索#

FTS：基于 SQLite FTS5 的全文搜索
Semantic：使用本地嵌入模型的语义搜索
Hybrid：FTS + Semantic + Reranking 混合搜索

Dashboard 可视化#

Session Overview（会话概览）、CodexLens 搜索界面、Graph Explorer（代码关系可视化）、CLI Manager（执行历史与会话恢复）。

安装与快速开始#

# 全局安装
npm install -g claude-code-workflow

# 初始化
ccw install -m Global

五分钟上手：

创建计划：/workflow:plan "Create a simple Express API"
执行计划：/workflow:execute
检查状态：/workflow:status

典型应用场景#

快速功能开发：/workflow:plan "Implement JWT-based login"
Bug 诊断修复：/workflow:lite-fix "Incorrect success message"
多角色头脑风暴：/workflow:brainstorm:auto-parallel "Design real-time collaborative editor" --count 5
TDD 开发：/workflow:tdd-plan "Implement payment gateway"
UI 设计探索：/workflow:ui-design:explore-auto --prompt "Modern admin dashboard"

架构设计#

采用分层架构，顶层为多级工作流系统，底层通过 MCP 协议和伪终端技术调度外部 CLI。

核心模块：

ccw/ - TypeScript 核心后端
ccw/frontend/ - Dashboard 前端
codex-lens/ - Python 代码搜索模块
.claude/ - Claude 配置（agents, commands, skills）

主要命令#

命令	描述
`ccw install`	安装工作流文件
`ccw view`	打开 Dashboard
`ccw cli -p "..."`	执行 CLI 工具
`/ccw`	自动工作流编排器
`/ccw-coordinator`	智能编排入口

自定义扩展#

通过 Dashboard 注册任意 API 作为自定义 CLI 工具，配置 Name、Endpoint、API Key 即可接入工作流。

CLAUDE.md 记忆管理：/memory:update-full（完整索引重建）、/memory:load（加载任务上下文）、/memory:update-related（增量更新）

Claude Code Workflow (CCW)