Background Agent：云端并行执行

Background Agent 是什么

Background Agent 是 Cursor 1.x 引入的云端并行执行功能。与普通 Agent 在你本地机器的项目目录中执行不同， Background Agent 在 Cursor 的云端沙盒环境中运行，可以和你的日常开发并行进行，互不干扰。 执行完成后，它会自动创建一个 Git 分支并生成 Pull Request。

启用与配置

Background Agent 需要以下条件：

• Cursor Pro 及以上订阅
• 在 Cursor Settings → Beta → Background Agent 中开启
• 项目必须是 Git 仓库（Background Agent 通过分支和 PR 交付结果）
• 在 Cursor 中连接了 GitHub 账号（用于创建 PR）

启动 Background Agent 任务

// 启动方式：在 Chat 或 Composer 中，点击"Run in Background"按钮
// 或使用命令面板 Cmd+Shift+P → "Cursor: Start Background Agent"
//
// 示例任务：

"
在 feature/email-notifications 分支上实现邮件通知功能：
1. 集成 Resend API 发送邮件（API Key 在 .env 中的 RESEND_API_KEY）
2. 注册成功时发送欢迎邮件（模板见 docs/email-templates.md）
3. 订单完成时发送收据邮件
4. 添加完整的测试覆盖（参考现有测试风格）
完成后创建 PR，标题格式：feat: add email notifications
"

Background Agent 工作流

Background Agent 的完整执行流程：

1. 接收任务：你在 Cursor 中描述任务，点击"Run in Background"
2. 克隆仓库：云端沙盒克隆你的仓库到隔离环境
3. 创建分支：从当前分支创建新的工作分支
4. 执行任务：Agent 在沙盒中自主规划、编码、运行测试
5. 提交代码：将所有改动 commit 到工作分支
6. 创建 PR：自动创建包含详细描述的 Pull Request
7. 通知你：Cursor 中出现通知，PR 链接发送到你的邮箱
8. 你审查：像审查同事 PR 一样审查 Agent 的代码

最佳实践

提供清晰的"定义完成"标准

// ❌ 模糊的任务描述
"给系统添加缓存"

// ✅ 有明确完成标准的描述
"
使用 Redis 为以下 3 个 API 端点添加缓存：
- GET /api/products（缓存 5 分钟）
- GET /api/categories（缓存 30 分钟，不经常变化）
- GET /api/user/:id/profile（缓存 1 分钟，按用户 ID 隔离）

完成标准：
1. 所有现有测试仍通过（不得修改测试逻辑）
2. 新增 3 个缓存层的单元测试
3. 缓存 key 格式遵循 docs/redis-conventions.md 中的规范
"

有效审查 Background Agent 的 PR

# Background Agent PR 审查检查清单：
# □ 所有测试通过（CI 绿色）
# □ 没有添加不必要的依赖
# □ 没有修改不相关的文件
# □ 代码风格与项目一致
# □ 没有硬编码的凭证或密钥
# □ 错误处理完整（边界情况覆盖）
# □ 功能与需求描述一致