PR Reviewer 是一个面向 GitHub Pull Request 的代码审查技能,目标是让 PR 审查更系统、更专业。它围绕「先收集、再分析、后发布」的流程设计,适用于收到 PR 链接、收到「review this PR」「code review」「review pull request」「check this PR」等请求,或在合并前需要检查 PR 质量的场景。
主要能力
该技能可以自动抓取 PR 相关数据,包括元数据(标题、作者、状态、分支、标签)、diff、提交历史、评论与审查、关联的 GitHub issue,以及从内容中提取的工单编号(如 JIRA、GitHub issue)。抓取结果会按 <output-dir>/PRs/<repo-name>/<PR-NUMBER>/ 结构整理,生成 metadata.json、diff.patch、git_diff.patch、comments.json、commits.json、related_issues.json、ticket_numbers.json、SUMMARY.txt,并可选克隆源分支。
分析阶段依据 references/review_criteria.md 中的完整清单,从以下类别评估:功能(是否解决问题、有无缺陷和边界情况)、可读性(命名、DRY)、风格(是否符合 linter 与代码库约定)、性能(算法效率与可扩展性)、安全(漏洞与密钥保护)、测试(是否覆盖正常路径与边界情况)、PR 质量(范围是否聚焦、提交是否清晰、描述是否明确)。发现项会按优先级标记:Blocker(必须合并前修复)、Important(应当处理)、Nit(可选)、Suggestion(未来考虑)、Question(需要澄清)、Praise(做得好的地方)。
使用方式
典型工作流分为几步。第一步,运行 fetch_pr_data.py 抓取 PR 数据:
python scripts/fetch_pr_data.py <pr_url> [--output-dir <dir>] [--no-clone]
例如:
python scripts/fetch_pr_data.py https://github.com/facebook/react/pull/28476
第二步,阅读 SUMMARY.txt、metadata.json、diff.patch、comments.json、commits.json、related_issues.json,并依据审查清单分析。第三步,使用 generate_review_files.py 生成结构化审查文件:
python scripts/generate_review_files.py <pr_review_dir> --findings <findings_json> [--metadata <metadata_json>]
它会在 pr_review_dir/pr/ 下生成 review.md(内部详细审查)、human.md(用于发布的干净版本)、inline.md(拟发布的行内评论),并在 .claude/commands/ 下生成 /send、/send-decline、/show 三个斜杠命令,同时生成 REVIEW_READY.txt 说明后续步骤。
第四步,使用 /show 在 VS Code 中打开审查目录,检查并编辑文件。第五步,确认后发布:/send 会发布 human.md 并批准 PR;/send-decline 会发布 human.md 并要求修改。行内评论可在之后通过 add_inline_comment.py 选择性添加:
python scripts/add_inline_comment.py <owner> <repo> <pr_number> <commit_id> <file_path> <line> "<comment>" [options]
适用场景
适合需要在合并前对 GitHub PR 做质量把关的团队或个人,尤其是希望审查覆盖功能、安全、测试、可维护性等多维度,并希望将审查资料结构化保存、便于复核与编辑的场景。也适合需要为 PR 提供行内反馈、但希望先预览再发布的审查者。
限制与注意事项
该技能采用两阶段确认,在明确使用 /send 或 /send-decline 批准前,不会向 GitHub 发布任何内容。文档提到需要 GitHub CLI 与 Python 脚本运行环境,但未提供安装步骤、价格、平台支持范围或性能数据。行内评论建议先在测试 PR 上验证。大型 PR(超过 400 行)建议拆分处理。其他未在资料中说明的细节暂未提供。