用途 rebase-worktrees 用于一次性把仓库中所有非主 git worktree 同步到指定目标分支,并在变基后统一处理依赖安装与 .env 键名同步,减少逐个 worktree 手动操作的成本。
主要能力
- 收集 worktree:通过 git worktree list --porcelain 获取全部 worktree,识别主 worktree(首个条目)并记录其路径与分支,主 worktree 本身不参与变基。
- 确定目标分支:可传入分支参数作为变基目标;未传入时使用主 worktree 的当前分支。目标始终是本地分支,不执行 git fetch,也不使用远程跟踪分支。
- 逐个变基:对每个非主 worktree 执行 git -C <worktree_path> rebase <target_branch>。遇到冲突时执行 git rebase --abort 恢复原状,记录失败信息后继续处理下一个 worktree,不会停在第一个失败处。
- 依赖安装:仅对变基成功的 worktree,按锁文件检测包管理器并安装:bun.lockb 或 bun.lock 对应 bun install,pnpm-lock.yaml 对应 pnpm install,yarn.lock 对应 yarn install,package-lock.json 对应 npm install。无锁文件则跳过;存在多个锁文件时按上述优先级取第一个匹配。安装失败会报告但不中断整体流程。
- 同步 .env 键名:若主 worktree 根目录没有 .env 则整体跳过。否则解析主 worktree 的 .env 提取键名(忽略注释与空行),对每个变基成功的 worktree 对比键集合:主有而子无的为新增键,子有而主无的为删除键。若存在差异,通过 AskUserQuestion 展示差异并询问是否更新该 worktree 的 .env;用户同意后,新增键从主 worktree 复制键值对,删除键从子 worktree 的 .env 中移除对应行。若子 worktree 没有 .env 则报告并跳过。仅比较键名,不比较值。
- 结果汇总:最后输出目标分支、成功列表(路径与分支)、失败列表(因冲突失败)、每个 worktree 的依赖安装状态(成功/失败/跳过)以及 .env 同步状态(已更新/跳过/无 .env)。
使用方式 该技能在用户提出“rebase worktrees”“sync worktrees”“update all worktrees”“rebase all worktrees onto main”等需求时触发。可选参数为目标分支;省略时以主 worktree 当前分支为目标。执行过程按上述步骤自动完成,冲突时中止当前 worktree 的变基,所有 worktree 处理完毕后统一报告。
适用场景 适合使用 git worktree 并行开发多个分支、需要定期把它们统一变基到主分支并同步依赖与环境变量键名的工作流。
限制 始终在冲突时中止变基,不保留 mid-rebase 状态;主 worktree 不参与变基;不执行 git fetch;依赖安装只在变基成功的 worktree 上运行;.env 同步只比较键名并从主 worktree 复制值,不比较值本身。