用途:对指定 Pull Request 进行系统性代码审查,覆盖需求理解、逻辑验证、质量检查、测试覆盖与回归风险,并输出分级报告和行级评论。
触发约束:必须由用户明确点名 pr-review、$pr-review 或“使用 pr-review skill”才可使用;传入普通 PR 链接、要求 review 或代码审查不应自动触发。
主要能力:
- 阶段 0:用 gh pr view / gh pr diff / gh pr view --json commits / gh pr checks 拉取 PR 信息、diff、提交历史与 CI 状态;如需本地运行 tsc 或单元测试,用 git worktree 在独立目录检出,避免影响当前分支,命令为 git fetch upstream pull/<number>/head:pr/<number>、git worktree add ~/pr-worktrees/pr-<number> pr/<number>,随后 pnpm install、pnpm tsc --noEmit、pnpm test,结束后 git worktree remove 并 git branch -D pr/<number>。
- 第一阶段:总结需求,提出 3~5 个关键测例并推理验证正常、边界、异常路径;存在严重歧义或核心逻辑错误时跳过后续阶段,直接提交评论并标明阻塞原因。
- 第二至第六阶段可并行:后端质量(packages/service/、projects/app/src/pages/api/、projects/app/src/service/)、前端质量(projects/app/src/、packages/web/)、代码风格(含 i18n 静态 key 规范:禁止动态或表达式 key,如 t(
ns:key_${value})、t(prefix + value)、t(variableKey) 等)、测试覆盖、回归风险(接口、数据库、依赖、配置兼容性)。 - 最终汇总问题并按 🔴 严重、🟡 建议、🟢 可选分级;GitHub CLI 不支持行级评论,需通过 GitHub API 提交,使用 gh api repos/$REPO/pulls/<number>/reviews --method POST --input /tmp/review-data.json;也可用 gh pr review 命令请求修改、批准或仅评论。
适用场景:需要对指定 PR 做结构化审查并产出报告和行级反馈的开发者或评审人。
限制:仅限明确点名时触发;部分检查项(API 路由、前端组件、数据库、包结构、日志、Service 解耦、语法风格等)仅列出清单,具体规则未在资料中展开;行级评论依赖 GitHub API 和对应权限。