別把 Cursor Agent 當聊天框
別把 Agent 當聊天框:第一次成功是一條已審過的 diff,不是一段說明。
把 Cursor Agent 當聊天框,第一次執行就會停在一段解釋上,倉庫裡什麼都沒動。側欄用 Cmd+I(Windows / Linux:Ctrl+I),給一個能落盤的結果,再審 diff。要先把目標攤開,去 wbstorm 開房間。
官方 Quickstart 寫的第一次有用結果是 一次小的、已審過的改動,不是一段「這個倉庫大概在做什麼」。裝好、登入、打開資料夾,再開 Agent。
聊天框思維會卡在哪
只要解釋
「講講這個倉庫」會搜檔、讀入口,但目錄樹沒變。那是熱身,不是第一次成功。
不寫結果
「幫我看看」沒有可核對的完成條件。官方範例是列出三個低風險改動,等你選一個再動手。
不看 diff
Agent 會改檔、跑終端。第一次成功以 diff 和你專案裡已有的檢查為準,不以回覆長度為準。
第一次真正跑通
- 1
打開倉庫
從 cursor.com 安裝並登入。macOS 12+、Windows 10+;Linux 官方給 apt / dnf / AppImage。打開你要改的那個資料夾,不要對著空視窗聊天。
- 2
打開 Agent 側欄
快捷鍵 Cmd+I / Ctrl+I。官方定義:Agent 能獨立完成複雜編碼任務、跑終端、改程式。一次任務裡工具呼叫沒有上限。
- 3
要一個能落盤的結果
直接描述改完長什麼樣。或依 Quickstart:先讓它建議三個安全的小改動,你選一個。文案、小 UI 問題適合當第一刀。
- 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,再點建置。