CCPM 项目经理代理
为 AI 代理提供结构化项目管理大脑:从 PRD 到 GitHub Issues,再到并行执行的完整流程。
证据显示:README 描述了 GitHub 集成(gh CLI、gh-sub-issue 扩展)和本地文件操作,但未明确权限最小化原则;用户确认机制存在(如 sync 前询问),但未系统化;数据流透明度部分(文件路径、GitHub 同步)有说明,但缺少敏感数据处理细节;依赖安全未提及;外部影响(创建 issues、worktree)有描述,但未提供撤销或回滚的具体机制;来源归属(作者、公司)有提及,但发布者未验证。扣分原因:权限最小化、用户确认、数据流透明度、外部影响、回滚、来源归属均仅部分满足,敏感数据处理和依赖安全缺失。
证据显示:README 内部一致,工作流描述清晰;依赖(git、gh、gh-sub-issue)有列出,但未提供版本或安装验证;失败消息未提及。扣分原因:自洽性较好,但依赖可用性和失败消息不足。
证据显示:目标受众(开发者、团队)和场景(PRD、epic、并行执行)明确;能力边界(本地 vs GitHub)有表格说明;触发词(自然语言)有列表;环境适配(多种 harness)有说明。扣分原因:能力边界和触发精度部分满足,但环境适配未提供具体配置细节。
证据显示:信息架构清晰(目录、结构图);安装说明详细(克隆、symlink);命名稳定性有说明(任务文件命名规则);示例和 FAQ 有示例流程,但无 FAQ;已知限制未明确;许可证为 MIT;版本和变更日志未提及;维护责任(作者、公司)有提及。扣分原因:已知限制、版本变更日志缺失,维护责任部分。
证据显示:输出可用性(standup、状态报告)有描述;边际价值(并行执行、上下文保留)有说明;成本效益(减少上下文切换、bug 率)有声称。扣分原因:输出可用性、边际价值、成本效益均基于声称,缺乏独立验证。
证据显示:README 中的声明(如 89% 减少)未提供可追溯来源;基准测试结果(100% vs 27.7%)未提供测试细节;事实与推断未明确区分。扣分原因:声明缺乏可追溯性,交叉验证不足,事实与推断混合。
- 发布者身份未验证,需谨慎对待来源。
- 依赖安全未提及,使用前应检查 gh-sub-issue 等扩展的安全性。
- 敏感数据处理未说明,涉及凭据或私有数据时需额外审查。
- 回滚机制未明确,执行同步或合并操作前应备份。
- 性能声明(如 89% 减少)缺乏可验证证据,不应作为决策依据。
这个 Agent 能做什么,适合哪些场景?
CCPM 是一个基于 Agent Skills 标准的项目管理技能,专为 AI 编码代理设计。它以 GitHub Issues 作为单一事实来源,通过 Git worktrees 实现并行执行。核心流程包括:头脑风暴、PRD 编写、技术史诗生成、史诗分解为任务、同步到 GitHub Issues、并行启动多个代理工作。所有状态和追踪操作都通过 Bash 脚本完成,保证快速且零 LLM 开销。CCPM 与多个代理 harness 兼容,包括 Claude Code、Codex、OpenCode、Factory、Amp、Cursor 等。它消除了上下文丢失,提供全链路可追溯性,并强调“无随意编码”原则,每行代码都必须追溯到规范。
CCPM 首先引导用户进行结构化头脑风暴,生成 PRD 文件存储在 .claude/prds/。然后解析 PRD 生成技术史诗,存储在 .claude/epics/<feature>/epic.md。接着将史诗分解为任务文件,包含依赖、并行和冲突元数据。同步操作通过 GitHub CLI 创建史诗 issue 和子 issue,并设置专用 worktree。执行阶段分析 issue 识别并行工作流,启动多个代理同时工作,每个代理提交时带 Issue #N: description 消息。追踪操作如 status.sh、standup.sh 等脚本即时运行,从项目文件生成报告。
- 独立开发者想将想法快速转化为可追踪的规范,避免在编码过程中丢失上下文。
- 团队需要并行处理多个功能,但担心多个代理修改同一代码库产生冲突。
- 项目负责人希望从高级 PRD 自动生成技术史诗和任务分解。
- 需要清晰审计轨迹的团队:每个决策都记录在 PRD、史诗、Issue 和提交中。
- 代理工作流需要 GitHub Issues 作为单一事实来源,以便人类和代理无缝交接。
这个 Agent 有哪些优点和局限?
- 使用 Git worktrees 实现真正的并行执行,多个代理同时工作,速度提升可达 3 倍。
- 通过 PRD、史诗、Issue、代码的层级关联,实现全链路可追溯性。
- 所有操作由 Bash 脚本驱动,状态和 standup 即时返回,无 LLM 开销。
- 遵循 agentskills.io 标准,兼容多种 harness,无锁定。
- GitHub Issues 作为唯一事实来源,支持团队协作和交接。
- 需要安装并配置 GitHub CLI 和 gh-sub-issue 扩展,依赖 GitHub 基础设施。
- 实现需要一定学习曲线,理解 PRD、史诗、任务和同步的概念。
- 并行执行可能增加 Git 冲突风险,尽管 worktrees 缓解,但管理复杂。
- 文档中的性能数据(如 89% 减少上下文切换)来自项目自身评估,缺少独立验证。
- 对小型项目可能过重,流程和文件结构可能显得繁琐。
如何安装或部署这个 Agent?
克隆仓库:git clone https://github.com/automazeio/ccpm.git。然后根据 harness 进行安装:对于 Factory/Droid,使用 ln -s /path/to/ccpm/skill/ccpm ~/.factory/skills/ccpm;对于 Claude Code,在项目根目录创建 .claude/skills/ 并符号链接。需要先安装并认证 GitHub CLI(gh auth login),并安装 gh-sub-issue 扩展(gh extension install yahsan2/gh-sub-issue)。
如何使用这个 Agent?
安装后,CCPM 自动激活。直接用自然语言表达意图,例如:“I want to build a notification system”。CCPM 会进行引导式头脑风暴,生成 PRD。然后说“parse the notification-system PRD”生成史诗,“break down the notification-system epic into tasks”分解任务,“sync the notification-system epic to GitHub”同步到 GitHub,“start working on issue 42”开始并行执行。使用“standup”、“what's next”、“what's blocked”获取即时状态报告。
常见问题
CCPM 是否只适用于 Claude Code?
需要什么前置条件?
CCPM 如何处理并行代理的冲突?
conflicts_with 元数据可进一步避免冲突。