CCPM：Claude Code 项目管理——多 Agent 并行执行的工作流系统
CCPM：Claude Code 项目管理——多 Agent 并行执行的工作流系统
GitHub: github.com/automazeio/ccpm
由 Automaze 开发，将 “vibe coding” 转变为规范驱动开发
💡 核心思想
Stop losing context. Stop blocking on tasks. Stop shipping bugs.
CCPM (Claude Code Project Management) 是一套经过实战检验的系统：
- 将 PRD 转化为 Epics
- 将 Epics 转化为 GitHub Issues
- 将 Issues 转化为生产代码
- 每一步都有完整的可追溯性
🎯 解决的问题
| 传统开发问题 | CCPM 解决方案 |
|---|---|
| 会话间上下文丢失 | 所有工作保持持久化上下文 |
| 串行任务执行 | 独立任务上的并行 Agent |
| “vibe coding” 凭记忆编码 | 规范驱动，完全可追溯 |
| 分支中隐藏进度 | GitHub 中的透明审计轨迹 |
| 手动任务协调 | /pm:next 智能优先级排序 |
📋 五阶段工作流纪律
阶段 1：头脑风暴 —— Product Planning
/pm:prd-new feature-name
启动全面头脑风暴，创建产品需求文档，包含愿景、用户故事、成功标准和约束条件。
输出： .claude/prds/feature-name.md
阶段 2：文档化 —— Implementation Planning
/pm:prd-parse feature-name
将 PRD 转化为技术实现计划，包含架构决策、技术方法和依赖映射。
输出： .claude/epics/feature-name/epic.md
阶段 3：规划 —— Task Decomposition
/pm:epic-decompose feature-name
将 Epic 分解为具体的、可操作的任务，包含验收标准、工作量估算和并行化标记。
输出： .claude/epics/feature-name/[task].md
阶段 4：任务分解 —— GitHub 同步
/pm:epic-sync feature-name
# 或一键完成：
/pm:epic-oneshot feature-name
将 Epic 和任务推送到 GitHub，创建带有适当标签和关系的 Issues。
阶段 5：执行与同步 —— Execution
/pm:issue-start 1234 # 启动专门 Agent
/pm:issue-sync 1234 # 推送进度更新
/pm:next # 获取下一个优先级任务
专门 Agent 执行任务，同时维护进度更新和审计轨迹。
🚀 并行执行系统（核心亮点）
重新定义：Issue ≠ 单个任务
传统认知：
- 一个 Issue = 一个开发者 = 一个任务
CCPM 的重新定义：
- 一个 Issue = 多个并行工作流
示例： “实现用户认证” Issue 可分解为：
| Agent | 任务 |
|---|---|
| Agent 1 | 数据库表和迁移 |
| Agent 2 | 服务层和业务逻辑 |
| Agent 3 | API 端点和中间件 |
| Agent 4 | UI 组件和表单 |
| Agent 5 | 测试套件和文档 |
5 个 Agent 同时在同一个 worktree 中运行！
速度数学
| 方式 | 执行模式 | 并行度 |
|---|---|---|
| 传统方法 | 3 个 Issues，串行执行 | 1 |
| CCPM | 3 个 Issues，每个拆成 ~4 个并行流 | 12 |
12 个 Agent 同时工作！
🧠 上下文优化
传统单线程方法的问题：
- 主对话承载所有实现细节
- 上下文窗口被数据库模式、API 代码、UI 组件填满
- 最终达到上下文限制并失去连贯性
并行 Agent 方法的优势：
- 主线程保持简洁和战略性
- 每个 Agent 在隔离环境中处理自己的上下文
- 实现细节永远不会污染主对话
- 主线程成为”指挥”而非”演奏者”
🤔 为什么选择 GitHub Issues 作为数据库？
CCPM 没有引入独立的数据库或项目管理工具，而是直接使用 GitHub Issues。
1. 🤝 真正的团队协作
- 多个 Claude 实例可同时在一个项目上工作
- 人类开发者通过 Issue 评论实时看到 AI 进展
- 团队成员可以随时介入——上下文始终可见
- 管理者获得透明度而不会中断工作流程
2. 🔄 无缝人机交接
- AI 可以开始任务，人类可以完成（反之亦然）
- 进度更新对所有人可见，而不是困在聊天记录中
- 代码审查通过 PR 评论自然进行
- 没有”AI 做了什么？”的会议
3. 📈 超越单人工作的可扩展性
- 添加团队成员而无需入职摩擦
- 多个 AI Agent 并行处理不同 Issues
- 分布式团队自动保持同步
- 与现有 GitHub 工作流程和工具配合工作
4. 🎯 单一事实来源
- 没有单独的数据库或项目管理工具
- Issue 状态就是项目状态
- 评论就是审计轨迹
- 标签提供组织结构
📁 系统架构
.claude/
├── CLAUDE.md # 常驻指令
├── agents/ # 任务导向 Agent
├── commands/ # 命令定义
│ ├── context/ # 创建、更新、预加载上下文
│ ├── pm/ # 项目管理命令
│ └── testing/ # 测试相关
├── context/ # 项目级上下文文件
├── epics/ # PM 的本地工作区
│ └── [epic-name]/
│ ├── epic.md # 实现计划
│ ├── [#].md # 独立任务文件
│ └── updates/ # 正在进行的工作更新
├── prds/ # PRD 文件
├── rules/ # 规则文件
└── scripts/ # 脚本文件
⌨️ 常用命令速查
初始化
| 命令 | 说明 |
|---|---|
/pm:init |
安装依赖并配置 GitHub |
/context:create |
预加载系统上下文 |
PRD 命令
| 命令 | 说明 |
|---|---|
/pm:prd-new |
启动新产品需求头脑风暴 |
/pm:prd-parse |
将 PRD 转换为实现 Epic |
/pm:prd-list |
列出所有 PRD |
/pm:prd-edit |
编辑现有 PRD |
/pm:prd-status |
显示 PRD 实现状态 |
Epic 命令
| 命令 | 说明 |
|---|---|
/pm:epic-decompose |
将 Epic 拆分为任务文件 |
/pm:epic-sync |
将 Epic 和任务推送到 GitHub |
/pm:epic-oneshot |
一键分解并同步 |
/pm:epic-list |
列出所有 Epics |
/pm:epic-show |
显示 Epic 及其任务 |
/pm:epic-close |
标记 Epic 为完成 |
Issue 命令
| 命令 | 说明 |
|---|---|
/pm:issue-show |
显示 Issue 和子 Issues |
/pm:issue-start |
开始使用专门 Agent |
/pm:issue-sync |
推送更新到 GitHub |
/pm:issue-close |
标记 Issue 为完成 |
工作流命令
| 命令 | 说明 |
|---|---|
/pm:next |
显示下一个优先级 Issue |
/pm:status |
整体项目仪表板 |
/pm:standup |
每日站会报告 |
/pm:blocked |
显示被阻塞的任务 |
/pm:in-progress |
列出正在进行的工作 |
📊 实际效果
使用此系统的团队报告：
| 指标 | 改进 |
|---|---|
| 上下文切换时间 | 减少 89% —— 你会很少使用 /compact 和 /clear |
| 并行任务数 | 5-8 个 vs 之前的 1 个 |
| Bug 率 | 降低 75% —— 归功于将功能分解为详细任务 |
| 功能交付速度 | 提升 3 倍 —— 基于功能大小和复杂度 |
🛠️ 快速开始
安装（2 分钟）
Unix/Linux/macOS:
cd path/to/your/project/
curl -sSL https://automaze.io/ccpm/install | bash
Windows (PowerShell):
cd path/to/your/project/
iwr -useb https://automaze.io/ccpm/install | iex
初始化
/pm:init
/context:create
开始第一个功能
/pm:prd-new your-feature-name
🔗 相关资源
- GitHub: https://github.com/automazeio/ccpm
- 官网: https://automaze.io
- 中文文档: https://github.com/automazeio/ccpm/blob/main/zh-docs/README_ZH.md
整理时间：2026-02-02