用途:把 issue 视为症状数据而非工作单元,按共享的架构缺陷把积压问题聚类成少量 plan-master(主计划 issue),使“打开的 issue == 打开的计划”达到 1:1。适用于仓库有 20 个以上未关闭 issue、多为同一缺陷的不同表现,或用户要求 triage、合并、去重、按 issue 列表制定计划时;新建 bug 需判断是否属于已有计划时也可用。issue 少于约 15 个、问题确实彼此独立、或仓库无 plans/ 规范且用户不愿引入时,不建议使用。
主要能力:三种模式。一、聚类(初次缩减):完整阅读每个 issue 正文与其评论线程(reproduction 步骤、重复链接常藏在评论里),按根因而非表面聚类,为每簇建一个标题体现修复方案的主 issue,并在仓库中以 plans/0X-<slug>.md 镜像设计文档,用统一重定向注释并标记 not planned 关闭全部子 issue,目标约 100 个 issue 收敛为 4–8 个主计划。二、稳态分流:新 bug 入库时匹配已有主计划,命中则在主 issue 追加“Round N”注释、关闭子 issue;确实新颖才新建主计划。三、打包交付:一个 PR 覆盖一簇子 issue,PR 正文用 Closes #N 自动关闭,并同时把计划中的测试矩阵加入 CI。
使用方式:依赖 GitHub CLI。先确认 issue 总数(REST 的 open_issues_count 含 PR,应用 search API 取 is:issue is:open 的 total_count),再用 gh issue list --state open --limit "$total" --json number,title,body,labels,author,createdAt 读取正文;因 gh issue list --json comments 只返回计数占位符,需逐个 gh issue view <N> --json comments 抓取评论。创建主 issue 用 gh issue create --title ... --body-file plans/0X-*.md --label plan,plan-02;关闭子 issue 用 gh issue comment 与 gh issue close <CHILD> --reason "not planned";最后 gh issue list --state open 验证只剩主计划。
适用场景与限制:要求仓库有 plans/ 纪律,若不存在应先建议而非强加;统一重定向注释只适用于确为症状的 issue,真正的功能请求应保持打开或单独跟踪;主计划在全部子 issue 交付前不得关闭,否则破坏审计链;需定期做健康检查,防止主计划堆积 5 条以上 Round 注释仍无交付 PR、范围过宽、按表面聚类或 issue 与文档漂移。未提供的细节(如具体依赖版本、安装命令、收费与平台)本文不作说明。