github/penpot
1
0
Fork 0
mirror of https://github.com/penpot/penpot.git synced 2026-09-14 07:59:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
penpot/.opencode/skills/resolve-git-conflicts/SKILL.md
Andrey Antukh 59c8a690da ♻️ Add when to use sections to all skills 
Every skill in .opencode/skills now carries a "When to use" section:
triggers in any phrasing plus the matching /command for the flow
skills, one-line triggers for the utility skills, an
explicit-invocation mirror for ste, and the proactive case for
resolve-git-conflicts.

code-review-criteria drops its old usage bullets ("before merging any
PR ...") for the same role pattern as plan-review-criteria: loaded by
the reviewer subagent of the review-code flow, redirect there to
review code. Flow and criteria skills no longer compete for the same
trigger.

AI-assisted-by: omen-alpha
2026-09-08 21:12:28 +02:00

3.0 KiB
Raw Blame History

name, description
name description
resolve-git-conflicts Conflict resolution flow — understand the local git conflicts, present a resolution plan, and resolve them after the user approves it. Never continues the rebase. Use it when the repo has unresolved conflicts (rebase, merge, cherry-pick) or the user asks to resolve them.

Resolve Git Conflicts

Resolve conflicts in the local repository. The user handles finishing the rebase themselves — you must never run git rebase --continue, git rebase --skip, git merge --continue, or anything similar.

When to use

  • The repository has unresolved conflicts — during a rebase, merge, or cherry-pick — whether the user asks about them or not.
  • The user asks to resolve conflicts, in any phrasing: "fix the merge conflicts", "resolve these", "what's conflicting here?".

Phase 1 — Understand the problem (read-only)

  1. Run git status to detect the conflict state (rebase, merge, cherry-pick, etc.) and list conflicted files.
  2. For each conflicted (unmerged) file, understand the situation without modifying anything:
    • Read the file and identify the conflict markers (<<<<<<<, =======, >>>>>>>).
    • Inspect both sides — git show <ours>:<file> and git show <theirs>:<file> — plus git log/git show on the commits involved to understand intent.
    • Identify what each side changed and why, and how they should be combined.

Phase 2 — Present the resolution plan

  1. Present a clear plan to the user before touching any file. For each conflicted file, state:
    • What each side changed and why.
    • Your proposed resolution and the reasoning behind it.
    • How the two sides are combined (both additive → merge; both modify the same code → keep the semantically correct version, merging intent from both sides when clear from code and context).
  2. Ask the user only when genuinely unclear. Do not ask about anything you can determine yourself from the code, commit messages, or context. Only decisions that are not determinable and change the outcome (e.g. conflicting product decisions, which side to discard) warrant a question. Collect all such questions together in an "Open Questions" section at the end of the plan, so the user has full context to answer them properly.
  3. Wait for the user to accept the plan (and answer any open questions) before editing, staging, or otherwise modifying anything.

Phase 3 — Execute

  1. Resolve each conflicted file by editing the file to the agreed merged content and removing all conflict markers.

Phase 4 — Stage and verify

  1. Stage every resolved file with git add <file>. Do not stage unrelated untracked files unless clearly part of the resolution.
  2. Verify no conflict markers remain (search for <<<<<<< / >>>>>>> in resolved files) and that git status shows no unmerged paths.

Phase 5 — Report

  1. Briefly report the conflict state, how each conflicted file was resolved (and any answers received to open questions), and stop — do not run git rebase --continue or any other continuation command.