老达用Cursor写代码有一年多了。从最初的单文件补全到Composer多文件编辑，再到今年正式投入Agent模式做日常开发——说实话，体验完全不同。
**Composer是你指挥AI干活，Agent模式是AI自己规划怎么干。** 这个差别，直接决定了你写代码的效率和最终质量。
用Agent模式的头两周，我犯了不少错：任务描述太模糊导致AI瞎改、一次给太多上下文把模型撑爆、改完代码没检查就跑了……踩完这些坑后，慢慢摸索出了一套方法。这篇文章就是我这3个月的实战总结。
## 1. 任务描述要像”写测试用例”，不要像”聊天”
Agent模式和Composer最大的区别在于，Agent会自己拆解任务、选择文件、决定执行顺序。如果你给的任务描述太模糊，Agent就会放飞自我。
**反面例子：**
> “帮我把这个页面的性能优化一下”
Agent看到这句话会怎样？它可能去改CSS，可能去拆组件，可能去加lazy loading——它不知道你到底要优化什么。
**正面例子：**
> “优化Dashboard页面的首屏加载时间，目标：LCP从3.2s降到1.5s以内。当前瓶颈在图表组件的初始渲染，请先分析bundle大小，然后对ECharts和日期选择器做按需加载，不要改动数据获取逻辑。”
这样写，Agent就知道：目标是什么、当前问题在哪、从哪入手、哪些不能动。
**实战经验：** 把任务描述当成”给初级开发者的ticket”来写——明确输入、期望输出、约束条件和验收标准。少用一个模糊词，AI就少做十个多余操作。
## 2. 主动控制上下文窗口，别让Agent”撑到失忆”
Agent模式最隐蔽的问题是上下文膨胀。它每读一个文件、每执行一个操作，都会往上下文里塞东西。处理一个大项目时，Agent可能读了20个不相关文件，到真正需要改代码的时候，上下文已经爆了。
**我的应对策略：**
– **手动打开相关文件再启动Agent**：在启动Agent之前，先把要改的核心文件在编辑器里打开。Agent会优先参考已打开文件的上下文，而不是满项目乱找。
– **用 `.cursorrules` 限定搜索范围**：明确告诉Agent只关注哪些目录，哪些目录别看。比如：`# 代码修改范围：仅限 src/pages/dashboard/ 和 src/components/charts/，不要触碰 src/api/ 和配置文件`
– **大任务分段执行**：一个复杂功能拆成3-5个小任务，每个任务启动一次Agent。别试图让Agent一口气做完所有事。
**一个实际的对比：** 做一个包含表单、图表和导出功能的报表页面。如果一次性交给Agent，它大概率会写到一半开始乱改、丢失前面的修改。拆成”搭页面骨架 → 实现表单逻辑 → 接入图表 → 加导出功能”四个小任务后，每一步都稳得多。
## 3. `.cursorrules` 写好了，Agent就是你的”分身”
`.cursorrules` 是Cursor Agent模式的灵魂。好的规则文件让你的代码风格、架构偏好、技术选型被AI自动遵循。
**我的 `.cursorrules` 核心部分长这样：**
“`
## 技术栈约束
– 前端：React 18 + TypeScript，状态管理用 Zustand
– 样式：Tailwind CSS，不要引入新的CSS库
– 图表：ECharts，不要换别的库
## 代码规范
– 组件文件不超过300行，超过就拆分
– 所有异步操作必须有loading和error状态
– API调用统一走 src/api/ 下的封装函数，禁止在组件里直接fetch
– TypeScript类型定义放在同目录的 types.ts
## 项目约定
– 页面组件放在 src/pages/，公共组件放 src/components/
– 路由配置在 src/router.tsx
– 不要修改 package.json，除非我明确要求
– 不要自动执行 git 操作
“`
最关键的三条规则：**技术选型的硬约束、代码风格的一致性要求、明确禁止的操作。** 有了这些，Agent改出来的代码基本不需要大修。
**小技巧：** 每当你发现Agent反复犯同一个错误（比如总给你用any类型、总在组件里直接写fetch），就把这个约束加到 `.cursorrules` 里。一个月下来，规则文件就是你的”编程分身”。
## 4. 学会”回滚式检查”，别等Agent改完再发现问题
用Agent模式最危险的习惯是：下达任务后去喝杯水，回来直接看结果。等你发现Agent改错了方向，它可能已经在错误基础上改了10个文件。
**我的检查节奏：**
– Agent每完成一个逻辑块（比如一个组件、一个API调用），**立刻review**，不要等它做完所有事。
– 在Agent执行过程中，如果看到它的思路偏了，**直接中断并给出纠正指令**，别等它跑完。
– 每条关键修改用 `git diff` 确认，不要信任Agent的”Done, here’s what I changed”总结——它经常漏报或误报。
– 善用 `git stash` 和 `git checkout`：改坏了就果断回滚，别心疼AI写的代码。
**一个真实案例：** 有一次让Agent改一个表单校验逻辑，它改完校验后”顺手”重构了表单的提交流程，而且没在总结里提。要不是我习惯每次改完跑一下 `git diff –stat`，这个bug就上线了。
## 5. 建立自己的”效率感觉”——知道什么时候用Agent，什么时候自己写
不是所有任务都适合交给Agent。用错场景，效率反而更低。
**适合Agent的任务：**
– 需要跨多文件修改的功能开发（比如加一个完整页面）
– 重复性模式代码（CRUD、表单、列表页）
– 代码重构：提取组件、统一命名、迁移API
– 项目初始化：搭脚手架、配置路由和状态管理
**不适合Agent的任务：**
– 涉及核心业务逻辑的复杂算法（AI容易理解错业务规则）
– 一次只改一行的微小调整（启动Agent的overhead比手动改还大）
– 涉及多个服务/数据库的架构级改动（上下文不够）
– 安全相关的代码（权限校验、加密逻辑）
**老达的经验公式：** 如果一个功能你自己写需要1小时以上，且逻辑路径清晰（不涉及太复杂的业务判断），交给Agent大概率能在15-20分钟内搞定——前提是你把前面4条技巧用上了。
## 老达点评
Cursor Agent模式已经不是一个”尝鲜功能”了。它正在改变我写代码的方式——从”一行一行敲”变成”描述需求、审查结果、修正方向”。但我必须说，**AI编程工具目前仍然是”放大镜”而不是”替代品”**：好程序员用了效率翻倍，不会写代码的人用了只会更快地写出更烂的代码。
如果你已经在用Cursor但还没试Agent模式，建议从一个中等复杂度的新功能开始，把 `.cursorrules` 配置好，拆成小任务，逐个验证。一周后你大概率会和我一样回不去了。
—
**相关阅读：**
– [Cursor、Windsurf还是Claude Code？三款AI编程工具横评](https://laodad.com/tools/6965.html)
– [AI编程多环境配置怎么做？让Cursor、Claude Code、Codex少改错环境变量](https://laodad.com/tools/7828.html)
– [AI编程专题](https://laodad.com/ai-topics/ai-programming-tools)
– [AI智能体与自动化专题](https://laodad.com/ai-topics/ai-agent-workflows)
