GitHub PR Manager — GitHub 审查员（PR 审查员）

GitHub PR Manager 概述 简化 GitHub Pull Request 工作流：创建、审查、合并、生成变更日志、CI 检查和草稿管理，通过 gh CLI 实现。 当 Codex 需要管理 PR 生命周期、检查审查状态、处理合并冲突或生成变更日志时使用。

快速开始 前提条件 gh CLI 已安装并认证（gh auth status） Git 仓库具有 GitHub 远程仓库 检查 PR 概述 bash scripts/gh-pr-review.sh --mine 创建带有自动生成内容的 PR python3 scripts/gh-pr-create.py --draft --label review-needed 从合并的 PR 中生成变更日志 python3 scripts/gh-pr-changelog.py --from v1.0 --to v2.0

常见任务 创建和管理 PR # 创建草稿 PR gh pr create --draft --title "WIP: Add login" --body "In progress" # 创建带有标签的 PR gh pr create --label enhancement --label needs-review # 查看 PR 详情 gh pr view # 在终端查看 gh pr view --web # 打开在浏览器 # 更新 PR gh pr edit --title "New title" --add-label ready

审查工作流 # 检查需要我的审查 gh pr list --search "review-required:@me" --state open # 批准 gh pr review --approve --body "LGTM" # 请求更改 gh pr review --request-changes --body "Please fix the tests" # 添加评论 gh pr review --comment --body "Nice work!" # 检查 PR 的审查状态 gh pr view --json reviewDecision,reviews

CI 和合并 # 检查 CI 状态 gh pr checks # 详细状态 gh pr view --json statusCheckRollup # 当检查通过时合并 gh pr merge --squash # 合并和压缩 gh pr merge --rebase # 合并和变基 gh pr merge --merge # 合并提交 gh pr merge --auto # 自动合并检查通过 # 检查可合并性 gh pr view --json mergeable,mergeStateStatus

冲突解决 # 检查 PR 是否有冲突 gh pr view 42 --json mergeable # → "CONFLICTING" 如果有冲突 # 本地解决 git checkout git fetch origin git merge origin/main # 解决冲突 git push # 或者：代替变基 git rebase origin/main # 解决冲突 git push --force-with-lease

分支操作 # 检查 PR 以进行本地测试 gh pr checkout # 列出带有 PR 状态的分支 gh pr list --author "@me" --json headRefName,title,state,isDraft # 比较分支 gh pr diff # 查看差异 gh pr diff --name-only # 只显示文件名

参考 scripts/gh-pr-create.py — 创建带有自动生成标题/正文的 PR scripts/gh-pr-review.sh — 审查和 CI 状态概述 scripts/gh-pr-changelog.py — 从合并的 PR 中生成变更日志 请参阅 references/pr-templates.md 以获取 PR 模板示例 请参阅 references/label-conventions.md 以获取标签约定