SuperAPI AI 工具集

integrate-worktrees

通用与其它

查看项目

更新于 10-16 06:50

技能介绍

用途:从主仓库主分支批量收尾多个 worktree。它会扫描全部活动的关联 worktree,让用户多选要落地的分支,预检干净状态后依次合并、推送,并统一清理成功的 worktree,免去逐个 cd 进目录交付。

主要能力:

  • 校验调用上下文(须在主仓库根目录且处于主分支);
  • 自动探测主分支,无法判断时询问用户;
  • 用 git worktree list --porcelain 扫描并列出候选;
  • 用户多选后,合并前一次性预检所有选中 worktree 是否干净;
  • 对干净的 worktree 依次执行 git pull origin <主分支>、git merge --no-ff、git push origin <主分支>;
  • 合并与推送都成功的才统一执行 git worktree remove 清理;
  • 可选删除分支,仅用 git branch -d(安全删除);
  • 输出每个 worktree 的合并/推送/清理/分支删除状态汇总表。

关键命令(保持原样):git rev-parse --git-dir;git rev-parse --git-common-dir;git rev-parse --abbrev-ref HEAD;git rev-parse --show-toplevel;git remote show origin | grep 'HEAD branch';git worktree list --porcelain;git -C <path> status --porcelain;git merge --no-ff <branch>;git push origin <main-branch>;git worktree remove <path>;git branch -d <branch>。

适用场景:开发者有 2–4 个功能 worktree 待落地;冲刺末批量清理;CI 并行生成多个隔离 worktree 后收集结果。

限制与边界:必须在主仓库主分支运行,从关联 worktree 或非主分支运行会暂停并提示;不处理单 worktree 交付、提交未提交改动、rebase/squash、解决冲突、创建 PR;禁止 force-push;不自动 stash,脏 worktree 会被跳过;仅安全删除分支,不用 -D;合并或推送失败时不清理该 worktree;始终串行执行;需要网络访问 origin。

使用方式:按技能流程在当前主仓库根目录触发,按提示选择要整合的 worktree 编号(或 all),预检有脏目录时选择 continue 或 halt,随后按提示确认是否删除分支。