merge-resolve

Resolves git merge conflicts using cross-checked semantic analysis with operator-confirmed application.

Updated Jul 12, 2026
One-click install
npx skills add https://github.com/sumitake/agent-collab --skill merge-resolve-sumitake
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: merge-resolve
Source: https://github.com/sumitake/agent-collab/tree/main/plugins/agent-collab/skills/merge-resolve
Command: npx skills add https://github.com/sumitake/agent-collab --skill merge-resolve-sumitake

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Resolving git merge conflicts requires understanding the intent of both conflicting sides, and manual resolution is error-prone when two branches modify the same region. This Skill analyzes both sides' intent, proposes a unified resolution as a diff, and gates any change behind operator confirmation so nothing touches the working tree without approval. ## Core Features & Use Cases - Semantic conflict analysis: Parses conflict markers, gathers commit context from both branches, and dispatches a cross-check review that returns a COMPATIBLE, INCOMPATIBLE, or NEEDS-HUMAN verdict with a proposed unified diff. - Operator-confirm gate with opt-in auto-apply: Auto-apply requires a policy file, high reviewer confidence, forbidden-paths clearance, and required validator gates; sensitive paths like migrations, secrets, and auth files always require manual confirmation. - Post-apply validation: Verifies no conflict markers remain and runs operator-defined gates such as the project test suite. - Use Case: After a git rebase exits with conflict markers in a shared handler file, ask the assistant to resolve the conflict; it analyzes both sides' intent, proposes a diff, and waits for your apply or reject decision. ## Quick Start Ask the assistant to resolve the current git merge conflict by analyzing both branches' intent and proposing a unified resolution for your approval.

Frequently Asked Questions about merge-resolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve a git merge conflict with AI assistance?▼

Run this Skill after a merge or rebase exits with conflict markers. It parses the conflicted hunks, gathers commit context from both branches, and proposes a unified diff that you approve, reject, or revise before anything is applied to the working tree.

Can AI merge conflict resolution apply changes automatically?▼

Auto-apply is opt-in and requires four preconditions: an operator-approved policy file, high reviewer confidence, no forbidden-path matches, and all required validator gates present. Otherwise every resolution waits for explicit operator confirmation.

Does this Skill commit or push the resolved merge?▼

No. The Skill ends at applying the resolution to the working tree after operator confirmation. Committing and pushing remain the operator's actions; the only exception is the apply-and-amend option that amends an in-progress merge commit.

When should I not use AI-based merge conflict resolution?▼

Skip it for trivial conflicts like whitespace-only changes or deterministic merges of generated files, where git mergetool is sufficient. High-sensitivity paths such as migrations, secrets, and auth files always require manual operator review.

What happens if the proposed merge resolution fails to apply?▼

The Skill first checks the patch with git apply --3way --check, then falls back to in-place file replacement. After applying, it re-reads the file to confirm no conflict markers remain and refuses to mark the merge resolved if any persist.