PR-Agent:一个从没想抢你工作的审查者

2026 年大家争论的那些 AI 编码智能体,大多想替你写代码。PR-Agent 想读代码。
它有 15,539 颗星,仓库在 The-PR-Agent/pr-agent,README 现在的开头一句,像是被一个把这段对话经历过太多次的人写的:「最初的开放源代码 PR 审查器。这个项目不是 Qodo 的免费套餐。」
这句话干了不少活。PR-Agent 最初是 Qodo 的开源审查器,后来变成每个团队悄悄装上就不再想的东西。项目此后搬到了自己的组织下,现在必须明说:自托管它,跟用某家厂商的免费方案不是一回事。说得对。这个区别要紧:一个是你跑的工具,另一个是跑你的服务。
它做的事,四条命令
整个产品就是 pull request 上的四条斜杠命令。
/describe 写 PR 描述——改了什么、为什么改、审阅的人该先看哪里。/review 做审查:可能的 bug、安全问题、缺失的测试、和文件其余部分不一致的地方。/improve 给出具体的代码改动建议。/ask 在评论区回答关于 diff 的问题,以 diff 为上下文。
每一条都是一次 LLM 调用。README 说大约三十秒、成本很低,这个设计约束塑造了其他一切。没有智能体循环,没有工具调用树,没有多步计划。一个提示,一个回复,一条评论。
这听起来不够猛,直到你想起它替代的是什么:一个审阅者在下午六点打开一个 1,400 行的 PR,然后扫一眼。
安装
三条路,按你需要操心的程度排。
GitHub Action 就是一个 workflow 文件。把它放进 .github/workflows/pr-agent.yml:
on: pull_request: types: [opened, synchronize]
uses: the-pr-agent/pr-agent@main
env: OPENAI_KEY, GITHUB_TOKEN
这就是全部配置。每个新 PR、每次往已有 PR 推送,都会自动被审。如果密钥已经配好,从决定试用起二十分钟。
CLI 用来在本地跑,审一个不是你写的 PR:
pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url <url> review
按你用的平台装对应的 provider 附加包,想要全部集成就装 pr-agent[all]。
Webhook 和自托管是给需要审查在自己网络里完成的团队。有 Docker 镜像。GitLab 走 webhook,Bitbucket 装应用,Azure DevOps 有自己的一套。Gitea 也支持。

让它能用的两个工程决定
PR 压缩。只在小 diff 上能用的审查器是个 demo。PR-Agent 对大 PR 有压缩策略——它不是简单截断,而是决定保留什么,让模型仍然看得到这次改动的形状。这是代码库里最不体面也最重要的部分,因为替代方案是一个在教程里管用、在真实仓库上趴下的工具。
提示词配置即数据。审查类别、语气、你想让它标出的东西和想让它忽略的东西,放在一个 TOML 配置文件里,而不是 Python 里。你可以加一个类别——「检查每个新增的数据库列都有迁移」——不用碰代码。采用这套的团队,最后多半会有一份编码了自己审查文化的配置,这就是通用 linter 和一个资深工程师真会批准的方案之间的区别。
模型选择通过 LiteLLM 开放:OpenAI、Claude、Gemini、DeepSeek、Mistral,还有 Azure OpenAI、Bedrock、Vertex、Databricks、OpenRouter 和 Ollama。如果你为了保密跑本地模型,这是少数会跟你走的审查器。
一条有用的审查评论长什么样
一个帮上忙的审查机器人和一个被静音的,差别不在准确率。差别在评论够不够具体,能不能照着做。
「这里考虑加一下错误处理」比什么都不说更糟,因为它让读者觉得自己被监督了,却没得到任何信息。「这个调用在缓存未命中时可能返回 null;往下三行的调用方没做检查就解引用了」就有用,哪怕机器人只有 70% 的时候是对的,因为核一遍只要十秒。
配置文件就是把你从第一种评论带到第二种的东西。把类别对准真正咬你代码库的地方:迁移覆盖、重试语义、新端点的权限检查、新环境变量有没有写文档。一个只懂「代码质量」的审查器会产出关于代码质量的评论,而这正是下午六点没人需要的东西。
还有一个二阶效应,值得提前计划。一旦机器人每条 PR 都发言,人就会审得更松,因为已经有东西看过了。这跟一个因为风格问题让构建失败的 linter 是同一种动力学:它训练人不再看风格。把机器人用在机械检查上,并且明确说出来,这样人的注意力才会去机器人够不到的地方——这个改动是不是个好主意。
README 里一个诚实的缺陷
/help_docs 从 v0.36.1 起被禁用,等一个凭证泄露问题的修复,编号 #2445。这条说明就写在功能那一节里,没有埋进 changelog。
我喜欢它是可见的。一个审查机器人对你的源码有读权限。一个读你源码的工具出了凭证泄露的 bug,这种事你希望被大声说出来,维护者这么做了,而不是悄悄删掉命令、指望没人发现。
它也提醒你这里真实的风险面。你把一个第三方提示词、跑在第三方模型上,给了它读你的 diff 和周边文件的权限。对多数团队这是合理的交换,对有些团队不可接受。自托管那条路存在,正是为了让这个决定由你来做。
为什么它活下来了,更花哨的没活下来
2024 和 2025 年有几十家 AI 代码审查创业公司。多数死了,或者被吸收。那个从副业项目开始的开源审查器还在,还在维护,还在发配置变更。
原因很无聊:它只做一件事,而且在这件事有用的时候做。审查在 PR 打开时到达,不是在你想起要问的时候。评论出现在讨论本来就发生的地方。成本是三十秒和不到一分钱。没有要学的东西,没有要集成的东西。
跟那些想接管你整个工作流的智能体框架比一比。那些更唬人,也难维持得多。PR-Agent 只要一个 workflow 文件和一个密钥。
如果你要试
先在一个仓库上开 Action,别一次全上。用只评论、不拦截的模式跑两周。你很快会知道你的团队是读评论还是划过去,这个答案决定这个工具值不值得配。
然后把你真正在意的类别写下来,放进配置。通用的审查器给通用的意见。价值出现在机器人开始检查你团队老是忘的那三件事的时候——而那三件事是你告诉它的。
相关文章
一份社区维护的点击表,关掉了国产 Android 系统里的广告
它不动系统,不解锁,不刷机,只把厂商本来就留出来的开关一个个拨过去。代价是这份名单得一直有人续写。
GPT Image 2.6 守住 token 价格,账单却涨了
GPT Image 2.6 沿用了 2.5 的全部 token 费率,单张图却更贵,因为更多的活现在花在输出 token 上。上线十一天,定价结构说的比排行榜更多。
有人从外部重建了 IDM,并写下了自己没有碰过的部分
Mister Download Manager 用 Rust 重写了 Internet Download Manager 的下载流程,声称速度快 5 倍、支持 86 种语言。更值得细读的,是它解释如何在不复制任何代码的前提下完成重写的那一段。
Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作
Rune 能无头渲染、导出元素树并接受脚本化输入,这让编码 agent 拿到截图永远给不了的东西,一个可 diff 的信号。这个框架仍是预发布版本,不接受 pull request。