用途:处理拉取请求(PR)的评审反馈。当 PR 被标记 CHANGES_REQUESTED、存在未解决的评审线程,或需要回复评审者意见时使用;若 CI 失败但没有评审意见,应改用 git-fix-pr。
主要能力:解析 owner/repo 与 PR 编号(未给编号时取当前分支 PR,否则列出可操作 PR);用捆绑脚本一次性拉取 PR 数据;将评论分类为 Blocking、Substantive、Suggestion、Question、Nitpick;对自动化评审者(如 Gemini Code Assist、Copilot)的建议先独立核实,核实不成立则回复反驳证据而不改代码;对超出范围的反馈创建后续 issue;按逻辑分组提交并添加 Co-authored-by 署名;推送后重新请求评审;逐条回复并用 GraphQL resolveReviewThread 解决线程。
参数:$1 为 PR 编号(与 --all 互斥);--commit 处理反馈后提交;--push 提交后推送(隐含 --commit);--all 对所有可操作 PR 各派一个子代理在隔离 worktree 中处理,由编排者统一推送、回复、解决,默认隐含 --commit --push;--dry-run 仅打印派发计划;--limit N 限制并发子代理数(默认 3);--include-automation 纳入自动化作者 PR。
用法要点:解析远程 URL 得到 owner/repo;用 gh pr view --json number -q '.number' 解析 PR;用捆绑脚本 list-actionable-prs.sh 与 fetch-pr-data.sh;失败检查用 gh run view $RUN_ID --log-failed;推送用 git push origin HEAD;解决线程用 gh api graphql -f query='mutation($id:ID!){resolveReviewThread(input:{threadId:$id}){thread{isResolved}}}' -F id="$THREAD_ID";重新请求评审用 gh api -X POST /repos/<owner>/<repo>/pulls/<pr>/requested_reviewers。
限制:$1 与 --all 同时给出会报错停止;--dry-run 仅在 --all 下生效;GraphQL 遇限流需等待 60 秒重试一次;子代理返回不可解析 JSON 或分支不同步时标记为 blocked,不推送部分工作;重新请求评审遇 422 时仅记录并继续。具体收费、平台支持等信息资料未提供。