Agent Skills › Terry-Mao/AICodingFlow › resolve-merge-conflicts

resolve-merge-conflicts

GitHub

解决Git合并冲突，通过脚本提取未解析路径和冲突片段而非加载完整文件。适用于merge、rebase等操作停止时，或git status显示未合并路径的情况。

.agents/skills/resolve-merge-conflicts/SKILL.md Terry-Mao/AICodingFlow

触发场景

执行 merge, rebase, cherry-pick 或 stash pop 遇到冲突 git status 显示存在 unmerged paths 文件中包含冲突标记（<<<<<<< 等）

安装

npx skills add Terry-Mao/AICodingFlow --skill resolve-merge-conflicts -g -y

更多选项

非标准路径

npx skills add https://github.com/Terry-Mao/AICodingFlow/tree/main/.agents/skills/resolve-merge-conflicts -g -y

不安装直接使用

npx skills use Terry-Mao/AICodingFlow@resolve-merge-conflicts

指定 Agent (Claude Code)

npx skills add Terry-Mao/AICodingFlow --skill resolve-merge-conflicts -a claude-code -g -y

安装 repo 全部 skill

npx skills add Terry-Mao/AICodingFlow --all -g -y

预览 repo 内 skill

npx skills add Terry-Mao/AICodingFlow --list

SKILL.md

Frontmatter

{
    "name": "resolve-merge-conflicts",
    "description": "Resolve Git merge conflicts by extracting only unresolved paths, conflict hunks, and compact diffs instead of loading whole files into context. Use when a merge, rebase, cherry-pick, or stash pop stops on conflicts, when `git status` shows unmerged paths, or when files contain conflict markers."
}

Resolve Merge Conflicts

Overview

Resolve conflicts without opening full files unless the compact view is insufficient. Start with a summary, then inspect one conflicted file at a time.

Workflow

Start with a summary.

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py

Use the summary to identify which files are unresolved, which index stages exist, and how many text hunks each file contains.

Drill into one file.

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py --file path/to/file

Prefer this over reading the whole file. The script prints only nearby context, the ours / base / theirs sections for each hunk, and a compact unified diff between ours and theirs.

Resolve the file.

Take one side wholesale with git checkout --ours -- path/to/file or git checkout --theirs -- path/to/file when appropriate.
Otherwise edit the file directly and remove the conflict markers.
Read more of the file only if the compact output is not enough to decide the correct merge.

Re-check unresolved files.

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py
git diff --name-only --diff-filter=U

Validate the resolution.

Ensure no unmerged paths remain.
Ensure no <<<<<<<, =======, or >>>>>>> markers remain in the resolved files.
Run targeted tests, builds, or linters for the touched area.
Stage the resolved files.

Commands

Summary only

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py

Detailed view for one file

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py --file path/to/file

Detailed view for all conflicted files

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py --all

JSON output

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py --file path/to/file --json

Tune output size

python3 .agents/skills/resolve-merge-conflicts/scripts/extract_conflict_context.py \
  --file path/to/file \
  --context 3 \
  --max-lines 60

Notes

Use the script before opening conflicted files directly.
Resolve one file at a time to keep context small.
Expect marker-based text conflicts and index-only conflicts such as add/add or modify/delete. The script summarizes both, and it falls back to index-stage previews when the worktree file has no conflict markers.