用途:自动化处理 GitHub Pull Request 的评审评论,把「修复评论、回应反馈、解决讨论线程」这类重复工作串成一条流水线,适合需要批量清理 PR 评审意见的开发场景。
前提:需已安装并认证 GitHub CLI,先运行 gh auth status 验证;若失败,应停止并提示用户执行 gh auth login。
主要步骤:1)确定目标 PR,支持 PR 编号、分支名或 URL,分支名可用 gh pr list --head <branch-name> --state open --json number --jq '.[0].number' 查编号,再用 gh pr checkout <pr-number> 检出分支。2)通过 gh api graphql 查询 reviewThreads,过滤 isResolved 为 false 的线程,评论含线程 ID、文件路径、行号和正文;owner/repo 可用 gh repo view --json owner,name --jq '"(.owner.login) (.name)"' 获取。3)对评论分类:可执行修复、问题/讨论、细微/风格、赞扬/认可。只修复可执行与风格类;讨论类起草回复但不猜测改代码;赞扬类跳过且不解决线程。4)逐条修复:读取文件,按评论上下文而非行号定位(行号可能已偏移);做最小改动;若文件已删除则回复说明并跳过;每次编辑后运行项目构建或 lint 校验,且只针对当前分支工作区校验。提交按逻辑分组,使用 fix(review): <摘要> 格式,正文列出对应线程。5)用 addPullRequestReviewThreadReply 回复、resolvePullRequestReviewThread 解决线程;讨论类线程只草拟回复、不解决。6)git push;若被拒绝先 git pull --rebase origin <branch-name>,出现冲突即停止,不要自动解决合并冲突。
完成后需总结:已修复并解决、已回复但保留开放、已跳过的线程数量及提交 SHA,对不确定或有歧义的修复要明确标注。
错误处理:gh 缺失或未认证立即停止;分支无开放 PR 则提示可能已关闭或合并;评论指向已删除文件时回复说明并跳过、不解决;修复后构建失败则回滚该提交并记录;遇 API 限流则退避重试,持续失败则批量回复并告知用户。
限制:依赖 GitHub CLI 与 GraphQL API;不处理合并冲突;不做超出评审建议范围的改动;资料未提供支持的平台范围、收费与价格信息。