別把 Cursor Agent 當聊天框

別把 Agent 當聊天框:第一次成功是一條已審過的 diff,不是一段說明。

把 Cursor Agent 當聊天框,第一次執行就會停在一段解釋上,倉庫裡什麼都沒動。側欄用 Cmd+I(Windows / Linux:Ctrl+I),給一個能落盤的結果,再審 diff。要先把目標攤開,去 wbstorm 開房間。

官方 Quickstart 寫的第一次有用結果是 一次小的、已審過的改動,不是一段「這個倉庫大概在做什麼」。裝好、登入、打開資料夾,再開 Agent。

打開資料夾Cmd+I 開 Agent一小步 · 審 diff

聊天框思維會卡在哪

01

只要解釋

「講講這個倉庫」會搜檔、讀入口,但目錄樹沒變。那是熱身,不是第一次成功。

02

不寫結果

「幫我看看」沒有可核對的完成條件。官方範例是列出三個低風險改動,等你選一個再動手。

03

不看 diff

Agent 會改檔、跑終端。第一次成功以 diff 和你專案裡已有的檢查為準,不以回覆長度為準。

第一次真正跑通

  1. 1

    打開倉庫

    從 cursor.com 安裝並登入。macOS 12+、Windows 10+;Linux 官方給 apt / dnf / AppImage。打開你要改的那個資料夾,不要對著空視窗聊天。

  2. 2

    打開 Agent 側欄

    快捷鍵 Cmd+I / Ctrl+I。官方定義:Agent 能獨立完成複雜編碼任務、跑終端、改程式。一次任務裡工具呼叫沒有上限。

  3. 3

    要一個能落盤的結果

    直接描述改完長什麼樣。或依 Quickstart:先讓它建議三個安全的小改動,你選一個。文案、小 UI 問題適合當第一刀。

  4. 4

    審 diff,再跑已有檢查

    看 diff。讓它跑你們倉庫已經在用的測試、型別檢查、lint 或本機建置。回溯用時間線上的 checkpoint;checkpoint 只還原檔案,不刪訊息,也不能代替 Git。

你在做什麼像聊天框像 Agent
第一句「這是什麼專案?」「改 X,完成標準是 Y」
成功標準一段摘要已審 diff + 已有檢查
模式唯讀問答Agent 工具;大改走 Plan

給它看的第一句

Suggest three small, safe improvements in this codebase.
Explain the tradeoffs and wait for me to choose one.

選中之後補一句結果,不要再擴寫成閒聊。Agent 工作時 Enter 會把下一條指令排隊;Cmd+Enter 立刻插入當前輪。反覆同一約束,再寫成 Cursor Rules 的 .mdc。

草圖和投票不在編輯器裡:用 房間號 和 白板基礎 即可。本頁不講 wbstorm 如何改程式。

Cmd+I 打不開?

對照 cursor.com/docs/reference/keyboard-shortcuts:Cmd+I 切換側欄。也可在命令面板搜 Agent。先打開一個資料夾,空視窗沒有倉庫可改。

只想問、不想改檔?

那不是第一次 Agent 成功。CLI 文件把 Ask 寫成唯讀探索。編輯器裡大改用 Plan Mode(Shift+Tab),避免一上來就改一堆檔。

checkpoint 能代替 Git 嗎?

不能。官方寫 checkpoint 存在本機、和 Git 分開,只用來撤銷 Agent 改動。長期歷史仍提交到 Git。

第一次該改多大?

Quickstart 建議低風險:文案或小 UI。跨多檔、需求不清時先 Plan,再點建置。

建立房間