用途:执行两步分支交接流程——在次要分支完成工作、推送,再合并进主分支并推送主分支,最后切回次要分支。适用于 dev→main、develop→master 等发布同步,且希望主分支上保留清晰合并提交、同时保留次要分支历史。
主要能力:按规则识别主次分支;检查仓库状态与远程;提交并生成 Conventional Commits 提交信息(英文 type(scope): 前缀加中文摘要);推送次要分支;以 --no-ff 合并到主分支并推送;返回次要分支并报告提交哈希。
使用方式:先用 git status --short、git branch --show-current、git remote -v 检查状态。主分支可用 git symbolic-ref refs/remotes/origin/HEAD 检测,否则优先 main 再 master;次要分支取当前分支或优先 dev 再 develop。切分支时可用 git checkout <secondary_branch> 与 git pull --ff-only origin <secondary_branch>,推送用 git push origin <branch>,合并用 git merge --no-ff <secondary_branch>,冲突时停止并告知需处理的文件。
限制:不适用于单分支提交推送、强制推送、改写历史或 rebase,也不用于生成报告或代码评审。分支名不明、工作区脏、合并冲突或推送被拒时,应停止并报告而非猜测;不使用 --no-verify;除用户明确要求外不得 force-push。