用途:将 origin/main 的最新提交合并进当前本地分支,并处理合并冲突,常被称为 update-branch,供 Codex 在需要同步功能分支时使用。
主要流程与能力:先确认 git 工作区是否干净,必要时提交或暂存;启用 rerere(git config rerere.enabled true、git config rerere.autoupdate true);确认 origin 远端存在且当前分支是接收合并的分支;执行 git fetch origin;先用 git pull --ff-only origin $(git branch --show-current) 同步远端同名功能分支;再合并主分支,推荐 git -c merge.conflictstyle=zdiff3 merge origin/main 以获得更清晰的冲突上下文;解决冲突后 git add 相关文件并 git commit(或 git merge --continue),最后按项目规范验证并总结合并。
冲突处理建议:先用 git status、git diff、git diff --merge 查看冲突,也可用 git diff :1:path :2:path 和 git diff :1:path :3:path 对比 base 与双方意图;理解双方改动的目标与共享意图,先决定最终行为再改代码,尽量保留不变量、API 契约和用户可见行为;采用最小且保留意图的编辑,逐文件解决并分批跑测试;仅当确定一方应完全胜出时才用 ours/theirs;生成文件先解决源码冲突再重新生成;导入冲突不明确时可先保留双方导入,合并后靠 lint/type 检查清理;完成后用 git diff --check 确认无冲突标记。
何时询问用户:仅在无法安全、可逆地自行决定时才问,例如结果依赖产品意图、涉及用户可见契约或迁移、两种设计技术上等值、会产生数据丢失或不可逆副作用、分支目标或远端名称无法本地确定。否则应尽力决策、记录理由并继续。
限制:该技能未提供收费、价格、平台或效果等信息,暂未提供。