2.1 KiB
2.1 KiB
PR 审查队列快照差异
变更说明
恢复并完善现有 workflow +review-queue 工作流注册,新增 --previous 队列快照比较能力。维护者可以保存一次 JSON 输出,在下一次扫描时只查看新增、已解决、优先级变化、风险变化和未变化数量,不必重新阅读整个队列。
这是为已经合并的维护类 Skill 提供的第二条前置基础能力:维护者雷达可以把变化项直接变成今日待办,PR 拓扑分析可以识别队列变化后仍然存在的关系热点,代码审查和集成 Skill 仍然保留各自的代码与合并判断职责。本 PR 不把队列排序算法升级为任何一个 Skill 的替代品。
使用方式
先生成基线快照:
gitlink-cli workflow +review-queue \
--owner Gitlink --repo gitlink-cli --format json > queue-previous.json
再次扫描并比较:
gitlink-cli workflow +review-queue \
--owner Gitlink --repo gitlink-cli \
--previous queue-previous.json --format markdown
changes 中的条目按 PR 编号匹配;没有编号的本地输入才回退到规范化标题。比较只读本地快照,不会写入远程仓库。
等待效率信号
队列结果现在同时记录 created_at、updated_at、age_hours、waiting_hours、stale、review_state、reviewers 和 waiting_on。通过 --as-of 可固定计算时刻,通过 --stale-after-hours 可按仓库 SLA 调整阈值;默认阈值为 72 小时。waiting_on 只根据明确的 review 状态推断作者、reviewer 或维护者,不会把未知状态伪装成责任归属。等待达到阈值的条目会增加队列优先级,并在 Markdown 中单独显示 SLA 摘要。
兼容性与验证
- 不传
--previous时原有输出和优先级排序保持不变。 changes是可选 JSON 字段,旧消费者可以忽略。- 非法快照会给出明确错误,不会静默生成不完整差异。
go test ./shortcuts/workflow -run 'TestAnalyzeReviewQueue|TestCompareReviewQueue|TestReadReviewQueue|TestFetchReviewQueue|TestRenderReviewQueue' -count=1通过。go build ./...和git diff --check通过。