SuperAPI AI 工具集

pm-planning

智能体与模型

查看项目

更新于 10-15 17:22

技能介绍

用途:pm agent 读取架构师产出的 ARCH 文档后,产出一份面向人的 PLAN-<feature>.md,以及一系列供 senior-dev 认领的 bd create 任务。合格标准是没有上下文的新 senior-dev 能直接接手并交付,无需回来澄清。

主要拆解规则:

  1. 每个任务不超过 4 小时;过大就拆(如认证系统拆为建表迁移、注册端点加哈希、登录端点签发 JWT、登出/令牌吊销、测试);拆不动说明任务不清晰,需回到 ARCH 澄清。
  2. 每个任务只产出单一交付物:代码文件、数据库迁移、测试文件、文档更新或配置变更之一;产出多个不相关交付物则拆分。
  3. 用 --blocks-on 声明依赖,例如 bd create "Task B: signup endpoint" -p P1 --blocks-on my-proj-001-abc --label senior-dev;编排器读取 bd ready --assignee senior-dev 判断可认领任务,被未完成前驱阻塞的任务不会出现。
  4. 每个任务描述以“Done when:”清单结尾,写明完成判定(如状态码、错误码、哈希方式、测试覆盖与 npm test 通过)。
  5. 标注负责人与可并行性,可并行的任务分别打标签,不合并。

PLAN-*.md 模板包含:日期、ARCH 路径、Owner、摘要、成本估算(参考 cost-model 技能)、任务列表(优先级、工时、负责人、目标、完成标准、bd id、阻塞关系)、预演(参考 pre-mortem 技能)以及按原型与项目规模确定的门禁(gate:plan、gate:qa、gate:ship)。

使用方式与限制:pm 在 ARCH 缺少自身验收标准、未定义失败模式、或与既有 ADR 冲突时,应拒绝计划并通过 bd update 加 re-arch 标签推回架构师,计划保持阻塞直至 ARCH 完善。反模式包括:以组件而非目标命名任务、不声明依赖(同文件改动会冲突)、不做首个任务就估算全部、任务超过 8 小时。资料未提供安装方式、收费与具体平台信息。