什么是pr-reviewer
pr-reviewer 是一个面向 GitHub 拉取请求的自动化代码审查脚本，重点不是替代人工判断，而是先把容易遗漏、又适合规则化检查的问题提前筛出来。它会围绕 PR 的代码差异做分析，关注安全隐患、错误处理缺口、风格问题以及测试覆盖是否跟上改动，让维护者在真正开始 review 前，就先获得一份结构化的审查结果。对于仓库里 PR 较多、审查节奏快的团队，这类工具的价值在于把重复性高的初筛工作自动化。
从使用方式看，它依赖 GitHub CLI 与仓库访问权限，可检查当前仓库全部未关闭的 PR，也能单独针对某一个 PR 复查，还支持把结果直接作为 GitHub 评论发回去。脚本本身会记录每个 PR 已审查过的 HEAD SHA，因此当 PR 没有新提交时，不会重复跑一遍相同检查；只有在出现新提交后才会触发重新审查。如果需要强制复查，也可以直接指定 PR 编号执行。
它输出的并不是一句简单的“通过”或“不通过”，而是会生成 Markdown 报告，内容包括 PR 基本信息、提交列表、变更文件的语言或类型归类、自动发现的问题、测试覆盖分析，以及在本地仓库存在时可附带的 lint 结果。最后还会给出一个概括性的结论，例如安全风险、需要重点关注、仅有轻微提示，或整体看起来正常。这样的结构比较适合代码所有者、值班 reviewer 或技术负责人快速判断优先级。
核心功能特点
- 基于 PR diff 自动检查安全问题、错误处理缺口、风险调用、风格异常、TODO 标记和测试改动缺失
- 支持按仓库批量检查开放中的 PR，也支持按编号单独 review，并可将结果直接发布为 GitHub 评论
- 内置智能复查机制，按 PR 的 HEAD SHA 跟踪状态，仅在出现新提交时重新审查，减少重复扫描
- 审查结果会落盘为 Markdown 报告，包含提交信息、变更文件分类、问题定位上下文、测试覆盖分析与结论摘要
- 可结合本地仓库执行额外 lint，当前明确支持通过 golangci-lint 做 Go 检查、通过 ruff 做 Python 检查
适用场景
这个工具最适合放在日常 PR 流程的前置或并行环节里使用。比如团队每天都有多条拉取请求等待合并，reviewer 不可能先逐个通读全部改动时，pr-reviewer 可以先把包含硬编码凭据、疑似密钥、未处理错误、明显危险调用等问题的 PR 标出来，让人工审查优先看高风险项。对需要值班处理合并请求的工程团队来说，这能明显缩短“先发现问题再转人工”的时间。
它也适合做周期性巡检。脚本提供了列出“尚未审查 PR”的能力，说明它可以很自然地接入 cron、heartbeat 或 CI 的定时任务中：有新 PR 或旧 PR 新增提交时自动触发检查，没有变化就不重复消耗资源。这样的设计比较适用于仓库活跃、提交频繁的项目，尤其是想建立轻量自动审查机制、但又不希望每次都全量重跑的团队。
在多语言仓库里，pr-reviewer 的定位也比较清楚：它不是完整静态分析平台，而是围绕 PR 改动做快速、实用的差异审查。比如后端 Go 服务修改后出现 `_ :=` 这类错误丢弃，Python 改动里出现裸 `except:`，或生产代码中残留 `print()`、`console.log`、超长行、TODO/FIXME/HACK 标记，这些都属于它擅长优先揭示的内容。再加上“改了源码却没改测试”的覆盖提示，适合用于帮助 reviewer 判断一个 PR 是否已经达到可深入审阅的基本质量线。