AI 评审

519 字约 2 分钟

AI 代码评审可以自动检查 PR 中的潜在问题，提升代码质量。云原生构建支持以下两种方式：

对比项	AI 评审插件	NPC 事件
触发方式	PR 事件时流水线自动触发	在 PR 评论中提及 NPC 按需触发
适用场景	每次 PR 都自动评审	按需评审，灵活控制
配置方式	当前仓库 `.cnb.yml`	无需配置（自定义 NPC 在 NPC 仓库定义）

两种方式均通过 CNB_TOKEN 调用平台 API；提及自定义 NPC 时，令牌代表该 NPC 的身份。

使用 AI 评审插件

使用 cnbcool/code-review 插件，在 PR 事件触发时自动进行代码评审。该插件基于 CodeBuddy CLI，支持多种编程语言，自动过滤非代码文件，结果以评论形式提交到 PR。

配置示例

.cnb.yml
main:
  pull_request:
    - stages:
        - name: 代码评审
          image: cnbcool/code-review:latest
          settings:
            comment: true
            max_comments: 10
            fail_on_critical: false

更多参数配置请参考 cnbcool/code-review 插件详情。

通过 NPC 事件触发

在 PR 评论中提及 NPC 角色，即可触发 pull_request.comment@npc 事件执行 AI 评审。

系统 NPC：在 PR 评论中提及 @CodeBuddy：

@CodeBuddy 代码评审

自定义 NPC：先配置自定义 NPC 角色，然后在 PR 评论中提及：

@cnb/feedback(评审专家) 代码评审

配置示例

在 NPC 仓库的 .cnb.yml 中配置 pull_request.comment@npc 事件：替换上方示例中的事件键为 pull_request.comment@npc 并挂在 $ 下即可，其余 stages 部分保持一致：

.cnb.yml
$:
  pull_request.comment@npc:
    - stages:
        - name: AI 评审
          image: cnbcool/code-review:latest
          settings:
            comment: true
            max_comments: 10
            fail_on_critical: false

注意事项

两种方式都需要确保流水线有权限访问代码仓库和提交评论。
NPC 事件触发时，TOKEN 权限仅限于当前仓库。
若需在评审过程中修改代码，可开启 NPC 工作模式。