跳到主要内容
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。
  • 规则化检查：围绕功能逻辑、安全性、性能、可维护性等维度进行结构化检查，并支持自定义审查规则。
  • 自动评论反馈：审查开始时在评论区展示“正在审查...”动态状态，完成后输出完整审查意见与建议。

1.2 仓库级配置​

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

2. 使用指南​

2.1 将 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）。

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 队友目前处于公测阶段，联系商务抢先体验。

contact_qr_code