Agent Review
基于 Cursor 官方 Agent Review 文档解释本地变更审查、自动触发、slash command、Source Control 和 review depth。
Agent Review 是 Cursor 内置的代码审查能力，用来对本地变更运行专门 review。它不是替代人工 review，而是把“AI 写完就合并”的风险降下来：先让 Cursor 找 bug、风险和不一致，再由人决定怎么处理。
阅读目标：读完本章，你应该能配置 Agent Review，知道三种触发方式，并能选择 Quick 或 Deep review depth。
1. 怎么配置
官方文档给出配置路径：
- 打开 Cursor Settings。
- 进入 Agents。
- 找到 Agent Review。
- 配置偏好。
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 |
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 视角可以检查完整工作集，避免只审最近消息造成漏看。
提交前至少看一次 Source Control 全局 diff。Agent Review 的结果要和测试、lint、build、人工 review 一起使用。
深读：为什么 Agent Review 不能替代人工 review
Agent Review 能快速发现 bug、风险和不一致，但它不知道所有产品背景、客户承诺、团队发布窗口和业务权衡。它也可能漏掉需求层面的错误：代码没 bug，但做的不是用户真正要的东西。
因此它适合放在人工 review 前：先做机器检查，再由人判断是否采纳、是否补测试、是否调整方案、是否允许提交。
5. 推荐审查闭环
- 让 Agent 完成任务或 Plan Mode 构建。
- 看 diff。
- 跑已有测试或构建。
- 触发
/agent-review或 Source Control Review。 - 对关键 finding 让 Agent 最小修复。
- 再跑测试。
- 人工决定是否提交。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Agent Review 有哪三种触发方式？
- Quick 和 Deep 应该怎么选？
- 为什么 Source Control tab 的 review 比只看最近一次 agent edit 更稳？
通过标准：你能在提交前对本地变更运行合适深度的 Agent Review，并把 finding 转成可验证修复。
官方来源
- Cursor Agent Review —— 官方说明 setup、自动 / slash command / Source Control 三种触发方式，以及 Quick / Deep review depth。
- Cursor BugBot —— Agent Review 读取
BUGBOT.mdrules 的关联文档。