用途:该技能用于管理 Git worktree 的生命周期,并配合复制 .env 文件,支持并行功能开发、隔离审查和干净的工作区。
主要能力:通过统一的 manager 脚本执行所有 worktree 操作,支持以下命令:create <name> [base](创建)、list(列出)、switch <name>(切换,打印路径)、cleanup(清理)、copy-env <name>(复制 .env)。worktree 统一存放在 .worktrees/ 目录下。
使用方式:先确定仓库根与插件路径,再调用脚本: ROOT="$(git rev-parse --show-toplevel)" PLUGIN_ROOT="$ROOT/.opencode/skill" bash "$PLUGIN_ROOT/flow-next-opencode-worktree-kit/scripts/worktree.sh" <command> [args]
安全与限制:create 不会切换当前分支;cleanup 不会强制移除 worktree,也不会删除分支;cleanup 会删除 worktree 目录(含被忽略文件),若 worktree 不干净则移除失败;.env* 复制时不覆盖,跳过符号链接;若 .worktrees/ 或任一 worktree 路径组件是符号链接,则拒绝操作;copy-env 仅针对已注册的 worktree;origin fetch 为可选,允许使用本地 base 引用,仅当 base 看起来像分支时才从 origin fetch。