create-github-issues-for-unmet-specification-requirements

Über create-github-issues-for-unmet-specification-requirements

Dieses Skill automatisiert die Erstellung von GitHub-Issues für Anforderungen in einer Spezifikationsdatei, die noch nicht im Code-Repository implementiert wurden. Es schließt die Lücke zwischen geschriebenen Spezifikationen und geliefertem Code, indem es nicht erfüllte Anforderungen systematisch in nachverfolgbare, umsetzbare Issues umwandelt und so die Wahrscheinlichkeit verringert, dass dokumentierte Bedürfnisse unbemerkt unter den Tisch fallen.

Der Arbeitsablauf ist kompakt: Er analysiert die Spezifikationsdatei, um alle Anforderungen zu extrahieren, prüft im Code-Repository den Implementierungsstatus jeder Anforderung, sucht nach bestehenden Issues (über search_issues), um Duplikate zu vermeiden, und erstellt für jede nicht implementierte Anforderung ein neues Issue (über create_issue) unter Verwendung der feature_request.yml-Vorlage des Repositorys, wobei auf die Standardvorlage zurückgegriffen wird, falls diese fehlt. Jedes Issue sollte eine klare Zuordnung von Anforderungs-ID und Beschreibung, Implementierungshinweise sowie Akzeptanzkriterien enthalten, versehen mit entsprechenden Labels wie „feature“ oder „enhancement“. Die Statusprüfung umfasst die Suche im Code-Repository nach verwandten Mustern, die Überprüfung zugehöriger Spezifikationsdateien im Verzeichnis /spec/ und die Bestätigung, dass eine Anforderung nicht bereits teilweise implementiert ist.

Es richtet sich an Entwickler, Tech Leads und Projektverantwortliche, die mit Spezifikationsdokumenten arbeiten und ihr Issue-Tracker mit nicht erfüllten Anforderungen synchron halten möchten. Typische Anwendungsfälle umfassen das Aufbauen eines Backlogs aus einer neuen Spezifikation, den Abgleich einer Spezifikation mit einem bestehenden Code-Repository sowie die Sicherstellung, dass jede Anforderung über ein nachverfolgbares Issue verfügt. Dies ist ein schlanker Lese- und Erstellungsarbeitsablauf: Er liest die Spezifikation und den Code und erstellt GitHub-Issues über Standard-Tools, ohne zerstörerische Operationen, Credential-Handling oder Code-Ausführung, was ihn als risikominimiert ausweist.

FAQ

Was erzeugt dieses Skill?

Ein GitHub-Issue pro nicht implementierter Anforderung, die in der Spezifikation gefunden wird, jeweils mit Anforderungs-ID und Beschreibung, Implementierungshinweisen, Akzeptanzkriterien und entsprechenden Labels wie „feature“ oder „enhancement“.

Wie vermeidet es die Erstellung doppelter Issues?

Vor der Erstellung von Issues sucht es nach bestehenden Issues (unter Verwendung von search_issues) und überprüft, dass jede Anforderung nicht bereits im Code-Repository implementiert oder teilweise implementiert ist.

Welche Issue-Vorlage verwendet es?

Es verwendet die feature_request.yml-Vorlage des Repositorys und greift auf die Standardvorlage zurück, falls diese nicht verfügbar ist.

Wie stellt es fest, ob eine Anforderung implementiert ist?

Es sucht im Code-Repository nach verwandten Code-Mustern und prüft zugehörige Spezifikationsdateien im Verzeichnis /spec/, um den Implementierungsstatus zu bewerten.

Stellt ich die Spezifikationsdatei bereit?

Ja. Das Skill arbeitet mit einer Spezifikationsdatei, auf die es verwiesen wird, und extrahiert vor der Prüfung des Implementierungsstatus alle Anforderungen daraus.