用途:该技能用于处理堆叠或相互依赖的 Pull Request,包括解析拓扑、父 PR 合入后的 retarget 与 rebase、拆分分支,以及规划落地顺序。
主要能力与规则:拓扑关系来自 base 分支——当 B.base.ref == A.head.ref 时,PR B 是 PR A 的子项;不要根据标题、标签或描述约定推断堆叠关系。遇到以下情况应停止并报告:循环(两个 PR 互以对方 head 为 base)、孤儿(base 分支已不存在,通常因父项合并后分支被删而孙项仍指向它)、跨堆叠依赖(PR X 逻辑上需要 PR Y,但 Y 不是 X 的祖先,此时应记录为落地顺序约束)。
父项合入后的处理顺序:1) 将每个后代的 base 重定向到已合并 PR 的 base;2) 把后代 head rebase 到新 base;3) push --force-with-lease;4) 等待 CI 重跑后再处理下一层。不要颠倒 2 与 1,也不要跳过 4。
Force-push 安全:始终使用 --force-with-lease,绝不用普通 --force;lease 失败说明他人已推送,应停止并报告,不要改用 --force。任何情况下都不要对受保护分支强推。删除父分支前先检查后代,否则会使整条堆叠成为孤儿。
拆分分支:按优先级选择接缝,如数据→服务→API→UI、增量→切换→清理、纯重构→行为变更、新模块→调用点、依赖升级→适配;每个切片必须能独立构建并通过测试。
落地顺序:优先落地后代需要最少 rebase 的 PR;先落地同一文件的就地编辑,再做重命名。恢复已合并的指定分支可从最新默认分支重新拉取,命令为 git fetch origin <default> 与 git checkout -B <branch> origin/<default>。