用途:当功能分支 diff 过大(约 400 行以上)、评审者要求缩小 PR,或想让大型特性分步可评审时,split-branch 帮助把一个大分支拆成一串堆叠式 PR/MR:除最底层外,每个 PR 都以上一个为目标分支,而不是都指向 main。
主要能力:拆分前用 analyze.sh 统计加权评审行数(源码行 + 测试行/2),排除锁文件、生成代码与 vendor 目录;按预算设计拆分方案,并提供 extract.sh 从原分支提取文件生成新分支,自动创建带时间戳的本地备份。策略上优先提取纯重构,其次按架构分层(schema→repository→service→API→frontend)自底向上拆,也可按垂直切片,或用特性开关让中间层先合入。
使用方式:先确认工作区干净并确定 ORIG_BASE;运行 analyze.sh 后向用户展示拆分计划并获得明确批准;再用 extract.sh 配合 git rebase --onto 逐个拆分,随后依次推送新分支、用 --force-with-lease 强推原分支、通知评审者、创建草稿 PR、把原 PR 重定向到新的栈顶,最后只把最底层 PR 标记为 ready。可与 updating-pr、using-git-worktrees、finishing-a-development-branch 配合。
限制与注意:目标默认约 300 行源码,硬上限 600 行;加权行数低于 200 时通常无需拆分。分支保护若禁止强推,应改为新建分支与新 PR。rebase 会改写 SHA,签名提交需重新签名;冲突时不自动解决。具体价格、收费与平台支持范围暂未提供。