跳到主要内容
gitee logo

PR 审查队友

面向仓库的 PR（Pull Request）智能辅助审查方案。在现代研发流程中，PR 审查是保障代码质量的重要环节，但往往面临信息量大、上下文复杂、人工审查耗时等痛点。PR 审查队友作为主动式 AI 数字员工，通过规则化检查与智能分析，自动发现潜在问题并生成可读的审查意见，帮助 Reviewer 快速聚焦关键风险与变更要点。

适用范围：支持个人空间、组织空间、企业空间仓库使用。

pr_review_bot_intro

核心特点：

  • 提升审查效率：自动对 PR 进行初步审查，补充人工审查不足，降低漏检概率。
  • 辅助决策判断：通过结构化分析，帮助 Reviewer 更快理解变更内容，聚焦关键问题点。
  • 能力沉淀与复用：支持多仓库配置与统一规则，逐步建立可复用的 AI 审查能力矩阵。

产品定位：作为人工审查的辅助工具，而非替代者。能够发现明显遗漏问题，但最终决策仍由人工 Reviewer 把控。

1. 核心功能介绍​

1.1 PR 审查队友​

  • 自动触发审查：在开启自动触发审查的条件下，在 PR 新建、源分支更新、或重新打开时自动审查；也可在评论中通过指令手动触发：@PR审查队友 /review。
  • 加入审查者列表：支持将 AI 队友加入 PR 审查者列表，当评审结果不存在阻断项时自动通过评审，存在阻断项时则不通过（管理员可强制通过）。
  • 反馈学习机制：支持通过回复或 @AI 队友 + 评论的方式纠正误报，AI 队友将结合反馈进行持续学习与改进，提供更有针对性的后续审查。如果想澄清后立马触发审查，可在末尾增加 /review 指令，如：@PR审查队友 不存在 SQL 注入，已采用 PreparedStatement 预编译. /review
  • 分支匹配审查：支持配置分支匹配规则，可设置仅针对特定目标分支（如 main、release 等）自动发起审查，避免不必要的审查任务。
  • 规则化检查：围绕功能逻辑、安全性、性能、可维护性等维度进行结构化检查，并支持自定义审查规则。
  • 自动评论反馈：审查开始时在评论区展示"正在审查..."动态状态，完成后输出完整审查意见与建议。

1.2 仓库级配置​

  • 粒度与规则：以仓库为粒度进行配置。每个仓库可独立设置审查规则，并支持通过 glob 规则过滤或包含某些特定文件，避免噪声。
  • 权限管理：仅仓库负责人及以上权限可添加或移出 PR 审查队友。
  • 容量限制：单个 PR 审查队友最多同时服务 5 个仓库，超出需新增队友。
  • 规则上限：单仓库最多配置 10 条审查规则。

2. 使用指南​

2.1 将 AI 队友添加到仓库​

个人/组织/企业 添加 AI 队友流程类似，前往仓库成员管理页面操作即可，此处为企业为代表，介绍添加流程

  1. 打开「代码仓库 → 成员页面」，点击【+ 添加 AI 队友】。

  2. 在弹出界面选择已有 AI 队友，或新建队友并完成基础信息设置。

    a. 如当前空间下不存在 AI 队友，则先添加 AI 队友 invite_ai_teamate

    b. 选择 PR 审查助手后点击添加（支持批量添加至仓库） create_ai_teamate

  3. 添加成功后，队友将显示在仓库成员列表中，并带有 AI队友 标签。 ai_teamates

备注：队友默认具备开发者权限，且不可更改。

2.2 配置审查规则​

默认评审规则（队友加入仓库后自动填充，可按需编辑）：

  1. 功能逻辑：代码是否按预期执行？
  2. 安全性：是否存在 SQL 注入、XSS、敏感信息泄露等风险？
  3. 性能：是否存在冗余查询、内存泄漏或明显性能瓶颈？
  4. 可维护性：命名、注释、结构是否清晰，是否便于迭代维护？

自定义规则：

  • 每个仓库最多配置 10 条规则。
  • 规则名称 ≤ 70 字，规则内容 ≤ 400 字。
  • 支持上传团队开发手册（支持上传规范手册 md、pdf、txt、html）。
  • 支持从其它仓库导入评审规则，实现相似项目之间的规则快速复用，减少重复配置。

分支匹配规则：

  • 支持配置分支匹配规则，可设置仅针对特定目标分支（如 main、release 等）自动发起审查。
  • 避免在合并到非主要分支时触发不必要的审查任务，优化审查资源使用。

pr_review_bot_config

2.3 PR 审查流程​

  1. 触发时机：

    草稿状态下不主动式触发

  • PR 新建时自动触发。
  • 源分支有新的提交更新时。
  • PR 重新打开时。
  • 在评论区手动触发：@PR审查队友 /review。
  1. 反馈方式：

PR 审查队友将在触发审查的 PR 下进行动态评论

  • 审查中：自动评论提示“正在审查...”。
  • 审查完成：输出完整 Review 意见与建议，含发现问题、影响说明与改进建议。

pr_review_workflow

review_report

3. 工作区与任务管理​

每个 PR 审查队友均有独立的工作区。在队友详情页中，可查看以下信息：

  • 队友配置全览：记录最近的 PR 审查行为与处理状态，便于溯源与复盘。

ai_teamate_overview

  • 任务规划：展示 PR 审查队友的规划任务列表及状态分布，新增了触发人、审查结果等详细字段，帮助用户更直观地了解队友的工作状态与审查进展。

tasks_overview

4. 最佳实践​

  • 与人工审查协同：将 AI 审查结果作为“预审”与“提示项”，由 Reviewer 做最终判断与合并决策。
  • 规则因地制宜：结合业务与技术栈逐步细化规则，持续沉淀审查规范。
  • 聚焦噪声治理：利用 glob 过滤与手册规范，减少自动生成文件与无关变更带来的噪声。

5. 申请使用​

空间管理员可前往 AI Teammates 页面 申请使用。

相关文档​

AI 队友介绍