GitHub Copilot Review Loop 是一个面向 GitHub 拉取请求(PR)的自动化审查循环技能,目标是把 PR 从当前审查状态推进到一次经过验证的干净 Copilot 审查周期,并保留线程状态,要求最终审查确实针对最新 head 提交运行。
用途: 用于在 PR 上系统性地处理 GitHub Copilot 的代码审查意见,逐轮修复、推送、回复并解决线程,再请求新的 Copilot 审查,直到最新提交获得一次没有新增可操作意见的审查。
主要能力:
- 环境与状态确认:检查 gh auth status、当前分支、工作区状态以及关联的打开 PR。
- 审查状态采集:运行 scripts/review_state.py,记录 head_sha、copilot_review_count、未解决线程 ID 以及最新 Copilot 审查对应的提交。
- 意见筛选:将未解决且非过时的 Copilot 线程视为可操作,除非其属于信息性、重复、错误或与需求冲突;若用户要求处理全部,则修复所有有效线程,否则提供编号选择。
- 修复与测试:实施最小的行为保持型修复,为回归问题新增或更新行为测试;测试失败时不解决线程。
- 检查与推送:运行与改动相称的检查,检查 git diff --check,有意识地提交,推送 PR 分支且不强制推送。
- 回复与解决线程:对每个已处理线程回复修复提交与验证情况,并通过 GitHub 的 resolveReviewThread GraphQL 变更解决;不解决被拒绝或有歧义的反馈,而是加以说明。
- 再次请求审查:通过 GitHub 的 requested-reviewers API 以特殊审查者登录名 copilot-pull-request-reviewer[bot] 再次请求 Copilot 审查,记录请求时间、head SHA 和基线审查计数。
- 轮询与迭代:每次轮询不超过 60 秒且不阻塞更久;仅当 Copilot 审查计数增加且最新审查针对记录的 head SHA 时,才视为完成一轮审查周期。随后再次获取线程状态,若存在新的可操作评论则重复流程。
- 干净周期门禁:完成需同时满足本地与远程分支头一致、相关检查通过、每个已处理线程已解决或明确处置、最后一次请求后有一次新的 Copilot 审查完成、该审查锚定最新 head SHA、且未产生新的可操作线程。
使用方式: 在技能目录中运行 python3 "${CODEX_HOME:-$HOME/.codex}/skills/gh-copilot-review-loop/scripts/review_state.py" 查看状态;使用 gh api --method POST "repos/{owner}/{repo}/pulls/{pr}/requested_reviewers" 并传入 reviewers 为 copilot-pull-request-reviewer[bot] 的 JSON 来请求 Copilot 审查;使用 gh api graphql 的 resolveReviewThread 变更解决已处理线程。优先使用已安装的 GitHub 连接器处理 PR 元数据、回复和常规 PR 变更,审查线程解决与线程感知状态则使用 gh api graphql。
适用场景: 适用于使用 GitHub Copilot 代码审查的 PR 维护流程,尤其是需要逐条闭环处理审查意见、保留线程状态并确认最终审查针对最新提交的场景。
限制: 不强制推送;测试失败时不解决线程;不解决被拒绝或有歧义的反馈;轮询单次不超过 60 秒;完成判定必须满足干净周期门禁的全部条件,不能仅凭旧线程已解决就宣称完成。暂未提供关于收费、价格、平台支持范围或效果保证的信息。