analyze-issue.mdc

GitHub-Issue analysieren und Implementierungs-Spezifikation erstellen

Für wen: Issue-getriebene Teams

Im Detail

Diese Regel nimmt ein GitHub-Issue und verwandelt es in eine strukturierte Implementierungs-Spezifikation — genau der Schritt, der oft übersprungen wird, wenn man direkt von der Issue-Beschreibung in den Code springt. Das reduziert Missverständnisse bei unklaren oder knapp formulierten Issues, weil explizit gemacht wird, was zu tun ist, bevor Code entsteht. Besonders wertvoll für Teams mit vielen externen oder wenig detaillierten Issues, etwa in Open-Source-Projekten. Die erzeugte Spezifikation lässt sich anschließend gut mit implement-task.mdc oder als Grundlage für einen Testplan weiterverarbeiten.

Voraussetzungen

• GitHub-Repository mit Issues, die analysiert werden sollen
• IDE mit Unterstützung für Rules (laut Quelle IDE-übergreifend einsetzbar)

Schritt für Schritt

1. Ein konkretes, insbesondere unklar oder knapp formuliertes Issue auswählen, bevor direkt mit dem Code begonnen wird.
2. Die daraus erzeugte Implementierungs-Spezifikation daraufhin prüfen, ob sie das Issue korrekt und vollständig wiedergibt.
3. Bei externen oder wenig detaillierten Issues gezielt nachfragen bzw. die Spezifikation ergänzen, statt Lücken einfach zu überspringen.
4. Die fertige Spezifikation als Grundlage an implement-task.mdc übergeben oder direkt für einen Testplan nutzen.

Beispiel aus der Praxis

In einem Open-Source-Projekt meldet ein externer Nutzer ein Issue mit nur zwei knappen Sätzen zum Fehlverhalten; die Regel wandelt das Issue in eine strukturierte Spezifikation mit klar benannten Anforderungen um, die anschließend als Basis für die eigentliche Implementierung dient.

Praxis-Tipp

Verweisen Sie einfach auf die Issue-Nummer, z.B. “analysiere Issue #482”, und lassen Sie die Regel daraus eine Spezifikation als Basis für die Umsetzung erzeugen.

Stolperfallen

Bei sehr vagen Issues kann auch die erzeugte Spezifikation Lücken oder Fehlannahmen enthalten, wenn die Ursprungsbeschreibung schlicht nicht genug Informationen liefert – sie ersetzt dann nicht das Nachfragen beim Issue-Ersteller. Wer den Zwischenschritt überspringt und direkt in implement-task.mdc weiterarbeitet, verliert die Möglichkeit, Missverständnisse vor dem Coden zu korrigieren.

Siehe auch

• implement-task.mdc
• test-strategy.md

Lizenz & Quelle

• Lizenz: MIT
• Quelle: github.com/steipete/agent-rules

Lade …