用途:当用户需要仓库级别的 PR 趋势报告时使用该技能,生成按周和按月的汇总表格。
主要能力:报告包含创建 PR 数、合并 PR 数、平均合并天数(Avg Days)和变更行数(Lines Δ)。脚本会输出周汇总表、月汇总表,以及一段说明所用数据来源的简短备注。
使用方式:在目标仓库中运行捆绑脚本: node .agents/skills/pr-trends/scripts/report-pr-trends.mjs
可用选项: node .agents/skills/pr-trends/scripts/report-pr-trends.mjs --repo /path/to/repo node .agents/skills/pr-trends/scripts/report-pr-trends.mjs --mode gh node .agents/skills/pr-trends/scripts/report-pr-trends.mjs --mode git
数据来源选择:--mode auto 先尝试 gh pr list 获取精确的 PR createdAt、mergedAt 和行数,若 gh 不可用或离线则回退到 git;--mode gh 要求使用 GitHub CLI 数据,适合需要精确 PR 创建趋势和准确合并天数的场景;--mode git 仅使用本地主线历史,可得到可靠的合并数与合并变更行数,但无法还原精确的 PR 创建时间戳或已关闭未合并的 PR。
结果解读:有 GitHub 元数据时,Created 按 PR 创建时间分组;Merged、Avg Days 和 Lines Δ 按合并时间分组。在 git 回退模式下,Created 和 Avg Days 显示为 -,因为本地 git 历史不保留完整的 PR 生命周期元数据。
限制与注意:除非提供 --repo,否则需在仓库根目录运行;脚本读取 first-parent 历史,因此报告反映主线分支;若回退备注提到缺失 PR 编号,应视为可能已关闭、未合并或无法仅凭本地 git 还原。