SuperAPI AI 工具集

complete-branch

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:在 GitButler 虚拟分支工作完成、测试通过并准备交付时,把改动合并进 main 分支并清理分支;也适用于创建 PR 或完成堆叠分支。不适用于仍在开发中的分支,堆叠分支需自底向上完成。

主要能力:提供直接合并到 main、Pull Request、堆叠分支三种集成流程,以及合并冲突、推送被拒、撤销集成等错误恢复步骤,并给出集成前检查清单与最佳实践。

必要用法:先确认 GitButler 已初始化、虚拟分支存在且已提交、main 被跟踪、无未提交改动、测试通过。典型步骤为:but status 与 but log 检查状态;but snapshot --message "..." 创建安全快照;git checkout main;git pull origin main;git merge --no-ff refs/gitbutler/<name> -m "...";git push origin main;but branch rm <name>;git checkout gitbutler/workspace。PR 流程使用 git push origin refs/gitbutler/<name>:refs/heads/<name> 与 gh pr create、gh pr merge。堆叠分支按 base → dependent → final 顺序合并,每层后执行 but base update。

限制与注意:合并前必须创建快照,使用 --no-ff 保留历史,操作后返回 gitbutler/workspace,堆叠分支不可先合并中间层,未经确认不要强推 main。冲突需手动解决后 git add 与 git commit;推送被拒先 git pull 再推送;未推送的集成可用 git reset --hard HEAD~1 撤销,已推送用 git revert -m 1 HEAD。紧急恢复可用 but oplog 与 but undo。

适用场景:需要把 GitButler 虚拟分支安全交付到 main、走 PR 评审流程或按顺序完成堆叠分支的开发者。具体平台、收费与效果资料暂未提供。