Worktrees 与隔离任务

Worktree 让任务使用独立 Git checkout。原生界面入口在 Agents Window；IDE 使用 Worktree Skills，CLI 也会读取相同 setup 配置。

创建与采用结果

Agents Window 可在启动时或把现有 agent 移入 worktree 时建立隔离目录。IDE 使用 /worktree 开始隔离任务，完成后可继续在该 checkout 工作，或用 /apply-worktree 带回主工作区；不用时 /delete-worktree 清理。

/best-of-n 可在多个模型的独立 worktree 中比较同一任务，比较本身不会自动合并候选结果。先挑选并审阅，再决定采用。git worktree list 查看仓库已有 checkout。

Setup 配置

创建时先查 worktree 内的 .cursor/worktrees.json，再查项目根的对应文件。支持 setup-worktree-unix、setup-worktree-windows，平台专属键优先于通用 setup-worktree。

{
  "setup-worktree-unix": "setup-worktree-unix.sh",
  "setup-worktree-windows": "setup-worktree-windows.ps1"
}

字符串路径相对于 worktrees.json；也可使用按顺序执行的命令数组。脚本可用 ROOT_WORKTREE_PATH 引用原 checkout。依赖建议在各自 worktree 安装，不要把依赖目录简单软链回主目录。失败时看 Output > Worktrees Setup。

自动清理

Cursor 3.5 起的清理计数是整台机器所有工作区合计，默认上限 25。cursor.worktreeMaxCount 调整上限，cursor.worktreeCleanupIntervalHours 调整检查间隔。

每次清理会重新发现目录，外部 git worktree add 或 Skills 创建的 worktree 也可能进入清理范围。超过上限会触发经 debounce 的即时清理，重启后会补做过期检查。不能假定不是从 UI 创建就会永久保留，重要结果应及时保存。

Multi-root workspace 依赖单 Git root 的 worktree 功能有限，见搜索与多根限制。