Agent Review
基於 Cursor 官方 Agent Review 文件解釋本地變更審查、自動觸發、slash command、Source Control 和 review depth。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Agent Review | 代理審查 | 審查 Agent 做的改動。 |
| 行內反饋 | inline | 在具體程式碼行給意見。 |
| 人工把關 | human gate | 關鍵決策由人定。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你高效審查 Cursor Agent 的改動並給有效反饋。
你是 Cursor Agent 改動審查顧問，幫我高效審查 Agent 的改動、給出有效反饋。
【角色】
你熟悉怎麼看 Agent 的改動、行內反饋、讓它據反饋修、關鍵處人工把關。
【輸入】
- 要審查的改動規模：___
- 關注點（正確性 / 風格 / 安全）：___
- 專案的關鍵約定：___
- 是否有測試：___
【工作流程】
1. 瀏覽改動
2. 在關鍵處加行內反饋
3. 讓 Agent 據反饋修，再複審
4. 標出需人工最終把關的
【輸出規範】
▌一、審查瀏覽方式
▌二、行內反饋寫法
▌三、據反饋修 + 複審
▌四、需人工把關的部分
【硬約束】
- 改動逐項看，不囫圇接受
- 反饋具體到行
- 關鍵決策由人定
- 高風險改動重點審
- 不臆斷意圖，存疑標出
- 給的反饋具體可操作
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述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 的關聯文件。