SuperAPI AI 工具集

integrate-branches

编程与开发

查看项目

更新于 10-15 16:53

技能介绍

用途

integrate-branches 用于在主仓库中批量收尾功能分支。它扫描所有活跃的 linked worktree 以及没有 worktree 的本地分支,让用户选择哪些落地,逐一校验工作区干净,依次 merge + push,最后统一清理所有成功合并的 worktree,省去逐个 cd 进目录再手动交付的操作。

主要能力

  • 验证调用上下文:确认 CWD 是主仓库根目录(而非 linked worktree 内部),且当前分支是 main 分支。
  • 确定 main 分支:自动检测;仅在无法确定时询问用户。
  • 扫描候选项:通过 git worktree list --porcelain 与 git branch 发现 linked worktree 和无 worktree 的本地分支,去重后以带类型标识的统一列表呈现。
  • 用户多选:支持 all 或按序号子集选择待合并分支。
  • 预检工作区:worktree 条目用 git -C <path> status --porcelain 检查;branch-only 条目跳过脏检查。所有脏条目在任何合并前统一上报。
  • 顺序 merge + push:对每条选中分支依次执行 pull → merge --no-ff → push,逐条记录 succeeded / failed。
  • 失败处理:合并冲突或推送被拒时停止该条,询问用户继续剩余条目还是中止。
  • 统一清理:仅对成功合并的 worktree 条目执行 git worktree remove;branch-only 条目跳过;失败条目不做清理。
  • 可选分支删除:用户确认后仅使用 git branch -d。
  • 汇总报告:逐条分支输出 merge / push / cleanup / 分支删除状态。

使用方式

技能按以下步骤执行:

  1. 验证调用上下文:比较 git rev-parse --git-dir 与 git rev-parse --git-common-dir,若不同则说明在 linked worktree 内部,停止并提示使用 deliver-feature;若当前分支不是 main 分支,停止并提示切换。
  2. 确定 main 分支:通过 git remote show origin 检测 HEAD branch,失败则检查 origin/main、origin/master,仍无法确定则询问用户。
  3. 扫描并展示可选分支:解析 git worktree list --porcelain 与 git branch,排除 main 分支本身及已被 worktree 覆盖的分支,构建 {path, branch, type} 统一列表,跳过 detached 条目。
  4. 预检:对选中的 worktree 条目检查工作区是否干净,脏条目统一上报并询问 continue / halt。
  5. 批量 merge + push:对干净条目依次执行 git pull origin <main-branch>、git merge --no-ff <branch>、git push origin <main-branch>。
  6. 统一清理:仅对成功的 worktree 条目执行 git worktree remove。
  7. 提供本地分支删除选项:用户确认后执行 git branch -d。
  8. 输出汇总报告。

适用场景

  • 开发者有 2–4 条功能分支(部分在 worktree 中,部分为独立分支)准备一次性落地 main。
  • Sprint 结束批量收尾:在主仓库中合并、推送、清理所有已完成功能分支。
  • CI / 自动化流程生成了多个并行 worktree 加若干 topic 分支,现在汇总结果。

限制

  • 必须在主仓库根目录、main 分支上运行,不能在 linked worktree 内部运行。
  • 不负责单 worktree 交付(请使用 deliver-feature)、提交未提交的变更(请使用 commit-work)、合并前的 rebase 或 squash、解决合并冲突、创建或管理 pull request。
  • 禁止强制推送(--force、--force-with-lease)到任何分支。
  • 禁止在 merge 或 push 失败后移除该 worktree。
  • 禁止自动 stash 未提交变更——预先上报并跳过该 worktree。
  • 禁止使用 git branch -D——仅 -d(安全删除)。
  • 禁止在所有选中条目预检完成前开始任何合并。
  • 并行合并执行不被支持,始终顺序执行。
  • pull 和 push 到 origin 需要网络访问。