automazeio/ccpm
Project management skill system for Agents that uses GitHub Issues and Git worktrees for parallel agent execution.
CCPM – 项目经理代理
它是什么
- 一种 Agent Skill(兼容 agentskills.io 标准),为 AI 编码代理提供结构化的项目管理大脑。
- 将自然语言想法转化为完整的规范驱动工作流:PRD → Epic → Task → GitHub Issue → Code,每一步都记录在仓库中。
为什么重要
- 上下文永不丢失 – 所有规范、决策和进度都存储在
.claude/下的纯 Markdown 文件中,而不是丢失在聊天日志中。 - 并行性 – 单个问题可以拆分为多个独立流,在单独的代理上同时运行,大幅缩短墙钟时间。
- GitHub 原生 – 使用 GitHub Issues(以及可选的
gh-sub-issue扩展)作为唯一事实来源,团队无需额外的项目管理工具即可与人类或代理协作。 - Harness 无关 – 适用于 Claude Code、Codex、Factory、Amp、Cursor、OpenCode 等,只需将 harness 指向
skill/ccpm/。
主要特性
| 特性 | 优势 |
|---|---|
| 规范驱动的工作流 | PRD 创建、史诗规划、任务分解均由 Markdown 文件驱动,保证可追溯性。 |
| 并行执行系统 | 将任务标记为 parallel: true,并启动多个代理,每个代理在自己的 git worktree 中工作,避免冲突。 |
| GitHub 优先集成 | Issues 成为项目状态;评论作为审计跟踪。无需单独的数据库或 Projects 看板。 |
| 确定性 bash 脚本 | Stand-up、status、search、next-task、blocked-task 等作为脚本即时运行,消除额外的 LLM token 成本。 |
| Agent-skill 即插即用 | 安装一次,任何理解 Agent Skills 规范的代理都可以用自然语言调用 CCPM(例如,“开始处理 issue 42”)。 |
| 完全可追溯性 | 每一行代码都可以追溯到 PRD → Epic → Task → Issue → Commit 链。 |
安装
# 克隆仓库
git clone https://github.com/automazeio/ccpm.git
# Factory/Droid harness 示例
ln -s $(pwd)/ccpm/skill/ccpm ~/.factory/skills/ccpm
# Claude Code 示例
ln -s $(pwd)/ccpm/skill/ccpm .claude/skills/ccpm
先决条件:git、已认证的 GitHub CLI(gh),以及项目所在的 GitHub 仓库。
典型使用流程
- 头脑风暴 / PRD – 说 “我想构建一个通知系统” → CCPM 提出澄清问题并编写
.claude/prds/notification-system.md。 - 解析 PRD → Epic – “解析 notification-system PRD” 创建
.claude/epics/notification-system/epic.md。 - 分解 – “分解 notification-system epic” 生成带有元数据(
depends_on、parallel)的任务 Markdown 文件。 - 同步到 GitHub – “将 notification-system epic 同步到 GitHub” 创建 epic issue 和子 issues,将本地任务文件重命名为 issue 编号,并设置专用的 worktree。
- 执行 – “开始处理 issue 42” 启动并行代理,每个代理限定在自己的文件中;每个代理提交消息如
Issue #42: …。 - 跟踪 – “standup” 或 “what’s blocked” 运行捆绑的
standup.sh/status.sh脚本,从 Markdown 文件打印实时报告。
项目结构
skill/ccpm/
├─ SKILL.md # 技能入口点
└─ references/
├─ plan.md # PRD → epic 逻辑
├─ structure.md # 任务分解
├─ sync.md # GitHub issue 创建
├─ execute.md # 并行启动
├─ track.md # 状态/standup 脚本
└─ scripts/ # 14 个 bash 辅助脚本(status.sh、standup.sh、…)
.claude/
├─ prds/ # 产品需求文档
└─ epics/
└─ <feature>/ # epic.md + <issue-id>.md 任务文件
所有事实来源数据都存储在这些纯 Markdown 文件中。
已验证的结果(如 README 中所声称)
- 上下文切换损失的时间减少 89%。
- 5–8 个并行任务,而不是单个串行任务。
- 由于详细的编码前规范,缺陷减少 75%。
- 功能交付速度提升高达 3 倍。
- 内部基准测试显示,使用 CCPM 时 PRD 创建、issue 执行和 stand-up 的成功率为 100%,而不用时约为 28%。
背后团队
- 由 Automaze(https://automaze.io)开发,一家专注于 AI 增强软件交付的咨询公司。
- 主要联系人:@aroussi 在 X(原 Twitter)上。
底线 CCPM 是一个轻量级、Markdown 优先的技能,让 AI 编码代理像纪律严明的项目经理一样运作,保留上下文,实现真正的并行工作,并让一切在 GitHub Issues 中可见。对于已经使用基于 LLM 的编码助手并希望获得可重复、可审计工作流的团队来说,这是一个实用的补充。
相关
- 项目
- 项目
- 项目
- 项目