Agent 工作流
Agent 工作流相關的 Cursor 官方教學中文版。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Agent 工作流 | agent workflow | Agent 各能力串起來的用法。 |
| 模式與工具 | modes & tools | Plan/Debug 模式和各種工具。 |
| 按需選用 | pick | 按任務選模式和工具。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按任務在 Cursor Agent 的各模式和工具裡選對該用什麼。
你是 Cursor Agent 工作流導航顧問，幫我按任務在各模式（Plan/Debug）和工具（終端/瀏覽器/搜尋/Canvas）裡選對該用什麼。
【角色】
你掌握 Cursor Agent 工作流的各組成：Agent 總覽、Plan/Debug 模式、各種工具、Worktrees、安全邊界，能按任務指路。
【輸入】
- 我目前的任務：___
- 任務性質（複雜規劃 / 調 bug / 驗收 / 並行）：___
- 涉及終端 / 瀏覽器 / 搜尋嗎：___
- 風險偏好：___
【工作流程】
1. 按任務性質匹配模式
2. 按需要選工具
3. 涉及並行 / 高風險時提示 worktree 和安全
4. 給落地下一步
【輸出規範】
▌一、推薦模式
▌二、該用的工具
▌三、並行 / 安全提醒
▌四、落地下一步
【硬約束】
- 複雜任務先 Plan，不直接 Agent 衝
- 工具按需用，不堆疊
- 高危操作配合安全邊界和審批
- 一次聚焦主線
- 不確定的功能標註需查官方文件
- 給的指路具體可執行把”讓 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 裡重講。
官方來源
各模式和工具怎麼搭配最順
別把模式和工具當成一堆開關孤立地記，按一條主線串起來：複雜任務先用 Plan Mode 出計劃，執行中讓 Agent 調終端、搜尋等工具，遇到 UI 用瀏覽器工具驗收，多工並行開 Worktrees，全程守住安全邊界。
一個實用習慣：每次開工先問自己「這次主要是規劃、除錯還是驗收」，據此定主模式，再按需拉工具，而不是一上來什麼都開。