merge

Überblick über den merge skill

Wofür der merge skill gedacht ist

Der merge skill ist ein AgentHub-Workflow-Skill, der nach einer Multi-Agent-Coding-Session das Gewinnerergebnis eines Agents in einen Git-Basis-Branch übernimmt. Er ist für den Befehl /hub:merge ausgelegt und konzentriert sich auf eine konkrete Aufgabe: den ausgewählten Gewinner mergen, unterlegene Versuche für spätere Prüfung erhalten, Session-Worktrees aufräumen und eine Zusammenfassung nach dem Merge schreiben.

Am besten geeignet für Git-Workflows

Nutze diesen merge skill, wenn dein Repository dem AgentHub-Muster mit Session-IDs, Agent-Branches, Evaluation-Rankings und temporären Worktrees folgt. Am nützlichsten ist er nach /hub:eval, wenn bereits feststeht, welcher Agent die beste Lösung geliefert hat, und du statt manuellem Branch-Wechsel, Merge, Tagging der unterlegenen Branches und Worktree-Löschung einen wiederholbaren Git-Workflow möchtest.

Was ihn von einem generischen Merge-Prompt unterscheidet

Ein generischer Prompt sagt vielleicht nur „merge den besten Branch“. Dieser Skill beschreibt dagegen eine klare operative Konvention: den höchstbewerteten Agent verwenden, sofern kein --agent angegeben ist, mit --no-ff mergen, nicht gewinnende Branches mit Tags im Format hub/archive/... archivieren, deren Branch-Refs löschen und .agenthub/board/results/merge-summary.md erzeugen. Diese Struktur reduziert Unklarheiten beim Aufräumen — genau dort werden Multi-Agent-Git-Sessions häufig unübersichtlich.

Hinweise vor der Installation

Der Skill setzt voraus, dass dein Projekt bereits AgentHub-artige Branches wie hub/{session-id}/{agent-id}/attempt-1 und Evaluation-Ausgaben besitzt, aus denen sich ein Gewinner ableiten lässt. Wenn dein Team AgentHub nicht nutzt, ist die Merge-Anleitung weiterhin als Modell für strukturiertes Aufräumen lesbar, muss aber vor sicherem Einsatz angepasst werden.

So verwendest du den merge skill

merge installieren und zuerst diese Dateien prüfen

Installiere den Skill aus dem GitHub-Skill-Repository mit:

npx skills add alirezarezvani/claude-skills --skill merge

Prüfe anschließend die Quelle unter:

engineering/agenthub/skills/merge/SKILL.md

Dieser Skill scheint vollständig in SKILL.md enthalten zu sein; in der Skill-Verzeichnisvorschau sind keine sichtbaren begleitenden Ordner wie rules/, resources/ oder scripts/ vorhanden. Da die Upstream-Anweisungen session_manager.py erwähnen, solltest du vor dem Verlassen auf automatisches Cleanup prüfen, wo dieses Skript in deinem lokalen AgentHub-Setup liegt.

Grundlegende Nutzung von merge

Typische Aufrufe sind:

/hub:merge
/hub:merge 20260317-143022
/hub:merge 20260317-143022 --agent agent-2

Verwende /hub:merge, wenn die zuletzt evaluierte Session das Ziel ist. Gib eine Session-ID an, wenn mehrere AgentHub-Sessions existieren. Ergänze --agent nur dann, wenn du das höchstplatzierte Ergebnis aus /hub:eval bewusst übersteuerst — etwa weil der Top-Score eine Sicherheits-, Kompatibilitäts- oder Produktanforderung verfehlt hat, die im menschlichen Review aufgefallen ist.

Welche Eingaben der Skill benötigt

Für eine zuverlässige merge-Nutzung braucht der Agent:

• den Ziel-Basis-Branch, normalerweise den Branch, in den die Gewinnerarbeit übernommen werden soll.
• die AgentHub-Session-ID, sofern die neueste Session nicht eindeutig ist.
• einen Gewinner, entweder aus dem neuesten Evaluation-Ranking oder über --agent.
• vorhandene Branch-Refs im erwarteten Format: hub/{session-id}/{agent-id}/attempt-1.
• die Berechtigung, Git-Operationen auszuführen, die Merge-Commits, Tags und Branch-Löschungen erstellen.

Ein stärkerer Prompt wäre: „Run /hub:merge 20260317-143022 --agent agent-2 into main. Before merging, confirm the working tree is clean, show the winning branch ref, tag losing branches for archive, and write the merge summary.“ Damit hat der Skill genug operativen Kontext und muss weniger raten.

Praktischer Workflow vor und nach dem Ausführen

Führe vor dem Merge-Aufruf git status aus, stelle sicher, dass du keine unabhängigen lokalen Änderungen mitführst, und prüfe den Diff des Gewinner-Branches. Kontrolliere nach dem Merge die Merge-Commit-Message, bestätige, dass Archiv-Tags erstellt wurden, und prüfe, ob .agenthub/board/results/merge-summary.md die Session, Aufgabe und den Gewinner korrekt abbildet. Wenn Konflikte auftreten, löse sie wie normale Git-Konflikte; der Skill liefert die Workflow-Struktur, ersetzt aber kein Code-Review.

FAQ zum merge skill

Ist merge nur für AgentHub gedacht?

Ja, praktisch gesehen. Der merge skill ist rund um AgentHub-Konventionen für Benennung, Evaluation und Cleanup geschrieben. Er kann als Vorlage für einen manuellen Git-Workflow in anderen Multi-Branch-Experimenten dienen, die direkte Nutzung erwartet aber AgentHub-Session-Branches und Ergebnis-Metadaten.

Wählt merge automatisch den besten Code aus?

Er verwendet den Agent, den du mit --agent angibst, oder andernfalls den höchstbewerteten Agent aus dem letzten /hub:eval. Das bedeutet: Die Qualität des Merges hängt von der Qualität der vorherigen Evaluation ab. Wenn deine Bewertungskriterien unvollständig waren, solltest du den Gewinner vor dem Merge manuell prüfen.

Was passiert mit den unterlegenen Branches?

Der vorgesehene Workflow archiviert jeden unterlegenen Agent-Branch mit einem Git-Tag wie hub/archive/{session-id}/{agent-id} und löscht anschließend den Branch-Ref. Dadurch bleiben die Commits erreichbar, während Branch-Unordnung reduziert wird. Teams mit Aufbewahrungsrichtlinien sollten die Benennung der Archiv-Tags bestätigen, bevor sie den Skill übernehmen.

Wann sollte ich diesen Skill nicht verwenden?

Verwende merge nicht, wenn Branch-Namen nicht der AgentHub-Konvention folgen, der Basis-Branch unklar ist, der Gewinner noch nicht geprüft wurde oder dein Repository automatisierte Branch-Löschungen verbietet. Für Squash-only-Workflows ist der Skill ebenfalls schlecht geeignet, sofern du den Merge-Befehl nicht anpasst, da das Standardmuster des Skills git merge --no-ff verwendet.

So verbesserst du den merge skill

Bessere merge-Ergebnisse durch klareren Kontext

Der merge skill funktioniert am besten, wenn deine Anfrage die Session-ID, den Gewinner, den Basis-Branch und alle Policy-Einschränkungen enthält. Zum Beispiel: „Merge session 20260317-143022, winner agent-2, into develop; keep losing branches archived with tags, do not delete remote branches, and stop if tests fail.“ Das ist besser als „merge den Gewinner“, weil Auswahl, Ziel, Cleanup und Sicherheitsregeln getrennt benannt werden.

Häufige Fehlerquellen, auf die du achten solltest

Die wichtigsten Risiken sind mehrdeutige neueste Sessions, fehlende Evaluation-Ergebnisse, ein nicht sauberer Working Tree, Branch-Refs, die nicht dem erwarteten Muster entsprechen, und Cleanup-Befehle, die von Dateien außerhalb dieses Skill-Verzeichnisses abhängen. Ein weiteres wichtiges Risiko ist, einen Gewinner zu mergen, der technisch besteht, aber fachlich oder produktseitig falsch ist. Behandle /hub:eval als Auswahlgrundlage, nicht als Ersatz für das abschließende Review.

merge an deine Repository-Richtlinien anpassen

Wenn dein Team Squash-Merges, signierte Commits, geschützte Branches, Pull Requests, CI-Gates oder die Aufbewahrung von Remote-Branches verlangt, passe den Workflow an, bevor du ihn in Produktion verwendest. Die wahrscheinlichsten Anpassungspunkte sind die Merge-Strategie, das Format der Archiv-Tags, ob Branch-Löschung nur lokal erfolgen soll, und welche Felder in merge-summary.md Pflicht sind.

Nach dem ersten Durchlauf iterieren

Bitte den Agent nach der ersten Ausgabe um Verifikation, statt ihn blind weitermachen zu lassen: „Show the merge commit, list archive tags for this session, confirm no AgentHub worktrees remain, and summarize any conflicts or skipped cleanup.“ So wird aus der Merge-Anleitung ein prüfbarer Git-Workflow, und du erkennst unvollständiges Cleanup, bevor die Session in Vergessenheit gerät.