用途:在上游分支改动后,自动探测并逐个变基所有下游分支(包括同级兄弟分支),使依赖分支树保持同步。
主要能力:自动探测下游分支链(含线性链与带兄弟分支的树),按深度优先前序输出 branch:parent;逐个 checkout 并执行 git rebase --fork-point <parent-branch>,以父分支 reflog 定位真实分叉点,避免重复提交与假冲突;尽量智能解决冲突,解决后 git add 并 git rebase --continue;每个分支运行 /preflight 预检(含格式、gn_check、presubmit、构建与测试);最后回到原分支并汇总结果。
使用方式:先确认当前分支与状态(git branch --show-current、git status --short),用 bash .claude/skills/rebase-downstream/detect-chain.sh <current-branch> 探测下游链,向用户展示分支树并确认后再开始。依次对每个下游分支执行 git checkout、git rebase --fork-point、必要时冲突处理与预检,全部成功后 git checkout 回原分支。
限制:无法解决的冲突应执行 git rebase --abort 并立即停止,不继续下一个分支;任何分支预检失败也立即停止;不得跳过预检;不得强制推送,推送由用户决定。