semantic-merge

Resolve git branch conflicts by behavioral intent with user escalation.

8|2|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/FuZhiyu/superRA --skill semantic-merge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-merge
Source: https://github.com/FuZhiyu/superRA/tree/main/skills/semantic-merge
Command: npx skills add https://github.com/FuZhiyu/superRA --skill semantic-merge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents semantic regressions during merges, rebases, cherry-picks, and branch synchronization by resolving conflicts according to the intended behavior and preserving a documented integration trail.

Core Features & Use Cases

  • Intent-Based Integration: Investigate both branches, classify overlapping changes, and synthesize compatible behavior instead of choosing conflict sides mechanically.
  • Safety and Escalation: Identify data-contract changes, test expectation shifts, generated-output changes, stale references, and other decisions that require user approval.
  • Workflow Support: Handle standalone merges as well as orchestrated workflow synchronization with task-local sync records, reviewer verification, and semantic coherence checks.
  • Use Case: When a feature branch and a baseline branch both modify a data pipeline, use this Skill to inspect their intent, preserve valid changes, escalate conflicting schema decisions, regenerate affected outputs, and verify that stale references are removed.

Quick Start

Ask the semantic-merge skill to integrate the incoming branch into the current branch and report any intent-changing decisions that require approval.

Frequently Asked Questions about semantic-merge

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

FAQPage Schema
How do I resolve git merge conflicts by intent instead of just picking sides?

Semantic merge resolves git merge conflicts by investigating both branches, classifying overlapping changes, and synthesizing compatible behavior rather than mechanically choosing conflict sides. It preserves valid changes across code, data, tests, documentation, and configuration.

What is semantic merge and when do I need it for branch synchronization?

Semantic merge is an intent-based integration technique for branch synchronization that prevents semantic regressions during merges, rebases, and cherry-picks. You need it when overlapping changes affect data contracts, test expectations, or generated outputs.

How do I handle stale references and data-contract changes during a rebase?

During a rebase, stale references and data-contract changes are identified through repository-state inspection and intent classification. Semantic merge escalates conflicting schema decisions requiring user approval, regenerates affected outputs, and verifies stale references are removed.

Can I use semantic merge for orchestrated workflow synchronization with generated outputs?

Yes, semantic merge supports orchestrated workflow synchronization with task-local sync records, reviewer verification, and semantic coherence checks. It handles branch synchronization across code, data, tests, documentation, configuration, and generated outputs.

What's the best way to prevent semantic regressions when both branches modify a data pipeline?

The best way to prevent semantic regressions is intent-based integration that inspects both branches, escalates conflicting schema decisions, regenerates affected outputs, and runs protection-test verification. This preserves valid changes instead of mechanically resolving line-level overlap.

Why does git cherry-pick create semantic regressions and how can I avoid them?

Git cherry-pick creates semantic regressions when line-level overlap obscures behavioral intent changes. Avoid them by classifying overlapping changes, verifying stale references, checking protection tests, and escalating data-contract or test expectation shifts for user approval.