用途:分析 Git 分支分歧、在合并前检测潜在冲突,并引导系统化的冲突解决流程,适用于任意 Git 仓库。
主要能力:自动检测当前分支(未指定时)并通过 git rev-parse --show-toplevel 定位仓库根目录,默认目标分支为 origin/main(可用 DEFAULT_TARGET_BRANCH 覆盖)。提供 8 步分析工作流:分支校验、状态与 HEAD 显示、拉取远端、merge-base 提交比较、各分支独有提交分析、两分支改动文件列表、冲突检测(两分支均改动的文件)、尝试自动合并并详细报告。输出采用颜色区分:红为错误与冲突,绿为成功,黄为警告,蓝为分节标题。
使用方式(脚本位于 scripts/ 下): 主编排脚本:./scripts/resolve-merge-conflicts.sh [source-branch] [target-branch] 详细分析:./scripts/analyze-and-merge.sh feature/my-branch origin/main 仅状态检查(不做改动):./scripts/check-merge-status.sh 简单合并:./scripts/simple-merge.sh feature/my-branch origin/main 参数默认:source-branch 为当前分支,target-branch 为 origin/main。 环境变量:DEFAULT_TARGET_BRANCH 覆盖目标分支;NO_COLOR=1 关闭颜色(适合 CI 日志);AUTO_ABORT_ON_CONFLICT=1 冲突时自动中止。
适用场景:特性分支的合并冲突解决、创建 PR 前的预合并分析、理解分支分歧、教学演示、CI/CD 自动化流程、多人协作频繁冲突的团队。
限制与注意:不适合代替人工判断的自动冲突解决,也不用于 rebase、交互式冲突解决(git mergetool)或 cherry-pick。合并前应确保工作目录干净(先 commit 或 stash);冲突时按提示编辑 <<<<<<< 等标记文件,git add 后 git merge --continue,可用 git merge --abort 回退,或用 git reset --hard ORIG_HEAD 恢复。脚本需可执行权限:chmod +x skills/merge-conflict-resolver/scripts/*.sh。许可证为 MIT,版本 v1.0.0(2025-11-17)。