用途:在 Git 合并冲突时,避免直接打开整个文件,先用紧凑视图定位和理清冲突,再逐个文件解决。
主要能力:附带脚本 extract_conflict_context.py 可输出冲突摘要(哪些文件未解决、存在哪些索引阶段、每个文件有多少文本冲突片段);可针对单个文件或全部冲突文件输出附近上下文、每个片段的 ours / base / theirs 内容,以及 ours 与 theirs 之间的紧凑 unified diff;也支持 JSON 输出,并可用 --context 和 --max-lines 调节输出大小。能处理基于标记的文本冲突,以及 add/add、modify/delete 等仅索引冲突;当工作区文件没有冲突标记时,回退到索引阶段预览。
使用方式:先运行 python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py 查看摘要;再对单个文件运行 python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py --file path/to/file。解决时可按需整体采用某一侧:git checkout --ours -- path/to/file 或 git checkout --theirs -- path/to/file,否则直接编辑并删除冲突标记。之后用脚本和 git diff --name-only --diff-filter=U 复查,确认无未合并路径、无 <<<<<<<、=======、>>>>>>> 标记,并针对改动区域运行相关测试、构建或检查,最后暂存解决后的文件。
适用场景:合并、变基或拉取后出现冲突,需要在有限上下文下逐文件处理。
限制:仅在紧凑输出不足以判断正确合并结果时,才应读取更多文件内容;应逐文件解决以保持上下文小。其他细节暂未提供。