triage

Übersicht über die triage skill

Was triage macht

triage ist eine GitHub-Issue-Triage-skill für das Weiterleiten eingehender Issues durch einen zustandsbasierten, rollenbasierten State Machine-Prozess. Sie hilft dabei, Meldungen einzuordnen, zu entscheiden, ob noch Informationen fehlen, und Aufgaben entweder an einen AFK-Agenten oder an einen menschlichen Maintainer weiterzugeben. Wenn Sie eine triage skill für Issue Tracking brauchen, soll sie Unsicherheiten reduzieren und die Bearbeitung von Issues konsistent halten.

Für wen triage am besten passt

Nutzen Sie die triage skill, wenn Sie eine stark frequentierte Issue-Queue verwalten, einen wiederholbaren Intake-Prozess wollen oder eine strukturierte Methode brauchen, um aus unklaren Bugreports handlungsfähige Aufgaben zu machen. Besonders nützlich ist sie, wenn Sie bug von enhancement trennen und jedes Issue dann in needs-triage, needs-info, ready-for-agent, ready-for-human oder wontfix verschieben müssen.

Was triage anders macht

Der wichtigste Unterschied ist die explizite State Machine plus Rollendisziplin. Die skill macht nicht einfach nur „Issue zusammenfassen“, sondern erwartet genau eine Kategorie-Rolle und genau eine Zustandsrolle. Außerdem gibt es eine harte Vorgabe, dass jeder triage-Kommentar oder jede Issue-Nachricht mit einem Disclosure-Hinweis beginnen muss. Das ist relevant, wenn Sie vorhersehbare Ausgaben, richtlinienbewusste Weiterleitung und einen triage-Workflow brauchen, der sauber an einen anderen Agenten übergeben werden kann.

Wie man die triage skill verwendet

Installation und erste Lektüre

Installieren Sie mit:

npx skills add mattpocock/skills --skill triage

Beginnen Sie für die triage-Installation mit SKILL.md und lesen Sie dann AGENT-BRIEF.md und OUT-OF-SCOPE.md. Diese Dateien erklären das langlebige Brief-Format und wie abgelehnte Ideen dokumentiert werden — genau die beiden Punkte, die die tatsächliche triage-Qualität am stärksten beeinflussen. Das Repo enthält keine Hilfsskripte oder zusätzlichen Referenzordner, daher sind diese drei Dateien die praktische Grundlage.

Die richtige Eingabe für die skill geben

Die Nutzung von triage funktioniert am besten, wenn Sie den Issue-Titel, den Body, vorhandene Labels und das genaue Ziel des triage-Durchlaufs angeben. Gute Eingaben sagen der skill, ob Sie eine Klassifizierung, mehr Informationen, ein Agent-Briefing oder eine endgültige Ablehnungsentscheidung brauchen.

Gutes Prompt-Muster:

• „Triagiere dieses GitHub-Issue. Ordne es als bug oder enhancement ein, wähle die passende Zustandsrolle und sage, ob es an einen AFK-Agenten gehen oder bei einem Menschen bleiben soll.“
• „Hier ist der Issue-Thread und die aktuellen Labels. Wende die triage-State-Machine an und formuliere den Kommentar mit dem erforderlichen Disclaimer.“
• „Das ist zu unpräzise. Entscheide, ob es in needs-info oder ready-for-agent gehört, und erkläre die fehlenden Acceptance Criteria.“

Den Workflow nutzen, nicht nur das Label

Ein praktischer triage-Leitfaden ist, die Ausgabe als Routing zu behandeln, nicht als bloße Taxonomie. Zuerst bestätigen, ob das Issue ein Bug oder eine Enhancement-Anfrage ist. Dann prüfen, ob es umsetzbar, durch Rückfragen beim Melder blockiert oder ausdrücklich außerhalb des Scopes liegt. Wenn es für Agentenarbeit bereit ist, sollte das Briefing Verhaltensanforderungen und Acceptance Criteria beschreiben, nicht Dateipfade oder Umsetzungsschritte.

Auf die Repository-Regeln achten

Zwei Details wirken sich deutlich auf die Qualität der Ausgabe aus: die Disclaimer-Pflicht und die Regel „genau eine Kategorie-Rolle plus genau eine Zustandsrolle“. Wenn der Status des Issues unklar ist, soll die skill den Konflikt markieren und den Maintainer fragen, bevor sie etwas anderes ändert. Das ist der richtige Moment, anzuhalten und zu klären, statt ein Label zu erzwingen.

triage skill FAQ

Ist triage nur für GitHub-Issue-Labels?

Nein. Die skill ist zwar auf GitHub-ähnliches Issue Tracking ausgerichtet, aber die eigentliche Aufgabe ist, den Issue-Status zu entscheiden und Arbeit weiterzuleiten. Wenn Ihr Tracker andere Label-Bezeichnungen verwendet, bleiben die kanonischen Rollen dennoch wichtig, und Sie mappen sie vor dem Einsatz auf Ihr System.

Brauche ich das, wenn ich einen normalen Prompt schreiben kann?

Ein normaler Prompt kann ein einzelnes Issue klassifizieren, aber die triage skill bringt ein wiederholbares Statusmodell, ein Muster für Brief-Erstellung und eine explizite Behandlung von Out-of-Scope-Fällen mit. Das ist wertvoll, wenn Sie konsistente Entscheidungen über viele Issues hinweg wollen und nicht nur eine einmalige Zusammenfassung.

Ist triage anfängerfreundlich?

Ja, wenn Sie grundlegende Issue-Labels bereits verstehen. Die triage skill ist einfacher zu verwenden als ein maßgeschneiderter Policy-Prompt, weil sie Ihnen sagt, welche Zustände es gibt und was jeder Übergang bedeutet. Der größte Anfängerfehler ist, den Issue-Kontext wegzulassen und nur ein Label zu verlangen — ohne Body, ohne Diskussion und ohne aktuellen Status.

Wann sollte ich triage nicht verwenden?

Verwenden Sie triage nicht für tiefgehende Implementierungsplanung oder Code Review. Sie ist für Intake, Routing und Entscheidungen zur Einsatzbereitschaft gedacht. Wenn das Issue bereits eine vollständige Spezifikation hat und Sie Design- oder Coding-Hilfe brauchen, passt eine andere skill oder ein direkter Implementierungs-Prompt besser.

So verbessern Sie die triage skill

Mehr Issue-Kontext liefern

Die triage skill wird besser, wenn Sie den vollständigen Issue-Body, sichtbare Kommentare, aktuelle Labels und alle Maintainer-Notizen mitgeben. Ein bloßer Titel führt oft zu schwachem Routing, weil die skill dann nicht erkennen kann, ob der Bericht reproduzierbar ist, schon beantwortet wurde oder entscheidende Details fehlen.

Genau die Entscheidung abfragen, die Sie wirklich brauchen

Wenn Ihr Ziel „ready for agent“ ist, sagen Sie das. Wenn Ihr Ziel ist „sollte das als wontfix geschlossen werden“, formulieren Sie das direkt. Die stärkste Nutzung von triage ist präzise beim Entscheidungskriterium, weil die skill dann auf den richtigen Status optimieren kann, statt eine generische Zusammenfassung zu erzeugen.

Die Qualität der Übergabe verbessern

Wenn ein Issue nach ready-for-agent verschoben wird, bitten Sie um ein Agent-Briefing, das Verhalten, Constraints und Acceptance Criteria in langlebiger Sprache festhält. Vermeiden Sie Dateiebene-Implementierungsanweisungen, außer Sie brauchen sie wirklich; die Repository-Guidance bevorzugt Verhaltensverträge, weil sie Codebase-Drift überstehen.

Den ersten Durchlauf iterativ verbessern

Wenn der erste triage-Durchlauf zu vorsichtig ausfällt, schärfen Sie ihn mit einer von drei Ergänzungen nach: Reproduktionsschritte, erwartetes vs. tatsächliches Verhalten oder warum das Issue für Nutzer relevant ist. Solche Details entscheiden oft darüber, ob das Issue in needs-info, ready-for-human oder wontfix gehört, und machen die triage skill im zweiten Durchlauf deutlich entschlossener.