git-workflow-merge

Resolves merge conflicts when merging a base branch into a feature branch.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-merge-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow-merge
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/git-workflow-merge
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill git-workflow-merge-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Merging a moved-ahead base branch into a long-lived feature or epic branch produces conflicts, stale PR descriptions, and silently duplicated backlog entries. This Skill defines the exact merge order, per-file-kind conflict resolution techniques, and post-merge verification steps so the branch returns to a mergeable state without losing work or breaking bot-signed commit rules. ## Core Features & Use Cases - Ordered merge procedure: Fetch, merge with bot signature variables set inline, and enumerate conflicts with git diff --diff-filter=U before resolving anything. - Per-file-kind resolution table: Different strategies for code, generated files, specs in docs/specs/, rule companions, and the backlog work list, each paired with its check command (check:dupes, check:specs, check:board). - Post-merge verification: Grep for leftover conflict markers, re-read and patch the PR body via the REST API, verify issue state for non-default-base merges, and check branch lag with the compare endpoint. - Use Case: A PR is marked conflicting after main advanced. You merge origin/main in with the bot signature, resolve a spec conflict by keeping both sides, deduplicate the backlog entry against the issue queue, rerun the text checks, and update the PR body before calling it ready. ## Quick Start Ask the assistant to merge the base branch into the current branch and resolve the conflicts following the git-workflow-merge pattern.

Frequently Asked Questions about git-workflow-merge

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

FAQPage Schema
How do I resolve git merge conflicts when updating a branch with main?

Fetch origin, merge the base with bot signature variables set inline on the merge command, then list conflicts with git diff --diff-filter=U. Resolve each file by its kind: code, generated files, specs, and backlog lists each use a different technique.

How do I cherry-pick a commit from a deleted branch?

Run git cherry-pick with GIT_COMMITTER_NAME and GIT_COMMITTER_EMAIL set inline so the committer is the bot, not a person. Cherry-pick preserves the original author but sets the caller as committer, and push checks reject person-signed committers.

Why does my push get rejected after a merge commit?

The merge commit was signed by a person because the signature variables were missing from the merge command itself. Since the merge command creates the commit directly, this is fixed by rebasing onto main, not by editing the single commit.

Does keeping both sides work for all merge conflicts?

No. Keeping both sides is correct for specs and rule companion files where both sides appended, but wrong for code and the backlog work list. A section removed by one side of a spec stays removed, and backlog entries must be checked against the issue queue first.

How do I check if a PR is behind the main branch before merging?

Call the GitHub compare API endpoint repos/<owner>/<repo>/compare/<main>...<branch> and read the behind_by field. Zero means ready; above zero means merge main in, rerun the checks, and treat previous green runs as stale.