Pflicht-Präsenz von UNH und UNT pro Nachricht validieren
This commit is contained in:
52
skills/asv-small-step/SKILL.md
Normal file
52
skills/asv-small-step/SKILL.md
Normal file
@@ -0,0 +1,52 @@
|
||||
---
|
||||
name: asv-small-step
|
||||
description: Verwende diesen Skill, wenn im ASV-Format-Validator ein neuer kleiner fachlicher Spezifikationsschritt umgesetzt werden soll. Der Skill erzwingt minimale Änderungen, Schutz des bestehenden Projektstands, keinen Parser-Umbau und vollständige Tests.
|
||||
license: Proprietary
|
||||
metadata:
|
||||
project: asv-format-validator
|
||||
language: de
|
||||
---
|
||||
|
||||
# ASV Small Step
|
||||
|
||||
## Zweck
|
||||
Dieser Skill ist für kleine, klar abgegrenzte Implementierungsschritte im Projekt ASV-Format-Validator gedacht.
|
||||
|
||||
## Verbindliche Arbeitsweise
|
||||
- Implementiere genau **eine** neue fachliche Regel oder einen eng abgegrenzten Stabilisierungsschritt.
|
||||
- Baue strikt auf dem bestehenden Projektstand auf.
|
||||
- Kein Parser-Umbau.
|
||||
- Keine EDIFACT-Neuinterpretation auf Verdacht.
|
||||
- Keine neue Validator-Hierarchie auf Verdacht.
|
||||
- Keine Refactorings auf Verdacht.
|
||||
- Bestehende Regeln und Tests dürfen nicht semantisch verbogen werden.
|
||||
|
||||
## Architekturregeln
|
||||
- Bevorzuge minimale Ergänzungen in bestehenden Klassen.
|
||||
- Für Strukturregeln bevorzuge Ergänzungen im bestehenden `DefaultStructureValidator`, solange keine ausdrückliche Gegenanweisung vorliegt.
|
||||
- Neue Klassen nur dann, wenn technisch zwingend nötig und sehr klein.
|
||||
|
||||
## Sprach- und Stilregeln
|
||||
- Technische Bezeichner auf Englisch.
|
||||
- Kommentare, JavaDoc und benutzernahe Fehlermeldungen auf Deutsch.
|
||||
- Vollständigen, kompilierbaren Code liefern.
|
||||
|
||||
## Testregeln
|
||||
- Für den neuen Schritt gezielte Tests ergänzen.
|
||||
- Testdaten so gestalten, dass sie die neue Regel isoliert prüfen.
|
||||
- Keine unnötigen Zusatzfehler in Testressourcen erzeugen.
|
||||
- Nach der Umsetzung vollständig testen mit:
|
||||
- `mvn clean test`
|
||||
|
||||
## Wenn Tests fehlschlagen
|
||||
- Nicht nur den ersten Fehler beheben.
|
||||
- Alle fehlschlagenden Tests gemeinsam analysieren.
|
||||
- Nach gemeinsamer Ursache gruppieren.
|
||||
- Alle zugehörigen Korrekturen in einem Durchgang umsetzen.
|
||||
|
||||
## Ausgabeformat
|
||||
1. Ausgeführter Maven-Befehl
|
||||
2. Kurzes Testergebnis
|
||||
3. Sehr kurze Liste der geänderten Dateien
|
||||
4. Vollständiger Code aller tatsächlich geänderten Dateien
|
||||
5. Keine langen Erklärungen
|
||||
Reference in New Issue
Block a user