PR Review 代码审查技能
按阶段对 Pull Request 进行系统性审查,先验证需求理解与逻辑正确性,再并行进行多维度质量检测,最后提交审查报告。
触发约束:本 skill 必须由用户明确点名 pr-review、$pr-review 或“使用 pr-review skill”才可使用。普通 PR 链接、review 下这个 PR、帮我代码审查 等请求不应自动触发本 skill。
步骤 0:拉取代码
使用以下命令无需切换分支,直接使用 PR 编号即可:
# 获取 PR 基本信息
gh pr view <number> --json number,title,body,author,state,headRefName,baseRefName,additions,deletions,files
# 获取完整 diff
gh pr diff <number>
# 查看 commit 历史
gh pr view <number> --json commits --jq '.commits[].messageHeadline'
# 检查 CI 状态
gh pr checks <number>
如需在本地运行 tsc / 单元测试,使用 git worktree 创建独立目录,不影响当前分支:
# 1. 拉取 PR 代码到临时分支
git fetch upstream pull/<number>/head:pr/<number>
# 2. 在独立目录检出(与当前工作区完全隔离)
git worktree add ~/pr-worktrees/pr-<number> pr/<number>
# 3. 进入该目录安装依赖、运行测试
cd ~/pr-worktrees/pr-<number>
pnpm install
pnpm tsc --noEmit # 类型检查
pnpm test # 单元测试
# 4. 审查完毕后清理
cd -
git worktree remove ~/pr-worktrees/pr-<number>
git branch -D pr/<number>
第一阶段:需求理解与逻辑验证
目标:理解本次 PR 的意图,并通过阅读代码来推理测试用例是否能通过。
1.1 需求总结
阅读 PR 标题、描述和 diff,用自己的语言总结:
- 本次 PR 的核心目的是什么?
- 改动了哪些关键模块?
- 对外部接口或数据结构是否有变更?
1.2 测试推理
充当测试角色,针对 PR 的核心改动,**提出 …