Communitygithub.com

Lev-it/lev-skills

Bewege Issues durch einen Zustandsautomaten von Triage-Rollen – kategorisiere, reproduziere, hinterfrage falls nötig und erstelle agentenreife Zusammenfassungen.

Was ist lev-skills?

Diese Fähigkeit (Skill) führt einen strukturierten Triage-Prozess für Issues in einem Issue-Tracker ein, der auf einem Zustandsautomaten aus Kategorie- und Zustandsrollen basiert. Entwickler können damit Issues effizient kategorisieren (als Fehler oder Verbesserung), den aktuellen Bearbeitungsstand verwalten (z. B. „Bedarf Triage“, „Bedarf Info“, „Bereit für Agent“, „Bereit für Mensch“) und durch gezieltes Nachfragen und Reproduzieren vollständige, agentenlesbare Aufgabenbeschreibungen erstellen. Der Skill unterstützt die Plattformen Claude Code, Cursor und Codex und wird über den Befehl `/triage` aktiviert. Er umfasst Schritte wie das Sammeln von Kontext, das Empfehlen von Kategorie und Zustand, das Reproduzieren von Fehlern, das strukturierte Nachfragen („Grilling“) mit Hilfe zusätzlicher Skills sowie das Erstellen von Agent Briefs oder Hinweisen für menschliche Bearbeiter. Ziel ist es, den Triage-Prozess zu automatisieren und Issues so aufzubereiten, dass sie von KI-Agenten oder Menschen ohne Rückfragen bearbeitet werden können.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/triage

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 defekt
  • enhancement – neues Feature oder Verbesserung

Fünf Zustands-Rollen:

  • needs-triage – Maintainer muss bewerten
  • needs-info – wartet auf weitere Informationen vom Reporter
  • ready-for-agent – vollständig spezifiziert, bereit für einen AFK-Agenten
  • ready-for-human – benötigt menschliche Implementierung
  • wontfix – 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:

  1. Unmarkiert – nie triagiert.
  2. needs-triage – Bewertung läuft.
  3. needs-info mit 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

  1. 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/*.md und zeige frühere Ablehnungen auf, die diesem Issue ähneln.

  2. 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.

  3. 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.

  4. Hinterfragen (falls nötig). Wenn das Issue ausgearbeitet werden muss, führe die Skills /grilling und /domain-modeling gemeinsam aus – hinterfrage das Issue Schritt für Schritt mit einer Frage nach der anderen, schärfe die Domänenbegriffe und aktualisiere inline CONTEXT.md/ADRs, sobald Entscheidungen getroffen sind.

  5. 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.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Verwandte Skills