Triage
Bewege Issues im Issue-Tracker des Projekts durch einen kleinen Zustandsautomaten von Triage-Rollen.
Jeder Kommentar oder jedes Issue, das während des Triage-Prozesses im Issue-Tracker veröffentlicht wird, muss mit folgendem Haftungsausschluss beginnen:
> *Dies wurde während des Triage-Prozesses von KI generiert.*
Referenzdokumente
- AGENT-BRIEF.md – wie man dauerhafte Agenten-Zusammenfassungen erstellt
- OUT-OF-SCOPE.md – wie die Wissensdatenbank
.out-of-scope/funktioniert
Rollen
Zwei Kategorie-Rollen:
bug– etwas ist defektenhancement– neues Feature oder Verbesserung
Fünf Zustands-Rollen:
needs-triage– Maintainer muss bewertenneeds-info– wartet auf weitere Informationen vom Reporterready-for-agent– vollständig spezifiziert, bereit für einen AFK-Agentenready-for-human– benötigt menschliche Implementierungwontfix– wird nicht umgesetzt
Jedes triagierte Issue sollte genau eine Kategorie-Rolle und eine Zustands-Rolle tragen. Falls sich Zustands-Rollen widersprechen, melde dies und frage den Maintainer, bevor du etwas anderes tust.
Dies sind die kanonischen Rollennamen – die tatsächlichen Label-Strings im Issue-Tracker können abweichen. Die Zuordnung sollte dir mitgeteilt worden sein – falls nicht, führe /setup-matt-pocock-skills aus.
Zustandsübergänge: Ein unmarkiertes Issue geht normalerweise zuerst zu needs-triage; von dort geht es zu needs-info, ready-for-agent, ready-for-human oder wontfix. needs-info kehrt zu needs-triage zurück, sobald der Reporter antwortet. Der Maintainer kann jederzeit eingreifen – melde ungewöhnliche Übergänge und frage vor dem Fortfahren.
Aufruf
Der Maintainer ruft /triage auf und beschreibt in natürlicher Sprache, was er möchte. Interpretiere die Anfrage und handle. Beispiele:
- „Zeig mir alles, was meine Aufmerksamkeit erfordert“
- „Schauen wir uns Issue #42 an“
- „Verschiebe #42 zu ready-for-agent“
- „Was ist bereit für Agenten?“
Zeige, was Aufmerksamkeit benötigt
Durchsuche den Issue-Tracker und präsentiere drei Kategorien, älteste zuerst:
- Unmarkiert – nie triagiert.
needs-triage– Bewertung läuft.needs-infomit Reporter-Aktivität seit den letzten Triage-Notizen – erneute Bewertung erforderlich.
Zeige Anzahl und eine einzeilige Zusammenfassung pro Issue. Lass den Maintainer auswählen.
Triage eines bestimmten Issues
-
Kontext sammeln. Lies das gesamte Issue (Text, Kommentare, Labels, Reporter, Daten). Analysiere vorhandene Triage-Notizen, um bereits geklärte Fragen nicht erneut zu stellen. Erkunde die Codebasis mithilfe des domänenspezifischen Glossars des Projekts und beachte ADRs im entsprechenden Bereich. Lies
out-of-scope/*.mdund zeige frühere Ablehnungen auf, die diesem Issue ähneln. -
Empfehlen. Teile dem Maintainer deine Kategorie- und Zustandsempfehlung mit Begründung sowie eine kurze, auf das Issue bezogene Zusammenfassung der Codebasis mit. Warte auf Anweisung.
-
Reproduzieren (nur bei Fehlern). Versuche vor jeglichem Hinterfragen eine Reproduktion: Lies die Schritte des Reporters, verfolge den relevanten Code, führe Tests oder Befehle aus. Berichte, was passiert ist – erfolgreiche Reproduktion mit Codepfad, fehlgeschlagene Reproduktion oder unzureichende Details (ein starkes
needs-info-Signal). Eine bestätigte Reproduktion ergibt eine viel stärkere Agenten-Zusammenfassung. -
Hinterfragen (falls nötig). Wenn das Issue ausgearbeitet werden muss, führe die Skills
/grillingund/domain-modelinggemeinsam aus – hinterfrage das Issue Schritt für Schritt mit einer Frage nach der anderen, schärfe die Domänenbegriffe und aktualisiere inlineCONTEXT.md/ADRs, sobald Entscheidungen getroffen sind. -
Ergebnis anwenden:
ready-for-agent– poste einen Agent Brief-Kommentar (AGENT-BRIEF.md).ready-for-human– gleiche Struktur wie ein Agent Brief, aber füge hinzu, warum es nicht delegiert werden kann (Ermessensentscheidungen, externer Zugriff, Designentscheidungen, manuelle Tests).needs-info– poste Triage-Notizen (Vorlage unten).wontfix(Fehler) – höfliche Erklärung, dann schließen.wontfix(Verbesserung) – schreibe in.out-of-scope/, verlinke darauf in einem Kommentar, dann schließen (OUT-OF-SCOPE.md).needs-triage– wende die Rolle an. Optionaler Kommentar bei Fortschritten.
Schnelle Zustandsänderung
Wenn der Maintainer sagt „verschiebe #42 zu ready-for-agent“, vertraue ihm und wende die Rolle direkt an. Bestätige, was du gleich tun wirst (Rollenänderungen, Kommentar, Schließen), und handle dann. Überspringe das Hinterfragen. Wenn du zu ready-for-agent wechselst, ohne eine Hinterfragungs-Sitzung durchgeführt zu haben, frage, ob der Maintainer einen Agent Brief schreiben möchte.
Vorlage für Needs-Info
## Triage-Notizen
**Was wir bisher festgestellt haben:**
- Punkt 1
- Punkt 2
**Was wir noch von dir (@reporter) benötigen:**
- Frage 1
- Frage 2
Halte alles fest, was während des Hinterfragens unter „bisher festgestellt“ geklärt wurde, damit die Arbeit nicht verloren geht. Fragen müssen spezifisch und umsetzbar sein, nicht „bitte gib weitere Informationen“.
Wiederaufnahme einer vorherigen Sitzung
Wenn bereits Triage-Notizen zum Issue vorhanden sind, lies sie, prüfe, ob der Reporter offene Fragen beantwortet hat, und präsentiere ein aktualisiertes Bild, bevor du fortfährst. Stelle keine bereits geklärten Fragen erneut.