agentPM

Spec-Driven Agentic Delivery System — AI 代理编排驱动的产品交付系统

以需求规格为起点，通过技能自动触发、子代理流水线编排、知识库实时注入、强制审查门禁四大机制，覆盖「需求 → 设计 → 原型 → 编码 → 验收」全链路。每个阶段由专用代理执行，主流程只负责调度和质量把关，实现从一句话需求到可交付代码的自动化流转。

官网：https://www.axuremart.com

快速开始

在你的项目根目录执行：

npx --yes sdad-agentpm init

首次运行需要登录 agentPM 账号（需开通 AI 授权）。登录成功后自动安装，后续更新直接重新执行即可。

五大支柱

| 支柱 | 含义 | |------|------| | Spec-First | 先出规格（SRS），再动手写代码，规格是所有后续工作的唯一依据 | | Agent-Orchestrated | 主流程不干活，只调度——分析、撰写、审查各有专用代理 | | Knowledge-Injected | 编码规范由 hooks 自动加载 + knowledge 按需读取，不靠记忆 | | Review-Gated | 任何代码变更必须过审查门禁（code-reviewer）才能交付 | | Verify-Before-Claim | 不接受"应该没问题"，完成声明必须附带构建/测试通过的证据 |

技能列表

安装后，在支持的 AI 编码工具中说出关键词即可自动触发对应技能：

| 技能 | 触发关键词 | |------|-----------| | page-generator | 创建页面、生成页面、实现功能、开发功能 | | req-doc | 需求说明书、需求文档、SRS、细化需求 | | annotation | 标注页面、生成标注、添加标注、原型标注 | | feasibility-report | 可研报告、可行性研究、项目立项 | | feature-list | 功能清单、功能列表、功能汇总 | | brainstorming | 创建功能、构建组件、添加功能、修改行为 | | diagram-generator | 流程图、架构图、时序图、图表 | | pm-test-cases | 测试用例、QA测试、验收标准 | | pm-operation-manual | 操作手册、用户手册、使用说明 | | delivery-plan | 交付计划、实现全部功能、自动实现、连续实现 |

支持的 AI 编码工具

安装后自动生成以下工具的配置文件：

| 工具 | 配置文件 | |------|---------| | Claude Code | CLAUDE.md + .claude/ | | Cursor | .cursor/rules/agentpm.md | | Kiro | .kiro/rules/agentpm.md | | Trae | .trae/rules/agentpm.md | | Codex | .codex/AGENTS.md | | Gemini | .gemini/GEMINI.md | | Windsurf | .windsurfrules |

安装后的目录结构

your-project/
└── .claude/
    ├── agents/           # 专用子 Agent（代码审查、需求分析等）
    ├── skills/           # 技能库（触发词匹配后自动执行）
    ├── agentpm-knowledge/ # 详细规范（编码、测试、安全等）
    ├── rules/            # 核心规范（自动加载）
    ├── hooks/            # Node.js hooks（质量门禁、状态追踪）
    └── settings.json

Agent 编排

写完代码后，以下 agent 会自动调用，无需手动触发：

| 触发条件 | Agent | 说明 | |---------|-------|------| | 写完/修改任何代码后 | code-reviewer | 代码质量 + 安全审查，覆盖 OWASP Top 10 | | 复杂功能实现前 | planner | 多文件变更、架构决策 |

更新

重新执行安装命令即可全量更新到最新版本：

npx --yes sdad-agentpm@latest init

开发与发布

本包有两条发布通道，互相独立：

| 通道 | 发布内容 | 用户获取方式 | |------|---------|-------------| | npm publish | CLI 工具（bin/、src/、scripts/） | npx sdad-agentpm init | | pack.js → 后端 | 技能/规则/知识库（content/、templates/） | CLI init 时从后端下载 |

打包内容到后端

修改了 content/ 或 templates/ 下的技能、规则、知识库后：

cd packages/agentpm
node scripts/pack.js --dest "/Users/mac/Desktop/web/proto-mart-main 2/ProtoMart-server/public/agentpm"

输出 agentpm-package.tar.gz + version.json 到指定目录，重启后端服务后生效。

发布 CLI 到 npm

修改了 bin/ 或 src/ 下的 CLI 逻辑后：

cd packages/agentpm
npm version patch   # 或 minor / major
npm publish

注意事项

• package.json 的 files 字段只包含 CLI 代码，不包含 content/ 和 templates/，两者分开分发
• version.json 中的版本号取自 package.json，用于客户端检测是否需要更新
• 打包前记得先更新 package.json 中的 version，保持两条通道版本一致

License

MIT © agentPM