PR合并慢，别再只看平均时长：GitHub把等待拆成了三段

一个 PR 花两天才合并，问题可能是没人点开，也可能是修改来回拉扯，或批准后一直搁置。只看总时长会把三种病混成一个数。GitHub 新增的分段指标，让团队能用中位数和 P90 判断该加审查人、缩小 PR，还是改自动合并规则。

这次API增加了什么

GitHub 9 月 25 日宣布，企业和组织的仓库级 Copilot 使用报告新增 pull_request_review_times 数组。每个条目把 PR 生命周期拆成三段：从 ready for review 到第一次审查、第一次到最后一次审查、最后一次审查到合并；每段都提供中位数和第 90 百分位（P90），单位为分钟。

口径非常关键。当前只统计由人创建、且至少被另一名人类审查后合并的 PR；Copilot、其他机器人和作者自己的审查不计入。数据按合并日归属，9 月 21 日之前进入 ready 状态的 PR 不纳入该分段，而且没有历史回填。安静的一天返回空数组 []，不是零。

为什么一定要同时看P50和P90

中位数 P50 代表典型 PR，P90 代表最慢的那一成。若 P50 很短、P90 很长，说明大多数流程没问题，但某些仓库、时区或高风险改动缺少兜底；若两者都长，才更像系统性产能不足。

我的核心判断是：这些指标是排队系统的症状，不是开发者绩效分。拿 P90 给个人排名，会鼓励快速点“批准”、拆成没有意义的小 PR，甚至绕过审查。正确用法是按仓库和变更类型找瓶颈，再验证干预是否降低尾部等待。

最小实践：下载并读取日报

官方接口先返回短时有效的 NDJSON 下载链接，再从报告行里读取数组。下面脚本使用当前文档要求的 2026-03-10 API 版本，密钥只从环境变量读取。

async function main() {
  const token = process.env.GITHUB_TOKEN;
  const org = process.env.GITHUB_ORG;
  const day = process.argv[2] ?? "2026-09-26";
  if (!token || !org) throw new Error("缺少GITHUB_TOKEN或GITHUB_ORG");

  const headers = {
    Accept: "application/vnd.github+json",
    Authorization: `Bearer ${token}`,
    "X-GitHub-Api-Version": "2026-03-10",
  };

  const metaUrl = `https://api.github.com/orgs/${org}/copilot/metrics/` +
    `reports/organization-1-day?day=${day}`;
  const meta = await fetch(metaUrl, { headers });
  if (!meta.ok) throw new Error(`GitHub API ${meta.status}`);

  const { download_links: links = [] } = await meta.json();
  for (const link of links) {
    const text = await (await fetch(link)).text();
    for (const line of text.trim().split("\n").filter(Boolean)) {
      const row = JSON.parse(line);
      for (const item of row.pull_request_review_times ?? []) {
        console.log(JSON.stringify({
          repo: row.repository_name, merged: item.total_merged,
          firstReviewP90: item.p90_minutes_ready_to_first_review,
          reworkP90: item.p90_minutes_first_to_final_review,
          mergeP90: item.p90_minutes_final_review_to_merge,
        }));
      }
    }
  }
}
main().catch((error) => { console.error(error); process.exitCode = 1; });

运行环境需 Node.js 18 以上：GITHUB_TOKEN=... GITHUB_ORG=... node pr-metrics.mjs 2026-09-26。令牌需要组织 Copilot metrics 只读权限，且组织必须启用相应策略。本次无目标组织权限和真实令牌，示例未在本次任务中实际运行；已使用 Node.js 26.7 做静态语法检查。