CommunitySchreiben & Editierengithub.com

AnjanJ/shipkit

Besseren Code mit Claude ausliefern. Skills, Agents, Regeln und Wissensdatenbanken für Claude Code. Spiegel von codeberg.org/AnjanJ/shipkit

Was ist shipkit?

Der Skill `/qa – Quality Assurance Workflow` automatisiert den QA-Prozess für kürzlich geänderte Dateien oder ein bestimmtes File. Er führt Nutzer in fünf Phasen durch: Erkundung (Test-Framework erkennen, Risikoklassifizierung), gezielte Fragen an den Entwickler, Erstellung eines strukturierten Testplans, Schreiben der Tests nach Best Practices sowie Ausführung und Verifikation. Unterstützt werden gängige Frameworks wie RSpec, Minitest, ExUnit, Jest, Vitest und Playwright. Der Fokus liegt auf risikobasierter Priorisierung und pragmatischen Fragen – etwa zu Zahlungslogik oder externen APIs – anstatt trivialer Rückfragen. Tests werden nach Arrange-Act-Assert aufgebaut, mit einer Assertion pro Test und beschreibenden Namen. Die abschließende QA-Report-Bewertung lautet entweder „SHIP IT“, „FIX AND RE-TEST“ oder „NEEDS REWORK“. Ideal für Claude Code, Cursor oder Codex Agenten, die konsistente und gründliche Code-Qualitätssicherung benötigen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/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

  1. Test-Framework erkennen durch Prüfen auf:
    • Gemfile mit rspec/minitest → RSpec oder Minitest
    • mix.exs → ExUnit
    • package.json mit jest/vitest → Jest oder Vitest
    • playwright.config → Playwright
  2. Geänderte Dateien identifizieren – wenn $ARGUMENTS ein Dateipfad ist, diesen verwenden; ansonsten git diff --name-only HEAD~1 ausführen
  3. 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
  4. 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.
  5. Eine Kontexttabelle erstellen:
DateiTypRisikoVorhandene 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

  1. Happy Path – erwartete Eingaben erzeugen erwartete Ausgaben
  2. Grenzfälle – Randwerte, leere Eingaben, Maximalwerte, nil/null
  3. Fehlerfälle – ungültige Eingaben, Netzwerkfehler, Timeouts, Berechtigungsfehler
  4. Bizarre/Adversarial – SQL-Injection-Strings, Script-Tags, Emojis, 10MB große Zeichenketten, gleichzeitiger Zugriff
  5. Leistung – N+1-Abfragen, unbegrenzte Sammlungen, langsame Abfragen (nur bei KRITISCH/HOHEM Risiko)
  6. Integration – Interaktionen zwischen Komponenten (nur wenn mehrere Dateien geändert wurden)

Als Tabelle präsentieren:

#KategorieTestbeschreibungRisikostufe
1Happy PathErstellt Datensatz mit gültigen ParameternHOCH
............

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" nicht it "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

  1. Die neuen Spezifikationen ausführen – gezielter Lauf (nur die neue Datei)
  2. Fehler beheben – Fehler lesen, Quelle lesen, Ursache beheben
  3. Die gesamte Suite ausführen – sicherstellen, dass nichts anderes kaputtgegangen ist
  4. Den QA-Bericht erstellen – Siehe @reference.md für Berichtsvorlage, Kernwerte-Audit und Rationalisierungsprüfung.

Urteil: SHIP IT / FIX AND RE-TEST / NEEDS REWORK

Verwandte Skills