---
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="/docs/cursor/official/01-agent-workflow/10-agent-overview" />
  <Card title="Agents Window" description="管理多个 Agent 任务和会话窗口。" href="/docs/cursor/official/01-agent-workflow/11-agents-window" />
  <Card title="Plan Mode" description="先规划后改代码，降低大改动风险。" href="/docs/cursor/official/01-agent-workflow/12-plan-mode" />
  <Card title="Prompting" description="按 Cursor 官方建议给 Agent 写任务。" href="/docs/cursor/official/01-agent-workflow/13-prompting" />
  <Card title="Debug Mode" description="使用 Debug Mode 定位运行时错误。" href="/docs/cursor/official/01-agent-workflow/14-debug-mode" />
  <Card title="Agent Review" description="让 Cursor 审查代码变更和风险。" href="/docs/cursor/official/01-agent-workflow/15-agent-review" />
  <Card title="Terminal Tool" description="理解 Agent 如何执行终端命令。" href="/docs/cursor/official/01-agent-workflow/16-terminal-tool" />
  <Card title="Browser Tool" description="使用浏览器工具做视觉验证和本地应用测试。" href="/docs/cursor/official/01-agent-workflow/17-browser-tool" />
  <Card title="Search Tool" description="用语义搜索和文件搜索找到代码上下文。" href="/docs/cursor/official/01-agent-workflow/18-search-tool" />
  <Card title="Canvas Tool" description="理解 Canvas 工具在设计和可视化中的位置。" href="/docs/cursor/official/01-agent-workflow/19-canvas-tool" />
  <Card title="Worktrees" description="用 worktrees 隔离并行修改。" href="/docs/cursor/official/01-agent-workflow/20-worktrees" />
  <Card title="Agent 安全边界" description="理解 Agent 权限、命令执行和安全提醒。" href="/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)
