PR-Agent：AI代码审查工具

PR-Agent 是一个开源的 AI 代码审查工具。在 GitHub、GitLab、Bitbucket 或 Azure DevOps 的 Pull Request 评论区输入 /review、/describe 或 /improve，它会分别给出审查结论、PR 描述和代码改进建议。这个项目最早由 Qodo 开源，仓库 2023 年 7 月创建；README 现在写明，Qodo 已把它捐给开源社区，项目位于 The-PR-Agent 组织下，并且「不是 Qodo 面向开源项目的免费服务」。截至 2026-10-20，仓库有 13,480 颗星，许可证为 MIT，最新发布是 v0.48.0（2026-10-16）。

PR-Agent 在 PR 中执行 /review 后的审查表，列出预计审阅工作量、可能的问题与安全隐患

上面是 README 里 /review 的输出示例：审查表先给出预计审阅工作量（1 到 5 分），再说明改动是否带相关测试、有没有可能的问题、有没有安全隐患。

核心功能

PR 评论就是入口：配置完成后，在评论区输入 /review 生成审查表，/describe 写出 PR 描述和逐文件的改动清单，/improve 给出代码建议，/ask "……" 可以就这次改动提问。README 的示例里还有在 Issue 上运行的 /similar_issue，用来查找仓库里的相似 Issue。
覆盖多个代码托管平台：README 列出的平台有 GitHub、GitLab、Bitbucket、Azure DevOps 和 Gitea，每个平台都有单独的安装文档，团队不必为了 AI 审查迁移代码仓库。
模型可以自己选：README 列出的模型有 OpenAI GPT、Anthropic Claude、Google Gemini、DeepSeek 和 Mistral，还能通过 LiteLLM 接入 Azure OpenAI、AWS Bedrock、Vertex AI、OpenRouter 和 Ollama 等服务。
命令行也能用：pip install "pr-agent[github]" 安装后，可以对单个 PR 链接运行 review，不必先接入 CI。
建议按类别分组：README 里 /improve 的示例把建议分成增强、可维护性、安全和最佳实践四类。其中一条安全建议是转义 emphasize_header 里的 HTML 特殊字符，防止 XSS 攻击。
行为可以配置：审查类别和工具行为通过配置文件调整，README 指向的文件是 configuration.toml。

典型使用场景

没有专职 reviewer 的小团队：PR 一开就先跑 /review，人工先看机器标出的可能问题，再决定细读哪些文件。
PR 描述经常是空的团队：用 /describe 先生成一份初稿，作者只需要补充背景和原因。
在 GitLab、Bitbucket 或 Azure DevOps 上协作的团队：不用换平台，装上对应平台的集成即可。
想用本地模型的团队：接入 Ollama 之后，代码差异是否离开自己的基础设施，取决于你选择的模型服务，需要自己核实。

快速上手

README 推荐的方式是 GitHub Action，把下面的文件放进仓库的 .github/workflows/pr-agent.yml：

name: PR Agent
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  pr_agent_job:
    runs-on: ubuntu-latest
    steps:
      - name: PR Agent action step
        uses: the-pr-agent/pr-agent@main
        env:
          OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

这段配置从仓库 secret 读取 OPENAI_KEY，所以要先在仓库设置里添加这个 secret。示例写的是 @main，如果希望版本固定，可以改成具体的发布标签，当前最新是 v0.48.0。

想在本地试一下，可以用命令行：

pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url https://github.com/owner/repo/pull/123 review

README 也把 Docker 列为部署方式之一。要注意镜像的命名空间：0.34.2 及以后的版本发布在 pragent/pr-agent；v0.31 及更早的版本仍在旧的 codiumai/pr-agent，那个命名空间已经冻结，不再推送新镜像。升级时要把 image: 或 docker pull 里的地址一起更新。

小结

适合已经在 GitHub、GitLab、Bitbucket、Azure DevOps 或 Gitea 上协作、想给每个 PR 加一道 AI 审查、并且愿意自己承担模型 API 费用（或接入本地模型）的团队。不适合想要厂商托管、出了问题有人兜底的人。这是社区维护的项目，README 明确说明它不是 Qodo 面向开源项目的免费服务，那是另一个产品。

有几件事要先知道。第一，代码差异会发给你配置的模型服务。README 的「数据隐私」一节写明，自托管时，数据处理发生在你和模型提供方之间。第二，README 说明 /help_docs 自 v0.36.1 起暂停，原因是一个与凭据泄露有关的安全问题（issue #2445）。这个 issue 在 2026 年 6 月 19 日关闭了，但 README 目前仍保留这段暂停说明，我们没有核实该命令是否已经恢复。第三，我们只核对了文档和截图，没有在真实的 PR 上运行过 Action 或 Docker 镜像。代码几乎全部是 Python，许可证为 MIT，仓库在 2026-10-20 仍有推送。

独立分析机构 Futurum Group 在 2026 年 4 月也发表过一篇文章，标题是「Qodo Hands PR-Agent to the Community」，内容与这次捐赠相关。想了解 AI 审查在 Claude Code 工作流里的位置，可以读 Claude Code 官方最佳实践拆解。其中的 Writer/Reviewer 模式（一个会话写代码，另一个用新的上下文评审）和这里的思路一致。

PR-Agent：开源 AI 代码审查，Qodo 已捐给社区

项目资料

核心功能

典型使用场景

快速上手

小结