用途 该技能用于把一个尚不可合并的 GitHub PR 收敛到可合并状态:先清除与基分支的合并冲突,再解决可执行的评审反馈,并持续迭代修复 CI 失败,直到可合并性、评审线程和必需检查全部收敛。
主要能力 以 gh pr checks 作为检查状态的唯一依据(它包含所有附着在 PR 上的检查,而 gh run list 只覆盖 GitHub Actions)。流程为:解析 PR 与基分支并先查看 mergeable;UNKNOWN 时等待 GitHub 计算后重新查询;CONFLICTING 或 mergeStateStatus: DIRTY 视为阻塞性冲突。冲突时拉取并合并最新基分支到本地,合并中断出现未解决路径时调用 j5ik2o-gh-pr-resolve-conflicts 技能(Codex 用 $j5ik2o-gh-pr-resolve-conflicts,Claude Code 用 /j5ik2o-gh-pr-resolve-conflicts)解决冲突、验证构建与相关测试并暂存文件,该技能不得 commit、push 或 tag。之后检查暂存结果,仅在请求授权远程写入时才提交并推送,推送后回到第一步直到不再冲突。接着调用 j5ik2o-gh-pr-review-follow-up 技能检查未解决评审线程,实施所有无歧义的可执行修复,取得该技能要求的批准后再回复或解决线程,授权后验证、提交并推送。
CI 处理 等待前先查看完整检查集。任一检查失败时不等待其他挂起检查,立即诊断并做最小范围修复,只跑避免明显无效提交所需的快速检查,不等待完整本地构建或测试套件,立即提交推送以尽快重启 CI。每次推送后立即以非阻塞方式启动相关本地构建与测试,同时继续查看 CI,不等待本地验证;本地验证失败时随时诊断修复并再次推送。每次推送后回到第一步,仅当无 CI 或本地验证失败且至少一个检查挂起时,用 gh pr checks --watch --fail-fast 观察。
常用命令 gh pr view --json number,url,headRefName,baseRefName,mergeable,mergeStateStatus;git fetch origin <base-branch>;git merge origin/<base-branch>;gh pr checks --json name,bucket,state,workflow,link;gh pr checks --watch --fail-fast;gh run view <run-id> --log-failed。
限制与护栏 以 j5ik2o-gh-pr-review-follow-up 作为评审线程可执行性与解决状态的唯一依据,不用扁平评论推断线程状态。基分支冲突未解决前不查看评审反馈、不等待 CI。保持冲突解决技能的 no-commit、no-push、no-tag 护栏。首次远程变更前,若请求未授权评论回复、线程解决、提交和推送,需取得明确批准。已可见失败时绝不等待挂起 CI。不把完整本地构建或测试套件作为已知 CI 失败的前置门槛。每次推送后重新执行 gh pr checks --json,因为检查集可能变化。不使用 --no-verify 绕过钩子。失败与 PR 无关且基分支已修复时,合并最新基分支而非塞入无关修复;失败为抖动时重试一次并报告证据。基分支冲突未解决、可执行评审线程未解决、必需检查挂起或失败时,不得报告完成。输出合并冲突状态与解决摘要、已处理/跳过/剩余评审线程、当前 CI 状态、失败摘要与已应用修复、执行的提交与推送,以及评审线程解决且检查全绿后的 PR URL。其他安装与配置细节暂未提供。