gitlink-cli/doc/changes/workflow-review-queue-delta.md

2.1 KiB
Raw Blame History

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_atupdated_atage_hourswaiting_hoursstalereview_statereviewerswaiting_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 通过。