SuperAPI AI 工具集

merge-queue

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:帮助在 GitHub 合并队列(merge queue)与分支保护场景下判断和处理 PR 合并问题,并区分普通绿色检查与队列检查的差异。

主要能力:解释严格状态检查(Require branches to be up to date before merging)的意义;说明合并队列会基于队列前方内容构建推测性合并并对其运行检查,仅通过才合并;梳理 mergeable_state 各值含义,包括 clean、blocked、behind、dirty、unstable、draft、has_hooks,并指出 unstable 仅表示可合并而非没问题;列出关键保护设置及理由,如必需状态检查、推送时撤销旧批准、要求会话解决、限制强推与删除、enforce_admins、要求线性历史,并指出 enforce_admins: false 是常见隐形缺口。

使用方式:在队列仓库中优先使用 enable_pr_auto_merge,而非直接合并,让队列掌控顺序;诊断被阻塞的合并时按顺序检查:当前 head sha 上是否有必需检查失败、必需检查是否缺失(如工作流中改名导致永不报告)、评审人数或 CHANGES_REQUESTED、未解决会话、严格检查下 head 是否落后、是否存在冲突、是否为草稿,命中即停止。

限制与注意:PR 自身绿色检查不等于队列检查,队列会针对推测性合并重跑;PR 可能因推测性合并失败被弹出队列,即使自身未变,冲突来自前方已合入内容;同一检查连续两次被弹出说明是真实交互问题,应拉出 PR 排查而非第三次重排。不要用红色必需检查合并、不要用管理员绕过、不要在未分类原因时重跑检查。可参见 stacked-prs 与 github-orchestration。