Synthesis Review Triage 是一个 PR 评审分诊方法,用于决定“下一个该评审哪个 PR”。它明确不评估代码质量,代码评审与审计分别由 synthesis-pr-review 和 synthesis-code-audit 负责;分诊只做路由与排期:对队列分类、为每个条目按紧迫度打分,并把评审精力投向影响最大的位置。
用途与定位 该技能把开放的 PR 归入三类:可评审(需要你采取评审动作的工作队列)、等待作者(已请求修改或提出阻塞项、作者尚未回应)、被阻塞(受“blocked”“do not merge”等标签、依赖其他 PR 或基础设施原因搁置)。分类后对可评审队列打分并分配层级,按层级顺序处理,层级内用打分维度打破平局,优先级标签可覆盖分数。
主要能力
- 队列分类与排除:打分前先移除自建 PR、草稿、你已批准的 PR,以及你已评审且此后无新代码提交的 PR;被驳回的正面批准(含 LGTM 等信号且无阻塞)也视为已完成。
- 评审后提交分类:仅有合并类提交(多父提交或以“Merge branch”开头)标记为需人工核实的 rebase/合并,通常不需全量重审;存在实质代码提交则标记为需要增量评审并提升优先级。
- 作者响应检测:比较最近一次“请求修改”评审(或阻塞评论)与最新提交的时间。若最新提交晚于该评审,说明作者已回应,应移入可评审队列并标记“作者已推送修改,需重审”并提升优先级;若无新提交,才是真正等待作者。对含 blocker、must fix before merge、do not merge 等信号的行内评论同样适用。这一判断可避免把已回应的 PR 误留为“等待作者”,形成隐形的评审欠账。
- 打分框架:参考 references/scoring.md,维度包括评审缺口、CI 状态、时间与陈旧度、体积、标签,以及自上次评审后的更新,并给出权重与表格;强调这是框架而非固定公式,可按团队情况调整权重(例如严格评审 SLA 的团队可提高时间权重,CI 常抖动的团队可降低 CI 权重)。
- 重审门禁:对已评审过的 PR,先运行 references/prior-review-gate.md 中的三步门禁(总结上次评审、分类新活动、决定全量/增量/跳过);仅一次 rebase 很少值得全量重审。
- 分层:Critical(已有 1 个批准、CI 通过、无冲突,你的评审可解锁合并)、High(0 个评审且 CI 通过,或自上次评审后已更新)、Medium(可评审但不紧急)、Waiting on Author(已请求修改且此后无作者响应)。
使用方式 技能附带多份参考文档:references/scoring.md 用于打分或调整权重;references/prior-review-gate.md 用于重审前判断;references/background.md 说明分诊为何重要及其与 pr-review、code-audit 的分工;references/coverage-map.md 说明 1.0.0 文本各部分现所在位置。具体安装命令与调用方式暂未提供。
适用场景与限制 适用于维护 PR 评审队列、确定评审优先级、判断是否重审以及区分“已被评审”与“已被批准”的团队工作流。限制在于:它不做代码质量评估;分数只是可调框架而非公式;合并类提交的判定建议人工核实;团队显式信号(优先级标签、阻塞标签、团队约定)优先于打分结果。