SuperAPI AI 工具集

product-roadmap

通用与其它

查看项目

更新于 10-15 23:58

技能介绍

用途:用于每周进度检查、发布前里程碑完成度验证、季度路线图回顾,以及关闭议题后判断里程碑能否晋级。它强调“完成”比“任务做完”更严格,需跨四层真实性核查。

主要能力: 一是决策层,读取 PDR 状态(Proposed → Accepted → Completed);二是执行层,通过 MCP 或 CLI 查询 GitHub、GitLab、Jira、Linear 的实时议题状态;三是证据层,用代码与 PDR 核对(优先读取 PDR 的 ### Evidence 路径并用 test -f/-d 验证,无证据时走启发式目录检查);四是门禁层,读取里程碑 PDR 的 ### Gates 表,按 engineering、sign-off、time 三类核对。四层全绿才视为里程碑上线,否则输出 done-means 警告。

使用方式:先运行脚本加载 PDR:sh scripts/bash/setup-product-roadmap.sh [--json](PowerShell 为 scripts/powershell/setup-product-roadmap.ps1)。PDR 读取路径为 {REPO_ROOT}/docs/adlc/memory/pdr/PDR-.md(兼容旧路径 .adlc/memory/pdr)及草稿 {REPO_ROOT}/.adlc/drafts/pdr/PDR-.md。含 Category: Milestone 的 PDR 定义路线图结构。随后从 PDR 的 ### Issues 提取完整 URL,按主机识别跟踪器并查询状态;MCP 优先,不可用时回退 gh、glab、jira、linear 命令行,均不可用则标记 state unknown 并继续其余层。若里程碑带 ### Tracker Milestone URL,可直接拉取原生进度汇总。最后生成四层进度报告,含各里程碑汇总表与 done-means 警告。加 --update 时才会写入状态更新,否则不改任何文件;更新前会因未完成议题、缺失证据或未通过门禁而阻断,除非明确 force。

适用场景:团队有 PDR 体系、且需要诚实评估里程碑是否真正上线时。

限制:无 PDR 时不应使用(应先用 /product-specify 或 /product-init);不负责创建 PDR;深度代码再发现由 init 负责,本技能只做轻量核查并交接;无 ### Gates 的旧 PDR 门禁层标为“no gates declared”,无 ### Issues 则执行层标为“no tracker linkage”。配置项包括 PDR_DRAFTS_DIR、PDR_MEMORY_DIR、PRD_FILE,以及自动检测的 MCP 服务与 CLI 工具。