Agent 是个不知疲倦的初级开发者：委派的艺术

Fen9Pi2026/9/14大约 5 分钟

前言

Cursor Learn 系列第三篇，进入正题：Agent。

课程里有一句定性的话，比任何技术定义都好用：把 Agent 看作行动迅速的初级开发者——需要明确指导，容易忘事，需要监督，还可能陷入循环反复用同一种失败方法。

这篇把 Agent 的原理和协作方法一次讲清，素材来自课程《Agents》和《与智能体协作》两课。

一、这一课的身份

谁写的：Cursor 官方课程
讲什么：Agent 是什么（工具+循环）、怎么委派任务、怎么写提示词、怎么管上下文、怎么避开失败模式
核心立场：目标不是消除人工参与，而是放大你能完成的工作——你成为架构师和审阅人，Agent 负责实现细节

二、Agent 的本质：让工具在循环中运行

Agent 的核心其实很简单：给一个目标，让工具在循环里自主运行。

课程比喻：一步步告诉朋友怎么走，是逐向导航；只告诉他目的地，让他自己开 GPS，是 Agent。

流程图1 " 注意中间那个循环：每一步工具调用后，Agent 根据结果决定下一步。"像看着某人边思考边自言自语，只不过他同时把活干完了。"

这个循环带来的是角色转变：你不再依次问"components 里有什么文件""能读下 Button 组件吗""现在加个深色模式变体"，你只说目标。你从任务执行者变成任务管理者——甚至可以让多个 Agent 同时干活：一个加测试、一个更新文档、一个重构那堆一直想清理的工具函数。

三、Agent 框架的三件套

Cursor 这类工具里，Agent 跑在一个"框架"里，三部分组成：

组件	是什么	类比
说明	系统提示词 + 规则	岗位职责书
工具	文件编辑、代码库搜索、终端执行	工位上的工具箱
模型	你为任务选的模型	这个员工本身

同一套框架，换模型行为就不同：有的模型爱调 shell 命令，有的需要更明确的说明。所以"Agent 表现不好"要拆开诊断——是说明没写清、工具不给力，还是模型不行。

四、委派的艺术

挑活儿

Agent 擅长的：目标明确、模式成熟的任务——给现有代码加测试、更新文档、按一致模式重构、修错误信息明确的缺陷。

Agent 吃力的：需要深入理解系统交互的复杂调试、像素级还原设计稿、用训练数据里没有的新库。

写提示词：模糊 vs 明确

课程给了一组对比，值得原样记住。

模糊版：

添加用户设置页面

Agent 得猜所有细节：什么布局？哪些组件？什么样式？有时能蒙对，通常不能。

明确版（节选）：

添加用户设置页面。
查看 src/app/profile/page.tsx 中现有的配置文件页面，参考我们的布局模式。
使用 src/components/ui/Form.tsx 中的同一套表单组件。设置应包括：
- 显示名称（文本输入）
- 电子邮件通知（开关）
- 主题偏好（下拉：浅色、深色、跟随系统）
使用现有的 useUserPreferences hook 存储设置。