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