智能体项目管理 (APM)

与 AI 智能体团队协作，流畅高效地管理复杂项目。

什么是 APM？

APM 是一个开源框架，用于借助 AI 助手管理大型软件项目。不同于在单一且日益混乱的聊天中工作，APM 将您的工作结构化为一个协调一致的系统，由不同的 AI 智能体作为一个团队共同负责规划、协调和执行。

随着对话的不断推进，AI 的上下文理解能力会逐渐下降。助手可能会忘记需求、生成错误代码或凭空捏造细节。对于大型项目而言，这几乎会让持续进展变得不可能。

为此，APM 协调三种专门的智能体类型，每种智能体都在独立的上下文中运行，仅处理其所需的信息：

• 规划者 - 进行结构化的项目调研，并将需求分解为三份规划文档：规格书（要构建什么）、计划书（如何组织工作）以及规则（如何执行工作）。
• 管理者 - 通过分配任务给执行者、审查已完成的工作并维护项目状态来协调执行过程。管理者基于执行摘要而非原始代码进行操作。
• 执行者 - 在高度限定的上下文中执行特定任务。每个执行者都会收到包含所有必要信息的独立任务提示，完成任务后进行验证并汇报结果。

项目状态存储在结构化的文件中，这些文件不依赖于任何智能体的上下文。当对话结束或某个智能体达到其限制时，交接机制会根据需要将当前的工作知识传递到新的实例中。这也使得已完成的 APM 会话可以被归档，并将其上下文延续到新的会话中。

快速入门

APM 支持 Claude Code、Codex CLI、Cursor、GitHub Copilot、Gemini CLI 和 OpenCode。

安装 CLI：

npm install -g agentic-pm

导航到您的项目目录并初始化：

apm init

按照提示选择您的 AI 助手。CLI 会将命令、指南、技能以及项目工件模板安装到您的工作区中。

接下来，打开您的 AI 助手并运行：

/apm-1-initiate-planner

您也可以提供关于您想要构建的内容的上下文：

/apm-1-initiate-planner 我希望您构建 Claude Opus 5。请务必准确无误。

规划者会与您协作完成项目调研，并创建规划文档供您审核。一旦批准，它会引导您开启一个新的对话，并运行 /apm-2-initiate-manager 以开始协调执行。从那时起，每个智能体会逐步指导您完成整个流程。

有关完整教程，请参阅 入门指南。

文档

完整的文档可在 agentic-project-management.dev 上找到：

• 简介 - APM 是什么以及它是如何工作的
• 入门 - 从安装到第一个任务周期
• 智能体类型 - 规划者、管理者和执行者的角色
• 智能体编排 - 沟通、协调、记忆和交接机制
• 工作流概述 - 每个步骤的详细说明

该网站还涵盖了高级主题，例如 APM 的提示和上下文工程如何在底层运作、多智能体协调背后的设计原则、模型选择和成本优化的技巧、故障排除以及自定义等内容。

CLI

命令	描述
apm init	使用官方版本进行初始化
apm custom	从自定义仓库安装
apm update	更新到最新兼容版本
apm archive	归档当前会话或管理归档
apm add / apm remove	添加或移除助手
apm status	显示安装状态

更多详细信息请参阅 CLI 指南。

自定义

APM 支持自定义仓库，适用于希望修改工作流程的团队。您可以 fork 该仓库以保持与上游同步，或使用“使用此模板”功能从头开始，调整模板、构建、发布，并使用 apm custom -r owner/repo 进行安装。其中包含一个 自定义技能，可指导 AI 智能体完成整个过程。

有关详细信息，请参阅 自定义指南。

APM Auto

APM Auto 是 APM 的官方自定义版本，专为 Claude Code 打造。它用自主子代理调度取代了用户介导的执行者模式——管理者会通过 Agent() 启动临时子代理来执行任务，审查其输出，并继续工作，无需您在不同聊天之间来回传递消息。最适合原型开发、快速执行以及较为简单的项目。

apm custom -r sdi2200262/apm-auto

APM Assist

apm-assist 技能可将您的 AI 助手转变为具备 APM 知识的助手。将其安装到任何项目中，您的助手便能够解释 APM 的工作原理、通过阅读实时文档回答问题、检测您的安装状态和版本，并指导您从 v0.5.x 版本迁移。它适用于任何支持的平台。

# Claude Code 示例
mkdir -p .claude/skills/apm-assist
curl -sL https://raw.githubusercontent.com/sdi2200262/agentic-project-management/main/skills/apm-assist/SKILL.md \
  -o .claude/skills/apm-assist/SKILL.md

其他平台的独立技能目录请参见 技能目录。

从 v0.5.x 迁移

v1.0.0 是一次彻底的重新设计——工作流程、文件结构、CLI 以及智能体的角色都发生了重大变化。v1.0.0 之前的代码库保留在 v0.5.x 分支上，供参考。

故障排除指南 记录了推荐的迁移步骤。上述的 apm-assist 技能也可以交互式地引导您完成迁移。

贡献

欢迎贡献。请参阅 CONTRIBUTING.md 以获取指南。可通过 GitHub Issues 报告 bug 或提出功能建议。也可在 Discord 上联系：cobuter_man。

版本管理

CLI 和模板的发布各自独立进行版本号管理，但为了保持兼容性，它们共享主版本号。详情请参阅 VERSIONING.md。

许可证

本项目采用 Mozilla 公共许可证 2.0 (MPL-2.0) 许可。APM 可用于所有用途，包括商业用途。对 APM 核心文件所做的改进必须与社区共享。完整详情请参阅 LICENSE。

v0.4.0 之前的版本采用 MIT 许可证发布。自 v0.4.0 起，许可证更新为 MPL-2.0。

Agentic Project Management (APM) 快速上手指南

Agentic Project Management (APM) 是一个开源框架，旨在通过协调多个专用 AI 智能体（规划者、管理者、执行者）来高效管理复杂的软件开发项目，解决单一对话中上下文丢失和幻觉问题。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 macOS、Linux 或 Windows (WSL)。
• Node.js：已安装 Node.js (建议 v18 或更高版本)，因为 APM 基于 npm 分发。
• AI 助手客户端：已安装并配置好以下任一支持的 AI 编程助手：
  • Claude Code
  • Codex CLI
  • Cursor
  • GitHub Copilot
  • Gemini CLI
  • OpenCode

注意：目前官方未提供特定的中国镜像源，请使用标准的 npm 源。如果网络受限，可配置国内 npm 镜像（如淘宝镜像）加速安装：

npm config set registry https://registry.npmmirror.com

安装步骤

1. 全局安装 APM CLI 打开终端，运行以下命令安装命令行工具：

   npm install -g agentic-pm
   

2. 初始化项目 进入您的目标项目目录，并运行初始化命令：

   apm init
   

3. 配置 AI 助手 运行上述命令后，CLI 会提示您选择正在使用的 AI 助手。根据提示完成选择后，工具会自动将必要的命令、指南、技能文件及项目模板注入到您的工作区中。

基本使用

安装完成后，您需要在 AI 助手的对话界面中通过特定指令启动工作流。

1. 启动规划阶段 (Planner) 打开您的 AI 助手（如 Cursor 或 Claude Code 的聊天窗口），输入以下指令启动规划者智能体：

   /apm-1-initiate-planner
   

   您也可以直接附带项目需求描述：

   /apm-1-initiate-planner I want you to build a simple todo app with React.
   

2. 审查与确认 Planner 智能体将与您协作进行项目探索，并生成三份核心文档供您审查：

   • Spec (构建什么)
   • Plan (如何组织工作)
   • Rules (如何执行工作)

   仔细阅读并确认这些文档无误。

3. 启动执行阶段 (Manager) 规划文档批准后，Planner 会指导您开启一个新的对话窗口。在新窗口中运行以下指令以启动管理者智能体，开始协调任务执行：

   /apm-2-initiate-manager
   

4. 跟随工作流 此后，AI 智能体会逐步引导您完成剩余流程。Manager 会将具体任务分配给 Worker 智能体，您只需按照提示在不同对话间切换或确认即可，无需手动传递大量上下文信息。

更多详细的工作流说明和高级配置，请访问官方文档：agentic-project-management.dev