如何使用 Cursor Agent 模式：開倉庫任務並審 diff
打開 Agent 面板，下一件有邊界的倉庫任務，然後自己讀完 diff 再決定留不留。
倉庫已經在 Cursor 裡打開。你要模型動手，但不想對著一堆沒讀過的 diff 點接受。官方把這條路叫 Agent 模式：開一個對話，下一件倉庫任務，再讀它碰過的每個檔案。
可檢索的做法是 如何使用 Cursor Agent 模式：打開 Agent 面板，避開唯讀的 Ask，寫成一條有邊界的任務，然後在 diff 檢視裡決定留哪些。下面的快捷鍵和審查步驟以 cursor.com/help/ai-features/agent 為準。
先選會改檔案的模式
Agent 會寫
它會搜目錄、改多個檔案、跑 shell，出錯時也能停下來修。結果是一份你要自己審的補丁，再用它。
Ask 唯讀
Ask 回答問題，不改檔。面板停在 Ask 時，你只會得到說明和空 diff。Shift+Tab 循環模式，面板下拉框效果相同。
| 模式 | 什麼時候用 | 會改檔嗎 |
|---|---|---|
| Agent | 功能、重構、缺陷，且你準備審 diff | 會 |
| Ask | 只想弄清目錄和呼叫關係 | 不會 |
| Plan | 跨很多檔案，要先認可方案 | 你批准方案之後 |
| Debug | 需要執行時證據的難 bug | 會 |
一遍走完：啟動、下任務、審 diff
- 01打開 Agent 面板
在已經是 git 倉庫的資料夾裡按 ⌘I（Mac）或 Ctrl+I（Windows / Linux）。確認模式是 Agent。上一執行緒若是另一件事，開新對話。官方寫明：各模式上下文分開，換任務時新開更乾淨。
- 02只下一件有邊界的倉庫任務
寫清結果、目錄或檔案、以及怎樣算做成。例如：在 src/auth/session.ts 補空值判斷，並跑既有單測。不要把五件無關的活寫進同一條。官方示例也是一條具體請求。
- 03看 diff 檢視
按 Return 後 Agent 先探目錄，再邊做邊落地。檔案出現在 diff 裡。它走出你點名的目錄就按 Stop。跟進可以排隊，等目前輪結束再跑。
- 04審完再留或拒絕
讀新增和刪除。拒絕不想要的區塊。把游標放到更早的訊息上，用 Restore Checkpoint 回滾那之後的檔案改動——對話還在。測試要自己跑，不要把 Agent 日誌裡的一行綠當成驗收。
在 src/auth/session.ts 加守衛：缺少 user id
時回傳 401。不要改 billing 目錄。跑既有的
session 單測，失敗就停。第一次任務常在哪裡斷
- 面板停在 Ask
- 檔案不會變。用 Shift+Tab 或模式下拉切到 Agent，再發同一條提示。
- 提示裡沒有邊界
- Agent 會搜得很寬。寫明目錄、測試、以及不許改的路徑。
- 整疊 diff 一次接受
- 拒絕多餘檔案。看刪除行。方向錯了就回檢查點，不要在壞補丁上疊第二次重寫。
一件任務，一個對話，然後讀 diff。接受按鈕不是審查。
Cloud Agent 是另一扇門
cursor.com/agents 能在瀏覽器裡跑 Cloud Agent。本指南的桌面迴路仍然成立：審查是你的。兩條路都不要合併沒讀過的 diff。
兩個人要先對齊一次重構再合入，把檔案清單和風險區塊攤在同一頁即可。用 oakmeet 開一間會過期的房：瀏覽器、空間碼、不用註冊。房間邊界見 八人、大約一小時。
Agent 和以前的 Composer、Chat 是一回事嗎？
目前說明把能改檔、能跑命令的助手叫 Agent。舊介面文案寫過 Composer。若你的版本仍顯示 Composer，選允許改檔的模式，不要停在唯讀的 Ask / Chat。
一定要登入、一定要付費嗎？
需要登入。Agent 用量跟你的 Cursor 方案和模型額度走。現行方案看 cursor.com/docs。本頁不販售方案。
已經接受的 diff 還能撤嗎？
在更早的一則 Agent 訊息上用 Restore Checkpoint，可撤回那之後的檔案改動。已經進 git 的，仍可用 git checkout / git restore。回滾不會清空對話。
該先用 Plan 嗎？
官方對照表寫：跨很多檔案的大改，先走 Plan，你批准方案後它才改。邊界清楚的單件倉庫任務，按本教程走 Agent 即可。