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 里重讲。