Cursor Agent 模式与 YOLO 模式实战指南

Agent 模式是 Cursor 最猛的功能，但很多人只用它来聊天，太浪费了。

你可能还在用老办法：在聊天框里问代码，然后手动复制粘贴到文件里。能跑，但你只发挥了 Cursor 不到 20% 的实力。

这篇指南整理自 Cursor 论坛的真实讨论，不讲虚的，只说实际怎么用。

Agent 模式 vs 普通聊天：核心区别

很多人搞不清楚这两者的区别，觉得"不都是跟 AI 对话吗"。完全不是一回事。

功能	普通聊天	Agent 模式
读取代码库	能	能
给出代码建议	能	能
执行终端命令	不能	能
创建/修改文件	不能	能
跨文件搜索	不能	能
多步骤任务	不能	能
需要确认操作	不适用	是（除非开了 YOLO）

普通聊天就像问一个聪明的同事"这段代码怎么写"。Agent 模式则是让一个初级开发实际去干活——跑命令、建文件、改代码，而且能跨文件操作。

切换到 Agent 模式（聊天面板里的机器人图标）后，Cursor 就解锁了一堆工具：文件读写、终端命令、代码搜索等等。它能自己规划步骤，然后一步步执行。

什么时候该用 Agent 模式

任何需要"动手"的任务。如果你发现自己正在从聊天框复制代码粘贴到文件里，就该切到 Agent 模式了。

YOLO 模式详解：名字就说明了一切

YOLO = You Only Live Once（你只活一次）。在 Cursor 里，YOLO 模式意味着 Agent 跳过所有确认弹窗，直接干。

没有"允许写入文件？"的弹窗。没有"运行这个命令？"的提示。Agent 全自动执行，直到任务完成或者碰到问题。

什么时候该开 YOLO

• 搭建新项目 -- 创建目录、装依赖、生成脚手架代码
• 批量重构 -- 跨 50 个文件重命名变量、更新 import 路径
• 自动化任务 -- 生成测试文件、写迁移脚本、批量写文档
• 可丢弃的工作 -- 任何 git reset 就能恢复的东西

什么时候千万别开

绝不要在生产分支开 YOLO

说真的。一个错误的 rm -rf 或者一条搞坏的数据库迁移，你就知道为什么确认弹窗存在了。

• 生产代码或主分支 -- 这里永远要手动审查
• 数据库操作 -- 迁移、改表结构、种子数据
• CI/CD 配置 -- 写错一行就能把整个流水线搞崩
• 任何不可逆操作 -- 做了就撤不回来的事，别 YOLO

怎么开关 YOLO 模式

1. 打开 Agent 聊天面板（Cmd/Ctrl + Shift + A）
2. 看面板顶部的 YOLO 开关
3. 点击切换

YOLO 开启时会有一个小警告图标，注意看。

实战 1：从零搭建项目

这是 Agent 模式最爽的场景。不用手动跑 create-react-app，不用自己建文件夹结构，不用写样板代码——全交给 Agent。

第一步： 在一个空目录里打开 Agent 模式。

第二步： 给一个清晰详细的 prompt：

创建一个 Next.js 14 项目，要求：
- App Router + TypeScript
- Tailwind CSS 做样式
- 登录和注册页面
- Dashboard 布局，带侧边栏导航
- 用户管理的 API 路由
- 配置好 ESLint 和 Prettier
- 环境变量配置数据库连接

用 PostgreSQL + Prisma ORM。建一个基础的用户表，包含 email、密码哈希和时间戳。

第三步： 看它干活。Agent 会：

1. 用 npx create-next-app 创建项目
2. 安装依赖（Prisma、Tailwind 等）
3. 生成文件夹结构
4. 写初始配置文件
5. 设置 Prisma schema 并跑初始迁移
6. 创建页面组件和 API 路由

第四步： 检查产出。就算用 Agent 模式，也建议扫一眼它创建了什么再继续。

论坛经验

"每次让 Agent 搭完项目先 commit 一次。后面改乱了，git checkout . 就能回到干净状态。" -- Cursor 论坛 @devops_mike

实战 2：代码审查自动化

不需要额外的代码审查工具，Agent 模式就能帮你扫代码。

示例 prompt：

审查 src/api/ 目录下的所有文件，检查：
1. 安全漏洞（SQL 注入、XSS、缺少鉴权检查）
2. 错误处理缺陷（未处理的 Promise、缺少 try-catch）
3. 性能问题（N+1 查询、缺少索引）
4. 代码质量（未使用的 import、重复逻辑、命名不一致）

每个问题说明原因和建议修复方案。先不要改代码，只报告问题。

Agent 会搜索你的文件、分析代码，然后给你一份结构化的报告。你可以看完报告再决定修哪些。

进阶用法

审查完之后，让 Agent 修指定的问题：

修复你找到的 SQL 注入漏洞。把 src/api/users.ts 和 src/api/orders.ts 里所有的数据库调用改成参数化查询。

这种两步走的方式（先审查、再修复）既利用了 Agent 的速度，又保留了你自己的控制权。

实战 3：配合 .cursorrules 做批量重构

这是论坛里被反复安利的组合：YOLO 模式 + .cursorrules。

原理很简单——.cursorrules 文件告诉 Agent 你的项目规范是什么，这样你让它做大规模重构时，它会按你的规矩来，而不是自作主张。

配置项目规则

在项目根目录创建 .cursorrules 文件：

## 项目规范
- 使用 TypeScript strict 模式
- 所有 API 响应格式：{ success: boolean, data: T, error?: string }
- 组件用命名导出，不用默认导出
- 状态管理用 Zustand，放在 src/stores/
- 所有异步函数必须有 try-catch 错误处理
- 数据库操作使用 Repository 模式
- 测试文件放在源文件旁边的 __tests__/ 目录

执行重构

开了 YOLO 模式，配好规则之后：

把所有 API 路由重构为 Repository 模式：
1. 创建 src/repositories/ 目录
2. 把 src/api/ 里的数据库操作提取到 Repository 类
3. 更新 API 路由，改用 Repository
4. 给所有 Repository 方法加 TypeScript 接口
5. 创建对应的测试文件

YOLO + 重构 = 先 Git

用 YOLO 做批量重构之前：

1. 提交所有当前修改
2. 创建一个 feature 分支
3. 执行重构
4. 用 git diff 检查改动
5. 确认没问题再合并

安全底线：怎么用不翻车

Cursor 论坛上翻车的故事太多了。按下面这些原则来，你不会成为下一个。

用 Shadow Workspace

Cursor 的 Shadow Workspace 功能让 Agent 在代码副本上工作。搞砸了，你的实际文件不受影响。

1. 打开设置
2. 找到 Features
3. 开启 Shadow Workspace
4. Agent 就在隔离环境里操作了

Git 是你的安全网

这应该是常识，但看论坛的帖子，显然不是所有人都知道：

# 在让 Agent 改重要代码之前
git add .
git commit -m "agent 重构前的检查点"

# 如果 Agent 搞砸了
git diff            # 看看改了什么
git checkout .      # 全部还原
# 或者
git reset --hard    # 核弹选项

分支策略

main（生产环境）     -- 绝不让 Agent/YOLO 碰
  └── develop       -- Agent 模式可以，YOLO 关掉
       └── feature/*  -- Agent + YOLO，随便搞

离生产越远，给 Agent 的自由度越高。Feature 分支是游乐场，主分支是禁区。

铁律

承担不起丢失的东西，就不要在没有备份的情况下让 Agent 碰。

Background Agent：让 AI 在后台干活

Background Agent（Cursor 0.50 引入）是处理大任务的利器。不用盯着 Agent 一步步操作，把任务丢给它，你自己继续写别的代码。

怎么用

1. 按 Cmd/Ctrl + E 打开 Background Agent 面板
2. 详细描述你的任务
3. 点"Start Agent"
4. 回到编辑器继续干别的
5. Agent 完成后查看 Background Agent 面板的结果

适合交给 Background Agent 的任务

• "给 src/components/ 下的所有组件写单元测试"
• "给 src/api/ 的每个接口生成 API 文档"
• "写一个从 REST 迁移到 GraphQL 的脚本"
• "把认证模块从 session 改成 JWT"

几个要注意的点

• Background Agent 在云端运行，不会卡你的本地机器
• 可以同时跑多个 Background Agent
• Agent 完成后结果会同步回本地项目
• 从 Cursor 1.1 开始，可以在 Slack 里收 Background Agent 的更新

论坛技巧

"我每天早上把写测试的任务丢给 Background Agent，然后自己写功能代码。到中午就有完整的测试套件可以审查了。" -- Cursor 论坛 @testing_alex

快捷键速查

操作	快捷键
打开 Agent 聊天	Cmd/Ctrl + Shift + A
打开 Background Agent	Cmd/Ctrl + E
切换 YOLO 模式	点击 Agent 面板里的 YOLO 开关
接受 Agent 修改	Cmd/Ctrl + Y
拒绝 Agent 修改	Cmd/Ctrl + N
打开 Composer	Cmd/Ctrl + I

常见坑

1. Prompt 太模糊

差："帮我修代码" 好："修复 src/utils/parser.ts 里的 TypeScript 错误。日期解析函数没有正确处理时区偏移。"

2. 一次塞太多任务

Agent 模式最适合专注的、单一目标的任务。不要说"重构所有代码，加上测试，再更新文档"，拆成三个独立的 Agent 会话。

3. 不给上下文

Agent 不知道你的项目历史。告诉它你用什么框架、遵循什么规范、代码应该做什么。

4. 不看输出

就算开了 YOLO 模式，也该看看 Agent 做了什么。每次 Agent 会话后快速 git diff 一下，趁问题还没累积就抓住它。

写在最后

Agent 模式和 YOLO 模式用对了就是效率倍增器。关键是搞清楚什么时候让 Agent 放手干，什么时候得把它拴紧。

从小事开始。先用 Agent 模式改一个文件。然后试试多文件重构。慢慢地你就会有直觉——什么时候 YOLO 是安全的，什么时候不是。这种直觉比任何教程都有用。

---

参考来源：

• Cursor 论坛：Agent 模式讨论
• Cursor 论坛：YOLO 模式技巧
• Shadow Workspace 文档
• Cursor Rules 最佳实践