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，全程守住安全边界。
一个实用习惯：每次开工先问自己「这次主要是规划、调试还是验收」，据此定主模式，再按需拉工具，而不是一上来什么都开。