用途
resolve-conflict 用于在 Git 的 rebase 或 merge 过程中解决代码冲突。它的核心目标不是简单选择某一侧,而是先理解每个分支想要实现什么,再产出一个既保留双方意图、又保持代码语法正确的解决结果。
主要能力
- 自动判断当前处于 rebase 还是 merge 状态,并识别所有冲突文件。
- 收集双方分支的上下文,包括正在重放的提交、目标分支的相关变更、双方提交说明等。
- 对每个冲突区域进行三方对比:base(共同祖先)、ours、theirs,从而判断每一侧究竟改了什么、为什么改。
- 将冲突分类为非重叠、互补、竞争、单边四类,并据此选择合并、取优或询问用户。
- 解决后暂存文件,检查是否残留冲突标记和空白问题,并输出结构化的解决摘要与后续命令建议。
使用方式
该技能以技能形式提供,具体安装与调用方式资料中未提供。按其流程,使用时会在发生冲突的仓库中运行,通过 git status 判断操作类型,通过 git show :1:/:2:/:3: 读取三方版本,通过 git diff --check --cached 和 git status 验证结果。默认不会自动提交,也不会执行 git rebase --continue 或 git merge --continue,除非用户明确要求,而是告知用户接下来应运行哪些命令。
适用场景
适用于开发者希望在 rebase 或 merge 时获得更可靠的冲突解决建议,尤其是冲突涉及多处修改、需要理解双方意图、或需要保留双方改动的场景。也适合需要结构化冲突解决报告以便人工复核的情况。
限制与注意事项
- 当双方对同一逻辑做出互斥的有意修改、或涉及无法从代码上下文判断的业务决策时,技能会停下来询问用户,不自行猜测。
- 需要用户注意 ours/theirs 在 rebase 与 merge 下语义相反,解决前需通过提交哈希确认。
- 若 base 版本获取失败(例如文件在双方分支上都是新增),则将两侧均视为全新内容并逻辑合并。
- 该技能不会自动完成提交或继续操作流程,需用户人工确认后执行。