用途:避免两个 agent 在同一份 checkout 中同时修改、争抢 HEAD。隔离不是可选项,主 checkout 不属于任何单个任务;若被要求在另一条工作流仍活跃时直接改主 checkout,应拒绝并改在工作树中操作。
创建:在主仓库根目录运行 forge worktree create <slug>,create 与 clean 均受当前工作目录约束。该命令除等价于 git worktree add 外,还会链接 kernel issue、建立 issue store 并接好依赖。随后全部工作在 .worktrees/<slug>/ 内进行。
Windows 注意:node_modules 是仅限根目录的 junction,新建工作树会缺少 packages/skills/node_modules,缺 chalk/inquirer 时 skills 测试失败;以及 git worktree remove --force 后残留目录可能需要 \?\ 前缀删除。
清理:运行 forge clean。需先把本地 main/master 快进,否则 squash-merge 检测会漏掉你的分支并留下工作树;该命令没有默认分支保护,应在主根目录运行并确认当前分支。
多 agent 协作:一个 agent、一个工作树、一个 PR;不要让两个 agent 主导同一 PR。并行 agent 应在编辑前声明文件归属。不要凭单次采样判定另一 agent 已死,干净的工作树与近期无写入也可能只是提交与下一次红灯测试之间;应间隔数分钟采样两次并比较,任何重启都不得编辑有争议的工作树。
完成标准:改动位于 .worktrees/<slug>/ 内的分支,主 checkout 未被触碰,且该工作树已开 PR 或已清理。官方文档、版本与平台支持等未提供更多细节。