Was macht validate-changes-match-specs?
Validiere, dass die Implementierung eines Branches oder Pull Requests mit den eingeführten Produkt-, technischen, Sicherheits- und verwandten Spezifikationen übereinstimmt. Verwende dies beim Überprüfen oder Abschließen einer spezifikationsgesteuerten Änderung und beim Beheben von Abweichungen zwischen eingecheckten Spezifikationen und der Implementierung.
Funktionsweise
- Analysiert Änderungen im Branch/PR im Vergleich zu den referenzierten Spezifikationen.
- Erkennt Abweichungen zwischen spezifiziertem und implementiertem Verhalten.
- Unterstützt gängige Spezifikationsformate wie Markdown und YAML.
- Gibt eine strukturierte Zusammenfassung der gefundenen Diskrepanzen aus.
Verwendung
- Führe den Skill im Kontext eines Branches oder Pull Requests aus.
- Der Skill extrahiert die relevanten Spezifikationen aus dem Repository.
- Er vergleicht die Spezifikationen mit den Codeänderungen.
- Bei Abweichungen werden diese klar benannt und können manuell oder automatisiert behoben werden.
Voraussetzungen
- Der Branch/PR muss Spezifikationsdateien enthalten (z. B.
specs/-Verzeichnis). - Git muss auf dem System installiert sein.
- Der Skill benötigt Lesezugriff auf das Repository.
Beispiel
# Ausführen des Skills
skill validate-changes-match-specs --branch feature/my-spec-change
Fehlerbehebung
- Stelle sicher, dass alle Spezifikationen vor dem Ausführen committet sind.
- Bei fehlenden Spezifikationen wird eine Warnung ausgegeben.
- Kontaktiere den Skill-Autor bei wiederholten Fehlern.