这是一个基于 gh CLI 的 GitHub 拉取请求(PR)管理技能,用于完成 PR 的创建、列出、查看、更新与合并等操作。
用途:在终端中管理 GitHub PR,包括从分支创建 PR、按状态/分支/标签/作者等筛选列出 PR、查看 PR 详情与变更文件、检查 CI/CD 状态与审查结果、查看评论与审查、更新 PR 分支以及使用不同策略合并 PR。
主要能力:
- 创建 PR:gh pr create --repo owner/repo-name --base main --head feature-branch --title "..." --body "...",支持标签、审查者、草稿(--draft)与模板。
- 列出 PR:gh pr list,可用 --state all/closed/merged、--base、--head、--label、--author、--assignee、--limit 过滤,支持 --json 与 --jq 输出。
- 查看详情:gh pr view 123 支持 --comments、--web、--json。
- 查看文件与 diff:gh pr diff 123 --name-only 或完整 diff。
- 检查状态:gh pr checks 123,可用 --watch 实时查看。
- 评论与审查:通过 gh pr view --comments 或 gh api 获取评论与审查。
- 更新分支:gh pr checkout 123 后 git merge/rebase 并 push,或用 gh api .../update-branch -X PUT。
- 合并:gh pr merge 123 支持 --merge、--squash、--rebase、--auto、--delete-branch。
使用方式:需先完成 gh 身份认证(gh auth status)。典型流程为创建分支并推送、执行 gh pr create、用 gh pr checks --watch 检查、用 gh pr edit --add-reviewer 添加审查者、最后 gh pr merge --squash --delete-branch。草稿 PR 可用 gh pr ready 转为就绪。
适用场景:面向使用 GitHub 的开发者与团队,在终端中完成 PR 全流程管理,适合与 issue 管理、代码审查、提交操作等技能配合使用。
限制:依赖 gh CLI 与相应仓库权限;冲突需手动解决;权限不足或 PR 已存在时需另行排查。具体安装与认证细节资料未提供。