用途:将当前功能分支变基到最新基础分支,保持分支与主干同步,减少合并冲突累积。
主要能力与使用方式:
- 前置校验:运行 git rev-parse --abbrev-ref HEAD 检测当前分支;若为 main、master 或 develop,则提示已在基础分支并停止。基础分支由脚本 ${CLAUDE_SKILL_DIR}/scripts/detect-base-branch.sh 检测,失败则提示未找到并停止。用 git status --porcelain 检查未提交改动;若有,会询问用户选择“暂存并变基”(推荐,变基前 git stash,之后 git stash pop)或取消。
- 拉取与检查:执行 git fetch origin <base-branch> --quiet,再用 git merge-base HEAD origin/<base-branch> 与 git rev-parse origin/<base-branch> 比较;若一致则说明已是最新并停止。
- 变基:执行 git rebase origin/<base-branch>。成功后用 git rev-list --count origin/<base-branch>..HEAD 报告领先提交数;发生冲突时执行 git rebase --abort 中止,若此前暂存过则用 git stash pop 恢复,并提示用户手动执行 git rebase origin/<base-branch> 解决冲突。
注意事项:分支若已推送到远程,变基会改写历史,成功后需强制推送 git push --force-with-lease;git stash pop 可能与变基后的提交重叠而产生冲突,失败时可用 git stash show 查看暂存内容;处于 detached HEAD 状态时应提示用户并停止,不要尝试变基;基础分支本地不存在但在远程存在时,第 2 步的 fetch 会创建远程跟踪引用,变基使用 origin/<base-branch> 而非本地分支。该技能只管理 git 状态,不修改项目文件;若曾暂存改动,即使变基失败也必须恢复。