Agent 工作流
Agent 工作流相關的 Cursor 官方教程中文版。
把”讓 AI 寫程式碼”拆成可控流程：先理解任務，再選擇模式，再讀檔案和呼叫工具，最後看 diff、跑驗證、必要時從 checkpoint 回退。這一組是 Cursor 的執行層——Cursor Agent 把 instructions（指令）、tools（工具）、model（模型）和 checkpoints（快照）組合成一個可規劃、可執行、可回退的編碼迴圈。
閱讀方式：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。
Agent 總覽
理解 Agent 如何用 instructions、tools 和 model 完成任務。
Agents Window
管理多個 Agent 任務和會話視窗。
Plan Mode
先規劃後改程式碼，降低大改動風險。
Prompting
按 Cursor 官方建議給 Agent 寫任務。
Debug Mode
使用 Debug Mode 定位執行時錯誤。
Agent Review
讓 Cursor 審查程式碼變更和風險。
Terminal Tool
理解 Agent 如何執行終端命令。
Browser Tool
使用瀏覽器工具做視覺驗證和本地應用測試。
Search Tool
用語義搜尋和檔案搜尋找到程式碼上下文。
Canvas Tool
理解 Canvas 工具在設計和視覺化中的位置。
Worktrees
用 worktrees 隔離並行修改。
Agent 安全邊界
理解 Agent 許可權、命令執行和安全提醒。
學習順序
Agent 工作流不要從工具清單開始背。更穩的順序是：
- 先讀 Agent 總覽，理解 Agent 如何接收 instructions、讀取上下文、呼叫 tools 和生成 diff。
- 再讀 Plan Mode 和 Prompting，把模糊需求改成可執行任務。
- 然後讀 Terminal、Browser、Search、Canvas，知道每個 tool 適合什麼驗證。
- 最後讀 Review、Worktrees 和 Agent 安全邊界，把並行修改、回退和許可權控制補上。
這組文章的核心是“讓 Agent 進入可控迴圈”：任務足夠窄，工具呼叫可解釋，diff 可 review，驗證可復現，失敗可以從 checkpoint 或 worktree 回退。
交付標準
一次合格的 Agent 任務應該留下：
- 清楚的目標和範圍。
- Agent 讀取的關鍵檔案或上下文。
- 可審查 diff。
- 測試、構建、瀏覽器檢查或人工驗收結果。
- 仍然未知或需要人工確認的風險。
如果 Agent 修改了很多無關檔案，通常不是工具問題，而是任務邊界沒寫清楚。回到 Plan Mode，讓它重新拆範圍。
和上下文層的關係
Agent 工作流解決“怎麼執行”，上下文與定製解決“每次執行前應該自動知道什麼”。當你發現同一類提醒反覆出現，例如不要改某個目錄、提交前必須跑某個指令碼、瀏覽器驗收要看某個斷點，就應該把它寫進 Rules、Skills、Hooks 或 Commands，而不是每次在 prompt 裡重講。