AgentPM

AgentPM

site icon
2025.05.07 0
TypeScriptAI 驱动开发项目管理任务协调开发效率
AgentPM 是一个用于 AI 驱动软件开发的规划和协调系统,作为 MCP 服务器本地安装。它集成了支持 Anthropic 模型上下文协议规范的 IDE(如 Cursor、Augment、VS Code Copilot、Cline 和 Roo)。AgentPM 扮演产品经理的角色,帮助开发者规划、优先排序和执行复杂项目,包括开发全面的需求、将复杂项目分解为可操作的任务、提供上下文感知的协助、交付相关文档、指导技术决策和系统设计,并推广软件开发最佳实践(如 TDD 和垂直切片)。
View on GitHub

Overview

基本能力

产品定位

AgentPM 是一个 AI 驱动的软件开发和项目管理工具,旨在帮助开发者更高效地规划、执行和协调复杂项目。

核心功能

  • 任务管理:创建、查询、更新和删除任务及子任务。
  • 项目规划:通过交互式访谈创建项目简报并生成任务。
  • 依赖管理:管理任务间的依赖关系,包括添加、移除、验证和修复依赖。
  • 复杂度分析:分析任务复杂度并生成扩展建议。
  • 智能上下文管理:在适当的时间向编码代理提供正确的信息,优化令牌使用。
  • 结构化输出:自动生成清晰、易读的 Markdown 文档。
  • 集成文档检索:通过 Context7 集成自动检索相关文档。

适用场景

  • 复杂项目管理:帮助开发者分解和执行复杂项目。
  • 任务协调:提供上下文感知的协助,优化开发流程。
  • 文档生成:自动生成项目文档和任务报告。
  • 依赖管理:确保任务间的依赖关系正确无误。

工具列表

  1. apm_task:查询项目中的任务。
  2. get_all:列出所有任务。
  3. get_single:查看特定任务。
  4. get_next:找到下一个要处理的任务。
  5. filter_by_statusfilter_by_priority:按状态或优先级筛选任务。

  6. apm_task_modify:创建、更新和删除任务及子任务。

  7. create:添加新任务。
  8. update:更新任务详情。
  9. update_status:更改任务状态。
  10. delete:移除任务。
  11. add_subtask:向任务添加子任务。
  12. remove_subtask:从任务中移除子任务。
  13. expand:将任务分解为子任务。

  14. apm_task_generate:在 apm-artifacts/ 目录中生成单独的任务文件。

  15. apm_project_brief_create:通过交互式访谈创建项目简报并生成任务。

  16. apm_project_brief_status:检查项目简报操作的进度。

  17. apm_project_brief_result:检索已完成的项目简报。

  18. apm_dependencies:管理任务依赖关系。

  19. add:添加依赖。
  20. remove:移除依赖。
  21. validate:检查依赖问题。
  22. fix:自动修复依赖问题。

  23. apm_complexity:分析任务复杂度并生成扩展建议。

常见问题解答

  • 如何安装 AgentPM? 确保已安装 Node.js 20.0.0 或更高版本,并配置 Anthropic API 密钥。
  • 如何调试 AgentPM? 设置 DEBUG=true 以启用详细日志记录。
  • 如何集成到 IDE? 参考特定 IDE 的 MCP 服务器文档(如 Cursor、Augment、VS Code Copilot)。

使用教程

使用依赖

  • Node.js:版本 20.0.0 或更高。
  • Anthropic API Key:用于 Claude AI 集成。
  • Perplexity API Key:用于研究支持的任务生成(可选)。

安装教程

Cursor

在项目的 .cursor/mcp.json 文件中添加以下内容:

{
    "mcpServers": {
        "agent-pm": {
          "command": "npx",
          "args": [
            "-y",
            "@gannonh/agent-pm@latest"
          ],
          "env": {
            "PROJECT_ROOT": "/path/to/project/root/",
            "ANTHROPIC_API_KEY": "sk-your-anthropic-api-key",
            "PERPLEXITY_API_KEY": "pplx-your-perplexity-api-key",
            "DEBUG": "true"
          }
        }
    }
}

Augment

在 VS-Code Augment 用户设置文件中添加以下内容:

"augment.advanced": {
  "mcpServers": [
    {
      "name": "agent-pm",
      "command": "npx",
      "args": [
        "-y",
        "@gannonh/agent-pm@latest"
      ],
      "env": {
        "PROJECT_ROOT": "/path/to/project/root/",
        "ANTHROPIC_API_KEY": "sk-your-anthropic-api-key",
        "PERPLEXITY_API_KEY": "pplx-your-perplexity-api-key",
        "DEBUG": "true"
      }
    }
  ]
}

调试方式

设置 DEBUG=true 以启用详细日志记录,日志文件将保存在 logs 目录中。

标签信息

  • 安装类型:留空(未明确说明)。
  • 产品定位:["AI 驱动开发", "项目管理", "任务协调"]
  • 归类:"开发效率"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。