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 仓库。

典型使用流程

  1. 头脑风暴 / PRD – 说 “我想构建一个通知系统” → CCPM 提出澄清问题并编写 .claude/prds/notification-system.md。
  2. 解析 PRD → Epic – “解析 notification-system PRD” 创建 .claude/epics/notification-system/epic.md。
  3. 分解 – “分解 notification-system epic” 生成带有元数据(depends_on、parallel)的任务 Markdown 文件。
  4. 同步到 GitHub – “将 notification-system epic 同步到 GitHub” 创建 epic issue 和子 issues,将本地任务文件重命名为 issue 编号,并设置专用的 worktree。
  5. 执行 – “开始处理 issue 42” 启动并行代理,每个代理限定在自己的文件中;每个代理提交消息如 Issue #42: …。
  6. 跟踪 – “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%。

背后团队

底线 CCPM 是一个轻量级、Markdown 优先的技能,让 AI 编码代理像纪律严明的项目经理一样运作,保留上下文,实现真正的并行工作,并让一切在 GitHub Issues 中可见。对于已经使用基于 LLM 的编码助手并希望获得可重复、可审计工作流的团队来说,这是一个实用的补充。

相关

  • 项目
  • 项目
  • 项目
  • 项目