CCPM 多代理项目管理：从 PRD 到并行执行的 5 阶段实战指南
【免费下载链接】ccpmProject management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.项目地址: https://gitcode.com/GitHub_Trending/ccpm/ccpm
CCPM（Claude Code Project Manager）是基于 GitHub Issues 与 Git 工作树的多代理项目管理系统，把需求一路拆到可并行执行的代码。它专治三类痛点：上下文在会话间蒸发、多个代理改同一份代码互相冲突、需求被口头决定悄悄改掉。本文覆盖核心机制、并行冲突防护、提效脚本与自定义配置。
它是怎么跑起来的：核心机制拆解 🔍
CCPM 把状态从看板里挪了出来——需求落成文件，文件本身就成了进度条。
规划阶段把想法落成文件：references/plan.md先通过几轮追问把模糊需求写成 PRD，再翻译成带架构决策的技术 Epic；每个任务是带 frontmatter 的 md，状态、前置依赖、能否并行都写在文件头，落在.claude/epics/下。
同步阶段让 GitHub 成为唯一事实源：references/sync.md建一个 Epic 主 issue、批量建子 issue，把占位文件名001.md改写成真实 issue 编号并补上映射，再切出独立 worktree，给整个 Epic 一个干净隔离的环境。
执行阶段是并行的真正发生地：references/execute.md拿到 issue 先做并行分析，拆出数据库、服务、API、UI 等互不重叠的流，给每条流起一个代理，各改各的文件，用统一格式的 commit 回写进度；主会话只当指挥、不下场写实现，上下文因此始终干净。
Epic 与 Task 的层级展示
多代理/多人场景：冲突怎么防住 🚀
想让五个代理同时开干又不打架，靠的不是聪明，而是提前把地盘和退路都划清楚。
- 文件级隔离：每个代理只改自己那条流声明过的文件，碰到别人的先在自己的进度文件里记一笔，等对方提交后再拉取。
- 靠 Git 同步：高频 commit，格式统一成
Issue #N: 描述，谁在什么时候干了什么，翻历史就能查。 - 快速失败：动共享文件前先
git status <file>看一眼，发现别人改过就等待并 pull，绝不偷偷做智能合并。 - 人工决议：冲突由人来拍板，代理只负责把它暴露出来然后暂停，不替人做决定。
- 禁止 force：任何 git 操作都不带
--force，保证历史可回溯、可复查。
name: 实现用户认证 status: open parallel: true # 可与无冲突任务并行 depends_on: [] # 前置依赖的 issue 号 conflicts_with: [1240] # 触碰相同文件需协调提效脚本与自动化：哪些值得跑 ⚡
状态、站会、卡点这类查询根本不用烧 token，bash 脚本扫文件就能秒出。
| 脚本 | 作用 | 典型场景 |
|---|---|---|
status.sh | 汇总项目整体状态 | 快速摸清全局 |
standup.sh | 生成每日站会报告 | 晨会前一键出稿 |
next.sh | 列出下一个可接的任务 | 决定下一步做什么 |
blocked.sh | 列出被阻塞的任务 | 排查卡在哪 |
validate.sh | 校验项目状态一致性 | 提交前做个体检 |
脚本都在skill/ccpm/references/scripts/，纯 bash、读文件出结果、零 token 成本，挂进 CI 或设成本地 alias 都行。
定制与扩展：改哪个文件、影响什么 ⚙️
想改行为，先找对文件——改错地方会让脚本和文档各说各话。
skill/ccpm/SKILL.md：description 是技能触发条件，五阶段路由决定一句话怎么分发 → 改这里调整哪些话会激活技能 → 触发词写太宽会误激活、太窄又不响应。references/conventions.md：集中定义 frontmatter 字段、路径命名与 git/worktree 规则 → 它是所有阶段读写文件的格式契约 → 改字段名后要同步各脚本里的 grep，例如status:。references/execute.md：这里藏着并行代理的 prompt 模板和协调规则 → 改它直接影响多代理怎么领任务、怎么避让 → 保留Issue #N:commit 格式，否则进度脚本会失算。
5 分钟上手：从 clone 到第一条命令 🏁
从拿到仓库到跑通第一条命令，五分钟能走完整条链路。
- 先把仓库 clone 到本地。
- 在你的项目里把技能软链进 harness 的 skills 目录，例如
.claude/skills/ccpm。 - 确认 git 和已登录的
ghCLI 可用，没有就gh auth login。 - 用自然语言对 agent 说 "I want to build X"，它会依次走 PRD、Epic、拆解。
- 想看现状直接跑状态脚本，不必切窗口去问 agent。
git clone https://gitcode.com/GitHub_Trending/ccpm/ccpmln -s /path/to/ccpm/skill/ccpm .claude/skills/ccpm适合用 GitHub 管迭代、想让多个代理并行开干的中小团队，尤其 feature 驱动、并行度高的项目；单人调试或一次性脚本场景，用不上这套流程。
【免费下载链接】ccpmProject management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.项目地址: https://gitcode.com/GitHub_Trending/ccpm/ccpm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
