一个 Agent 串行写登录，三个并行半天交差：Cursor 多 Agent 协作实操

叙事主角：老李，AI 时代的互联网架构师
依据：Cursor 官方文档 Multi-agent、Agents Window、Subagents、Worktrees、Changelog 2026-04-24

1. 痛点引入

欲穷千里目，更上一层楼。

周五下午三点，业务要周一上线「Vue3 用户登录」：注册、登录接口、表单校验、单测、评审。老李开一个 Agent 聊了两小时。先搜代码，再写接口，再写表单，再补测试。上一段还没跑完，下一段只能干等。

更糟的一幕：同一 checkout 里再开一个 Agent。一个改 auth.ts，一个改 LoginForm.vue，文件偶发互踩。讲真，这不是模型笨，是协作还停在「一个劳动力串行打工」。

业务侧的决策其实很土：能并行的切片就别排队；会碰同一批文件的，先用 Git worktree 隔开。

小结：痛点不是「不会写代码」，是「不会把可并行工作拆开，还敢一起跑」。

2. 是什么

横看成岭侧成峰，远近高低各不同。

官方定义很直白：多 Agent 编码 = 同时跑多个 AI Agent，各自扛不同任务，或同一任务的不同切片。

和「侧边栏再开一个聊天」不是一回事。官方三条主路如下——社区看板先放一边：

内置三类子智能体：explore 搜代码、bash 跑命令、browser 浏览器自动化。专治中间噪声把主对话撑爆。自定义角色放 .cursor/agents/*.md。

横向对比一下：

小结：多 Agent = 会话并行 + 上下文隔离 + 可选文件隔离。缺一环，就退化成贵一点的串行。

3. 为什么用

工欲善其事，必先利其器。

值在三处：

1. 时间：Plan 里点 Build in Parallel，无依赖步骤同时跑，有依赖的仍按序。
2. 上下文：长搜索、长命令、浏览器快照进子 Agent，主会话只留决策。
3. 风险：Worktree 给任务独立 checkout，主分支不被实验脏改。

登录模块这种「前端表单 / API / 测试」天然可拆。跨仓改前后端，用 Multi-root workspace。CI 长跑丢给 /in-cloud。

反直觉的一句：Agent 不是越多越快。重叠改同一文件又不开 worktree，并行只是把合并成本提前交。

4. 架构图

不谋全局者，不足谋一域。

官方 Orchestrator 模式落到登录模块上，长这样：

子 Agent 不互相对线，结果回主 Agent。文件级并行靠 worktree，不靠「大家自觉」。

5. 安装配置步骤

合抱之木，生于毫末。

5.1 前置

1. 升级到 Cursor 3.x；/multitask 与改进版 Worktrees 见 2026-04-24 changelog，建议 3.2+。
2. 登录账号。云端与并行额度以当前套餐为准，别死记二手文里的「免费 4 / Pro 8」。
3. 项目必须是 Git 仓库。

5.2 打开 Agents Window

Ctrl/Cmd + Shift + P → Open Agents Window。
要经典 IDE 时用 Open Editor Window，两边可同时开。

5.3 Worktree 初始化

仓库根放 .cursor/worktrees.json：

{
  "setup-worktree": [
    "npm ci",
    "cp $ROOT_WORKTREE_PATH/.env .env"
  ]
}

Windows 可写 setup-worktree-windows。调试看 Output 里的 Worktrees Setup。

5.4 自定义 Verifier

官方链路是 Planner → Implementer → Verifier。最少先落地验货的：

.cursor/agents/verifier.md

---
name: verifier
description: Validates completed work. Use after tasks are marked done.
model: inherit
---
你是怀疑论验证者。检查实现是否可运行，跑相关测试，按严重级别汇报缺口。

用 Claude / Codex / CodeBuddy 生成角色文案可以，字段以官方为准：name、description、model、readonly、is_background。

6. 实战演示：Vue3 登录模块并行交付

纸上得来终觉浅，绝知此事要躬行。

目标：注册页 + 登录 API 客户端 + 表单校验 + 单测 + 独立验货。
路径：Agents Window → Plan → Build in Parallel + Worktree → /verifier。

步骤 A：主 Agent 先出 Plan

Agents Window 新建 Agent，环境选带 Worktree 的隔离运行：

开发 Vue3 用户登录模块：注册与登录接口封装、表单校验、单元测试。
先输出 Plan：按前端表单、API 层、测试三块拆分；标出依赖与可并行步骤。
不要直接改代码。

步骤 B：Plan 上点 Build in Parallel

独立步骤并行，依赖步骤保序。表单与 API 客户端文件不重叠时，可进不同 worktree 同跑。

步骤 C：/multitask 清队列

又追加了「补 E2E」「写 README」？直接：

/multitask 把队列里剩余任务拆成可并行子任务执行；会改同一文件的步骤串行

注意：/multitask 管的是排队与上下文并行；文件冲突仍靠 Worktree，或错开文件。

步骤 D：IDE 侧补刀

/worktree 实现 LoginForm 校验与对应单元测试，勿动主 checkout

多模型比稿用 /best-of-n。长任务云端用 /in-cloud，盯 PR 用 /babysit。

步骤 E：验货与合并

/verifier 确认登录注册流程可跑、单测通过、无半截实现

在 Agents Window 审各 worktree 的 diff，提交或开 PR；也可把分支拉回本地前台。IDE 侧可用 /apply-worktree。

截图位置：① Agents Window 多 Agent 列表；② Plan 的 Build in Parallel；③ Worktree diff；④ /verifier 报告。

7. 洞见三条

学而不思则罔，思而不学则殆。

洞见 1：先切「无共享文件」的边，再开并行

并行单位是文件边界，不是工种名牌。墙上挂着 Coder / Tester 很好看，真冲突还在同一个 auth.ts。

洞见 2：/multitask 不会自动隔离磁盘

它把请求从队列改成异步子 Agent。编辑仍可能落在前台 checkout。要干净 diff，Agents Window 选 Worktree，或 IDE 打 /worktree。

洞见 3：写代码的那个别自评「做完了」

官方 verification 模式说得很狠：AI 爱报完成。单独拉 /verifier 跑测试，比让实现者自证靠谱。

8. 总结与行动号召

千里之行，始于足下。

本周用登录模块把官方路径跑通，别先装社区看板：

1. Open Agents Window
2. 需求 → Plan → Build in Parallel
3. 改文件进 Worktree
4. 排队用 /multitask
5. 收尾 /verifier

Mission Control 一类看板可以后装。官方三件套跑不通，看板只是多一层热闹。

方法论速查表

核心就一条：把「一个超级助手串行聊天」换成「主 Agent 编排 + 子 Agent 干活 + Worktree 隔离 + 独立验货」。登录模块是最小演习场——演会了，下一个跨仓需求才敢真并行。