用途:在功能分支工作全部完成、准备合并或做收尾清理时使用。流程分阶段执行,强调验证先行与显式确认。
主要能力: 1)验证门禁:任何合并或创建 PR 前,必须先调用 verification-before-completion,确认全部测试(单元、集成、e2e)、lint、构建通过,且没有应提交的未跟踪文件;验证失败即停止,不得带失败测试合并或建 PR。 2)确定目标分支:用 git branch -a | grep -E 'remotes/origin/(main|master|develop)$' 等命令自动探测 main/master/develop;多候选或无候选时须询问用户。随后 git fetch origin 并用 git log HEAD..<base-branch> --oneline 检查落后情况,按分歧程度决定正常进行、建议 rebase 或警告。 3)合并选项:固定提供四个选项且不增删——A 创建 PR、B 普通合并、C 压缩合并(squash)、D 保持现状;等待用户选择,不假定默认。 4)执行:A 用 git push -u origin <branch-name> 与 gh pr create --title "<title>" --body "<body>";B 用 git checkout <base-branch>、git merge <feature-branch>、git branch -d <feature-branch>;C 用 git merge --squash 后 git commit,再删除本地分支;D 仅提示保留及恢复命令。 5)清理:如使用 worktree,用 git worktree remove 与 git worktree prune;B/C 情况下可 git push origin --delete <branch-name>;最后用 git status 与 git log --oneline -5 确认状态。
需要显式确认的操作:合并入目标分支、squash 合并、删除本地分支、删除远端分支、强制移除 worktree、rebase 到更新后的基线。
限制与反模式:不得跳过验证、不得自动选择合并策略、不得未经确认删除分支、不得在 CI 失败时建 PR、squash 消息不得只取最后一次提交、PR 创建后避免 force-push。冲突时报告并交用户解决,不自动解决;测试失败立即停止。该技能为 RIGID 类型,须按阶段顺序完整执行。