Communitygithub.com

Lev-it/lev-skills

Testgetriebene Entwicklung. Verwende diese Fähigkeit, wenn der Benutzer Funktionen test-first erstellen oder Fehler beheben möchte, 'Rot-Grün-Refaktor' erwähnt oder Integrationstests wünscht.

Was ist lev-skills?

Diese Fähigkeit implementiert eine testgetriebene Entwicklungsmethodik (TDD) mit einem starken Fokus auf Integrationstests und vertikale Entwicklungsschnitte. Sie betont, dass Tests das Verhalten über öffentliche Schnittstellen und nicht Implementierungsdetails validieren sollen, wodurch sie robust gegenüber Refaktoring sind. Der Skill lehnt den Anti-Pattern des horizontalen Slicings ab (alle Tests zuerst schreiben, dann den gesamten Code) und empfiehlt stattdessen einen vertikalen Ansatz mit sogenannten 'Tracer Bullets': Ein Test → eine Implementierung → wiederholen. Der Workflow umfasst Planung (Abstimmung mit dem Benutzer über Schnittstellenänderungen und zu testende Verhaltensweisen), einen inkrementellen Zyklus von Rot (fehlschlagender Test) zu Grün (minimaler Code zum Bestehen) und anschließendes Refactoring. Der Skill ist plattformunabhängig und richtet sich an KI-Agenten, die TDD in Entwicklungsprojekten anwenden, mit spezifischen Regeln wie 'Nie während Rot refaktorieren' und Checklisten zur Sicherstellung von verhaltensorientierten Tests.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/tdd

In Ihrer bevorzugten KI fragen

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

Dokumentation

Testgetriebene Entwicklung

Philosophie

Kernprinzip: Tests sollten Verhalten über öffentliche Schnittstellen validieren, nicht über Implementierungsdetails. Code kann sich vollständig ändern; Tests sollten das nicht.

Gute Tests sind integrationsstilartig: Sie üben echte Codepfade über öffentliche APIs aus. Sie beschreiben, was das System tut, nicht wie es das tut. Ein guter Test liest sich wie eine Spezifikation – „Benutzer kann mit gültigem Warenkorb zur Kasse gehen“ sagt Ihnen genau, welche Fähigkeit existiert. Diese Tests überleben Refactorings, weil sie sich nicht um die interne Struktur kümmern.

Schlechte Tests sind an die Implementierung gekoppelt. Sie mocken interne Kollaborateure, testen private Methoden oder verifizieren über externe Mittel (wie direktes Abfragen einer Datenbank anstatt die Schnittstelle zu verwenden). Das Warnsignal: Ihr Test bricht beim Refactoring, obwohl sich das Verhalten nicht geändert hat. Wenn Sie eine interne Funktion umbenennen und Tests fehlschlagen, haben diese Tests die Implementierung getestet, nicht das Verhalten.

Siehe tests.md für Beispiele und mocking.md für Richtlinien zum Mocken.

Anti-Pattern: Horizontale Schnitte

Schreiben Sie NICHT zuerst alle Tests, dann die gesamte Implementierung. Das ist „horizontales Slicing“ – ROT als „alle Tests schreiben“ und GRÜN als „allen Code schreiben“ zu behandeln.

Das erzeugt miese Tests:

  • Tests, die in großen Mengen geschrieben werden, testen vorgestelltes Verhalten, nicht tatsächliches Verhalten
  • Sie testen am Ende die Struktur von Dingen (Datenstrukturen, Funktionssignaturen) anstatt das benutzerseitige Verhalten
  • Tests werden unempfindlich gegenüber echten Änderungen – sie bestehen, wenn das Verhalten bricht, und schlagen fehl, wenn das Verhalten in Ordnung ist
  • Sie überholen Ihre eigene Erkenntnis, indem Sie sich vor dem Verständnis der Implementierung auf eine Teststruktur festlegen

Korrekte Herangehensweise: Vertikale Schnitte mittels Tracer Bullets. Ein Test → eine Implementierung → wiederholen. Jeder Test reagiert auf das, was Sie aus dem vorherigen Zyklus gelernt haben. Da Sie gerade den Code geschrieben haben, wissen Sie genau, welches Verhalten wichtig ist und wie Sie es verifizieren können.

FALSCH (horizontal):
  ROT:   test1, test2, test3, test4, test5
  GRÜN: impl1, impl2, impl3, impl4, impl5

RICHTIG (vertikal):
  ROT→GRÜN: test1→impl1
  ROT→GRÜN: test2→impl2
  ROT→GRÜN: test3→impl3
  ...

Arbeitsablauf

1. Planung

Beim Erkunden der Codebasis lesen Sie CONTEXT.md (falls vorhanden), damit Testnamen und Schnittstellenvokabular mit der Domänensprache des Projekts übereinstimmen, und respektieren Sie ADRs in dem Bereich, den Sie bearbeiten.

Bevor Sie Code schreiben:

  • Mit dem Benutzer bestätigen, welche Schnittstellenänderungen erforderlich sind
  • Mit dem Benutzer bestätigen, welche Verhaltensweisen zu testen sind (Priorisierung)
  • Möglichkeiten für tiefe Module identifizieren (kleine Schnittstelle, tiefe Implementierung) – führen Sie die Fähigkeit /codebase-design für das Vokabular und die Testbarkeitsprüfungen aus
  • Die zu testenden Verhaltensweisen auflisten (nicht Implementierungsschritte)
  • Zustimmung des Benutzers zum Plan einholen

Fragen Sie: „Wie sollte die öffentliche Schnittstelle aussehen? Welche Verhaltensweisen sind am wichtigsten zu testen?“

Sie können nicht alles testen. Bestätigen Sie mit dem Benutzer genau, welche Verhaltensweisen am wichtigsten sind. Konzentrieren Sie den Testaufwand auf kritische Pfade und komplexe Logik, nicht auf jeden möglichen Randfall.

2. Tracer Bullet

Schreiben Sie EINEN Test, der EINE Sache über das System bestätigt:

ROT:   Test für das erste Verhalten schreiben → Test schlägt fehl
GRÜN: Minimalen Code schreiben, um zu bestehen → Test besteht

Dies ist Ihr Tracer Bullet – beweist, dass der Pfad durchgängig funktioniert.

3. Inkrementelle Schleife

Für jedes verbleibende Verhalten:

ROT:   Nächsten Test schreiben → schlägt fehl
GRÜN: Minimaler Code, um zu bestehen → besteht

Regeln:

  • Ein Test nach dem anderen
  • Nur genug Code, um den aktuellen Test zu bestehen
  • Zukünftige Tests nicht vorwegnehmen
  • Tests auf beobachtbares Verhalten konzentrieren

4. Refactoring

Nachdem alle Tests bestanden sind, nach Refactoring-Kandidaten suchen:

  • Duplikate extrahieren
  • Module vertiefen (Komplexität hinter einfache Schnittstellen verschieben)
  • SOLID-Prinzipien anwenden, wo natürlich
  • Überlegen, was neuer Code über bestehenden Code verrät
  • Tests nach jedem Refactoring-Schritt ausführen

Nie während ROT refaktorieren. Zuerst zu GRÜN gelangen.

Checkliste Pro Zyklus

[ ] Test beschreibt Verhalten, nicht Implementierung
[ ] Test verwendet nur öffentliche Schnittstelle
[ ] Test würde internes Refactoring überleben
[ ] Code ist minimal für diesen Test
[ ] Keine spekulativen Funktionen hinzugefügt

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Verwandte Skills