用途:为任务提供独立的检出目录,使并行开发不会在 HEAD 或共享分支上冲突。创建、列出、移除、清理 worktree 属于本技能;plan/ship 阶段可能把创建 worktree 作为内部一步。
主要能力:forge worktree create <slug> 在 .worktrees/<slug> 创建检出,同时创建分支(默认 feat/<slug>),用 --issue <id> 关联 kernel 议题,并按仓库检测到的包管理器(bun/pnpm/yarn/npm)安装依赖。支持 --branch、--base、--work-folder 标志。kernel 议题库位于各 worktree 共享的 git 公共目录,新 worktree 直接可见,无需单独初始化。forge worktree list 读取 registry,forge worktree remove <slug> 执行移除。forge clean 删除分支已合并的 worktree 并快进默认分支,--dry-run 仅预览;能识别 squash 合并。
使用方式:始终使用 forge worktree create,不要用原始 git worktree add,后者不会关联 kernel 议题也不会安装依赖,是依赖缺失的常见原因。清理需在主仓库根目录运行 forge clean,不要在 .worktrees/<slug> 内运行;无默认分支保护,出错位置可能移除干净检出,建议先快进本地默认分支。
限制:无自身提交的分支不会被清理,其议题保持打开;被跳过的 worktree 不关闭议题。Windows 长路径可能导致目录残留,需用 PowerShell 扩展路径删除。相邻技能:ship(PR)、plan(规划)、shepherd(跟踪 PR)、issue-basics(议题日常操作)。