项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Node.js 18 或更高版本
- npm(随 Node.js 一起安装,用于全局安装 CLI)
- 一个受支持的 AI 编程助手:Claude Code、Codex CLI、Cursor、GitHub Copilot、Antigravity 或 OpenCod
- 一个已存在的项目目录(用于在其内初始化 APM)
安装与启动步骤
-
1安装 APM 命令行工具
通过 npm 全局安装 agentic-pm,装好后终端可用 apm 命令。若权限报错需加 sudo 或改 npm 全局目录。
npm install -g agentic-pm -
2在项目中初始化
进入你的项目目录执行 apm init,它会写入 APM 的命令、指南、技能与文档模板;提示时选择你的 AI 助手。
cd /your/project apm init -
3指定助手(可选)
不想交互选择时,可在 init 时用 -a 参数直接指定助手;具体取值以 CLI 提示的选项为准。
apm init -a Cursor -
4在助手中启动 Planner
用你的 AI 助手打开该项目,输入斜杠命令启动规划智能体,它会探索代码库并询问目的、需求与约束。
/apm-1-initiate-planner -
5审阅规划文档
向 Planner 描述要构建或修改的内容,审阅它产出的 Spec(做什么)、Plan(如何拆分)、Rules(怎么做)三份文档。
-
6按指引接力 Manager 与 Work
规划通过后,Planner 会让你在新对话中启动 Manager;之后每个智能体都会告知下一步运行什么、在哪里运行。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-a | 否 | apm init 时直接指定目标 AI 助手,跳过交互式选择 | Cursor |
如何确认成功
apm init 完成后项目内出现 APM 的命令、指南与文档模板,且助手中可正常触发 /apm-1-initiate-planner。
常见问题
Q:安装时报权限错误怎么办?
A:npm 全局安装需要写权限,可改用 sudo npm install -g agentic-pm,或先把 npm 全局目录改为当前用户可写后重试。
Q:支持哪些 AI 助手?
A:README 列出 Claude Code、Codex CLI、Cursor、GitHub Copilot、Antigravity、OpenCode 六种,apm init 时选择或通过 -a 传入。
Q:为什么要把工作拆给多个智能体?
A:长任务中对话变长会导致上下文衰减与上下文压力。APM 用规划文档记录项目意图,并把工作分到不同对话的多个智能体中缓解这两个问题。
Q:规划完成后如何进入实施阶段?
A:Planner 会指引你在新对话中启动 Manager,Manager 分发自包含任务给 Worker,Worker 完成后回报,你负责在中间传递消息。
注意事项
- 智能体之间的协作由你人工中转:把任务通知给对应 Worker,把回报通知给 Manager,中转前可先审阅、纠偏或干预。
- 这种人工介入被称为 productive friction(有效摩擦),用于在问题扩散前发现并修正。
- 完整流程与细节见官网 Getting Started 文档:https://agentic-project-management.dev/docs/getting-started。
核心亮点
- 用规范驱动工作流,任务定义和验收标准明确,减少智能体跑偏
- 支持多智能体角色分工与编排,适合复杂项目而非单点任务
- JavaScript 实现,前端和 Node 生态团队接入成本低
不足之处
- 项目处于成长阶段,文档和最佳实践可能还不够完善
- 多智能体工作流的调试和可观测性能力有待观察
适用场景
- 把产品需求文档拆解为多智能体可执行的任务流
- 团队协作中让不同智能体分别负责需求分析、开发和测试
- 复杂项目从规范到交付的全流程进度追踪与管理
替代项目
MetaGPT、CrewAI
上一篇:concordia
下一篇:motleycrew
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
