/qa – Qualitätssicherungs-Workflow
Führe diesen Skill aus, um eine gründliche QA für kürzliche Änderungen oder eine bestimmte Datei durchzuführen.
Kürzlich geänderte Dateien
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "keine kürzlichen Änderungen erkannt"
Phase 1: Erkundung
- Test-Framework erkennen durch Prüfen auf:
Gemfilemit rspec/minitest → RSpec oder Minitestmix.exs→ ExUnitpackage.jsonmit jest/vitest → Jest oder Vitestplaywright.config→ Playwright
- Geänderte Dateien identifizieren – wenn
$ARGUMENTSein Dateipfad ist, diesen verwenden; ansonstengit diff --name-only HEAD~1ausführen - Jede Datei nach Risikostufe klassifizieren:
- KRITISCH: Authentifizierung, Zahlungen, Datenmodelle, gemeinsame Hilfsprogramme, API-Endpunkte
- HOCH: Geschäftslogik, Services, Controller
- MITTEL: Views, Serialisierer, Helfer, Konfiguration
- NIEDRIG: Dokumentation, Kommentare, Formatierung
- Jede geänderte Datei und ihre vorhandenen Tests (falls vorhanden) lesen. Wenn mehr als ~5 Dateien geändert wurden, das Lesen an den
codebase-explorer-Agenten delegieren und mit dessen Zusammenfassung arbeiten – den Hauptkontext für die Fragen und die Tests behalten. - Eine Kontexttabelle erstellen:
| Datei | Typ | Risiko | Vorhandene Tests? |
|---|---|---|---|
| ... | ... | ... | ... |
Phase 2: Befragung
Bevor Tests geschrieben werden, 3-8 Sondierungsfragen mit AskUserQuestion stellen. Fragen bündeln – nicht einzeln stellen.
Gute Fragen (risikoorientiert):
- „Dies betrifft den Zahlungsfluss – soll ich Grenzfälle bei Rückerstattungen testen?“
- „Die neue Validierung lehnt leere Eingaben ab. Was ist mit Unicode-only-Zeichenketten?“
- „Dieser Service ruft eine externe API auf – soll ich sie mocken oder Integration testen?“
Schlechte Fragen (diese nicht stellen):
- „Was macht dieser Code?“ (selbst lesen)
- „Soll ich Tests schreiben?“ (ja, immer)
- „Welches Test-Framework soll ich verwenden?“ (selbst erkennen)
Phase 3: Testplan
Einen strukturierten Testplan VOR dem Schreiben von Spezifikationen präsentieren. Nach Kategorie organisieren:
Testkategorien
- Happy Path – erwartete Eingaben erzeugen erwartete Ausgaben
- Grenzfälle – Randwerte, leere Eingaben, Maximalwerte, nil/null
- Fehlerfälle – ungültige Eingaben, Netzwerkfehler, Timeouts, Berechtigungsfehler
- Bizarre/Adversarial – SQL-Injection-Strings, Script-Tags, Emojis, 10MB große Zeichenketten, gleichzeitiger Zugriff
- Leistung – N+1-Abfragen, unbegrenzte Sammlungen, langsame Abfragen (nur bei KRITISCH/HOHEM Risiko)
- Integration – Interaktionen zwischen Komponenten (nur wenn mehrere Dateien geändert wurden)
Als Tabelle präsentieren:
| # | Kategorie | Testbeschreibung | Risikostufe |
|---|---|---|---|
| 1 | Happy Path | Erstellt Datensatz mit gültigen Parametern | HOCH |
| ... | ... | ... | ... |
Auf Benutzerfreigabe warten, bevor fortgefahren wird.
Phase 4: Spezifikationen schreiben
Spezifikationen nach diesen Mustern schreiben:
- Eine Assertion pro Test (wenn praktikabel)
- Aussagekräftige Namen –
it "gibt 404 zurück, wenn Datensatz nicht gefunden"nichtit "funktioniert" - Arrange-Act-Assert-Struktur
- Keine versteckten Daten – alle Testdaten im Test sichtbar
- Verhalten testen, nicht Implementierung – private Methoden nicht direkt testen
- Fabriken/Fixtures dem Framework entsprechend verwenden
- Nach Verhalten gruppieren mit
describe/context-Blöcken
Testcode-Qualität
Tests sind auch Code – dieselben Prinzipien anwenden:
- KISS: Keine überkonstruierten Testhelfer. Wenn Setup >10 Zeilen ist, Test oder getesteten Code vereinfachen.
- YAGNI: Keine Szenarien testen, die nicht eintreten können. Keine Tests „nur für den Fall“ für unmögliche Zustände hinzufügen.
- DRY (mit Zurückhaltung): Klare Duplizierung gegenüber cleveren geteilten Beispielen bevorzugen. Ein Test sollte von oben nach unten lesbar sein, ohne zu drei Hilfsdateien springen zu müssen.
- Sauberer Code: Aussagekräftige Testnamen, die wie Dokumentation lesbar sind. Keine versteckten Daten – alle Daten im Test sichtbar.
Siehe @reference.md für frameworkspezifische Testnotizen (RSpec, Minitest, ExUnit, Jest/Vitest).
Phase 5: Ausführung und Verifikation
- Die neuen Spezifikationen ausführen – gezielter Lauf (nur die neue Datei)
- Fehler beheben – Fehler lesen, Quelle lesen, Ursache beheben
- Die gesamte Suite ausführen – sicherstellen, dass nichts anderes kaputtgegangen ist
- Den QA-Bericht erstellen – Siehe @reference.md für Berichtsvorlage, Kernwerte-Audit und Rationalisierungsprüfung.
Urteil: SHIP IT / FIX AND RE-TEST / NEEDS REWORK