---
title: "Agent Review"
description: "基于 Cursor 官方 Agent Review 文档解释本地变更审查、自动触发、slash command、Source Control 和 review depth。"
verifiedAt: "2026-05-09"
---

Agent Review 是 Cursor 内置的代码审查能力，用来对本地变更运行专门 review。它不是替代人工 review，而是把“AI 写完就合并”的风险降下来：先让 Cursor 找 bug、风险和不一致，再由人决定怎么处理。

> [!NOTE]
> **阅读目标**：读完本章，你应该能配置 Agent Review，知道三种触发方式，并能选择 Quick 或 Deep review depth。

## 1. 怎么配置

官方文档给出配置路径：

1. 打开 **Cursor Settings**。
2. 进入 **Agents**。
3. 找到 **Agent Review**。
4. 配置偏好。

Agent Review 也会读取仓库中的 `BUGBOT.md` rules（BugBot 规则文件，定义自动 PR review 关注点）。要配置这些 rule files，需要参考 BugBot 文档。

## 2. 三种触发方式

官方文档列出三种运行 review 的方式。

| 方式 | 行为 | 适合 |
| --- | --- | --- |
| Automatic | 开启后，每次 commit 后自动运行 Agent Review | 团队统一质量门槛 |
| Slash command | 在 agent window 输入 `/agent-review` | 手动检查当前工作 |
| Source Control tab | 从 Source Control 对本地变更和 main branch 做比较 | 审整组 local changes |

```mermaid
flowchart TD
  Changes["Local changes"] --> Trigger{"触发方式"}
  Trigger --> Auto["Automatic after commit"]
  Trigger --> Slash["/agent-review"]
  Trigger --> Source["Source Control tab"]
  Auto --> Review["Agent Review"]
  Slash --> Review
  Source --> Review
  Review --> Findings["Findings / risks / suggestions"]
  Findings --> Human["Human decides fix / ignore / test"]
```

## 3. Quick 与 Deep

官方文档列出两个 review depth。

| Depth | Speed | Cost | Best for |
| --- | --- | --- | --- |
| Quick | Fast | Low | 小 diff、格式改动、快速 sanity check |
| Deep | Slow | High | 复杂逻辑、安全敏感代码、大重构 |

选择建议：

- 文案、格式、轻微样式改动：Quick。
- 跨文件逻辑变更：Deep。
- 权限、认证、支付、数据、安全相关：Deep。
- 发布前最终检查：按风险选 Deep 或结合人工 review。

## 4. Source Control 视角很关键

官方说明 Source Control tab 的 Agent Review 会比较 all local changes against your main branch，而不是只看最近一次 edit。

这很重要。Agent 一次任务可能只改了一部分，但你本地可能还有历史未提交改动。Source Control 视角可以检查完整工作集，避免只审最近消息造成漏看。

> [!IMPORTANT]
> 提交前至少看一次 Source Control 全局 diff。Agent Review 的结果要和测试、lint、build、人工 review 一起使用。

<details>
<summary>深读：为什么 Agent Review 不能替代人工 review</summary>

Agent Review 能快速发现 bug、风险和不一致，但它不知道所有产品背景、客户承诺、团队发布窗口和业务权衡。它也可能漏掉需求层面的错误：代码没 bug，但做的不是用户真正要的东西。

因此它适合放在人工 review 前：先做机器检查，再由人判断是否采纳、是否补测试、是否调整方案、是否允许提交。
</details>

## 5. 推荐审查闭环

1. 让 Agent 完成任务或 Plan Mode 构建。
2. 看 diff。
3. 跑已有测试或构建。
4. 触发 `/agent-review` 或 Source Control Review。
5. 对关键 finding 让 Agent 最小修复。
6. 再跑测试。
7. 人工决定是否提交。

## 本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. Agent Review 有哪三种触发方式？
2. Quick 和 Deep 应该怎么选？
3. 为什么 Source Control tab 的 review 比只看最近一次 agent edit 更稳？

通过标准：你能在提交前对本地变更运行合适深度的 Agent Review，并把 finding 转成可验证修复。

## 官方来源

- [Cursor Agent Review](https://cursor.com/docs/agent/agent-review.md) —— 官方说明 setup、自动 / slash command / Source Control 三种触发方式，以及 Quick / Deep review depth。
- [Cursor BugBot](https://cursor.com/docs/bugbot.md) —— Agent Review 读取 `BUGBOT.md` rules 的关联文档。

## 接下来去哪

<Cards>
  <Card title="Terminal Tool" description="继续理解 Agent 如何运行 shell commands，以及如何控制副作用。" href="/docs/cursor/official/01-agent-workflow/16-terminal-tool" />
  <Card title="Plan Mode" description="回到计划审查，确保复杂任务先有可审方案。" href="/docs/cursor/official/01-agent-workflow/12-plan-mode" />
</Cards>
