用途:当用户要求审查某个 GitHub PR、在本地检出 PR 分支或根据 PR 链接准备审查时使用。需提供 PR 引用:GitHub URL、<base-owner>/<base-repo>#<number> 简写,或当前检出属于目标仓库时仅提供 PR 编号;缺失或有歧义时应先索取,再改动 Git 状态。
主要能力:用 gh pr view 收集 PR 元数据(head 分支、head 仓库与所有者、base 分支、关联 issue 等);通过捆绑脚本 bash .agents/skills/review-pr/scripts/prepare-pr-branch.sh <pr-ref> 准备分支,脚本仅在该远程缺失时添加贡献者 remote,抓取 PR head 分支,创建或切换到与 PR head 完全同名的本地分支并设置上游跟踪;本地分支已存在时使用仅快进集成。脚本不可用时才回退到手动命令。
审查方式:先读 PR 与关联 issue 的正文和评论,再以三点 diff 对比 base 分支,阅读相关源码、测试、配置与文档;关注是否真正解决所述问题、回归与边界情况、并发、持久化、本地化、平台版本、公开契约与默认值、测试充分性、项目风格一致性及无关改动。可用 gh pr checks 查看校验状态,并运行 git diff --check 等轻量检查;除非用户明确要求,不运行 xcodebuild。
硬性规则:本地分支名必须与 PR head 分支名完全一致;贡献者远程名必须与 PR head 仓库所有者登录名一致;不得覆盖、删除、重命名、rebase、reset 或强制更新已有本地分支;准备与审查期间不得 push;工作区有未提交改动时先停止询问;同名远程已存在但指向不同仓库时停止询问;不得仅凭 PR 描述审查。输出采用固定结构:PR Context(Purpose and Scope、Key Changes、Review Focus)、Findings、Open Questions、Verification、Summary,等级为 P0 至 P3,优先报告 bug 与回归并给出文件与行号。最终审查使用用户首选系统语言。限制:需要 GitHub CLI 与相应仓库访问权限,未提供具体安装或收费信息。