---
title: "Agent 工作流"
description: "Agent 工作流相關的 Cursor 官方教程中文版。"
verifiedAt: "2026-05-09"
---

把”讓 AI 寫程式碼”拆成可控流程：先理解任務，再選擇模式，再讀檔案和呼叫工具，最後看 diff、跑驗證、必要時從 checkpoint 回退。這一組是 Cursor 的執行層——Cursor Agent 把 instructions（指令）、tools（工具）、model（模型）和 checkpoints（快照）組合成一個可規劃、可執行、可回退的編碼迴圈。

> [!NOTE]
> **閱讀方式**：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。

<Cards>
  <Card title="Agent 總覽" description="理解 Agent 如何用 instructions、tools 和 model 完成任務。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/10-agent-overview" />
  <Card title="Agents Window" description="管理多個 Agent 任務和會話視窗。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/11-agents-window" />
  <Card title="Plan Mode" description="先規劃後改程式碼，降低大改動風險。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/12-plan-mode" />
  <Card title="Prompting" description="按 Cursor 官方建議給 Agent 寫任務。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/13-prompting" />
  <Card title="Debug Mode" description="使用 Debug Mode 定位執行時錯誤。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/14-debug-mode" />
  <Card title="Agent Review" description="讓 Cursor 審查程式碼變更和風險。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/15-agent-review" />
  <Card title="Terminal Tool" description="理解 Agent 如何執行終端命令。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/16-terminal-tool" />
  <Card title="Browser Tool" description="使用瀏覽器工具做視覺驗證和本地應用測試。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/17-browser-tool" />
  <Card title="Search Tool" description="用語義搜尋和檔案搜尋找到程式碼上下文。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/18-search-tool" />
  <Card title="Canvas Tool" description="理解 Canvas 工具在設計和視覺化中的位置。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/19-canvas-tool" />
  <Card title="Worktrees" description="用 worktrees 隔離並行修改。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/20-worktrees" />
  <Card title="Agent 安全邊界" description="理解 Agent 許可權、命令執行和安全提醒。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/21-agent-security" />
</Cards>

## 學習順序

Agent 工作流不要從工具清單開始背。更穩的順序是：

1. 先讀 Agent 總覽，理解 Agent 如何接收 instructions、讀取上下文、呼叫 tools 和生成 diff。
2. 再讀 Plan Mode 和 Prompting，把模糊需求改成可執行任務。
3. 然後讀 Terminal、Browser、Search、Canvas，知道每個 tool 適合什麼驗證。
4. 最後讀 Review、Worktrees 和 Agent 安全邊界，把並行修改、回退和許可權控制補上。

這組文章的核心是“讓 Agent 進入可控迴圈”：任務足夠窄，工具呼叫可解釋，diff 可 review，驗證可復現，失敗可以從 checkpoint 或 worktree 回退。

## 交付標準

一次合格的 Agent 任務應該留下：

- 清楚的目標和範圍。
- Agent 讀取的關鍵檔案或上下文。
- 可審查 diff。
- 測試、構建、瀏覽器檢查或人工驗收結果。
- 仍然未知或需要人工確認的風險。

如果 Agent 修改了很多無關檔案，通常不是工具問題，而是任務邊界沒寫清楚。回到 Plan Mode，讓它重新拆範圍。

## 和上下文層的關係

Agent 工作流解決“怎麼執行”，上下文與定製解決“每次執行前應該自動知道什麼”。當你發現同一類提醒反覆出現，例如不要改某個目錄、提交前必須跑某個指令碼、瀏覽器驗收要看某個斷點，就應該把它寫進 Rules、Skills、Hooks 或 Commands，而不是每次在 prompt 裡重講。

## 官方來源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
