用途:在 Git 合并或变基产生冲突时,帮助定位并解决冲突,而不必打开完整文件。核心思路是先看摘要,再逐个文件深入,保持上下文精简。
主要能力:脚本 extract_conflict_context.py 可输出未解决文件、索引阶段信息、每个文件的文本冲突片段数量;针对单个文件时,只打印附近上下文、每个片段的 ours/base/theirs 内容,以及 ours 与 theirs 之间的紧凑 unified diff。支持 --all 查看全部冲突文件、--json 输出 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,确认无未合并路径、无 <<<<<<<、=======、>>>>>>> 标记,并对涉及区域运行针对性测试、构建或 lint,最后暂存已解决文件。
适用场景:合并、变基等产生冲突的仓库操作,尤其是希望减少上下文占用、逐个文件处理时。
限制:仅在资料所述脚本与命令范围内使用;若紧凑输出不足以判断正确合并,才需读取更多文件内容。资料未提供安装方式、依赖要求、支持平台或收费信息。