kotlin-testing

Überblick über die kotlin-testing-Skill

Wofür kotlin-testing gedacht ist

Die kotlin-testing-Skill ist ein praxisnaher Leitfaden zum Schreiben und Verbessern von Tests in Kotlin-Projekten. Im Mittelpunkt stehen die Aufgaben, die die meisten Teams tatsächlich lösen müssen: den passenden Kotest-Stil auswählen, Abhängigkeiten mit MockK mocken, Coroutines korrekt testen und Property-Based Tests sowie Kover-Coverage nutzen, ohne den Testcode in Boilerplate ausufern zu lassen.

Wer sie installieren sollte

Installiere die kotlin-testing-Skill, wenn du Tests zu einer Kotlin-App hinzufügst, den Testansatz im Team standardisieren willst oder einen TDD-freundlichen Workflow suchst, der zu idiomatischem Kotlin passt. Besonders nützlich ist sie für Entwickler in JVM-Kotlin-Projekten, die wiederholbare Muster brauchen statt ad hoc formulierter Test-Prompts.

Wo sie am besten passt

Diese Skill passt zu Aufgaben der Testautomatisierung, bei denen zuverlässige Unit- oder Component-Abdeckung das Ziel ist, nicht das Setup eines End-to-End-Frameworks. Sie hilft, wenn du den ersten Test schreiben, fragile Assertions refaktorieren oder verstehen musst, wie sich Code mit Mocks und Coroutines auf Kotlin-spezifische Weise isolieren lässt.

So verwendest du die kotlin-testing-Skill

kotlin-testing in deiner Arbeitsumgebung installieren

Nutze für die Skill den Repository-Installationsfluss und richte deinen Agenten dann auf den Kontext skills/kotlin-testing aus, bevor du nach Testcode fragst. Der im Repo gezeigte Baseline-Installationsbefehl lautet:
npx skills add affaan-m/everything-claude-code --skill kotlin-testing

Für die besten Ergebnisse installierst du die Skill in derselben Arbeitsumgebung, in der der Kotlin-Code liegt, damit sie gegen echte Dateien, Paketnamen und Build-Tooling arbeiten kann.

Gib der Skill ein testbares Kotlin-Ziel

Die kotlin-testing-Skill funktioniert am besten, wenn dein Prompt genau ein konkretes Ziel und ein gewünschtes Testergebnis nennt. Gute Eingaben sind etwa der Klassen- oder Funktionsname, das Framework, das du bereits verwendest, sowie Einschränkungen wie Coroutine-Verhalten, Mocking-Regeln oder Coverage-Schwellen.

Beispiel für die Prompt-Struktur:
Use kotlin-testing to write Kotest tests for UserService.createUser. Mock the repository with MockK, cover success and duplicate-email failure paths, and keep the tests compatible with our Gradle/Kover setup.

Lies zuerst die richtigen Dateien

Beginne mit SKILL.md und sieh dir dann README.md, AGENTS.md, metadata.json sowie vorhandene Ordner wie rules/, resources/, references/ oder scripts/ an. In diesem Repo ist SKILL.md die maßgebliche Quelle; der schnellste Weg ist daher, vor dem Formulieren von Prompts zuerst die Abschnitte „When to Use“, „How It Works“ und „Examples“ zu lesen.

Nutze den Workflow, nicht nur die Snippets

Das Repo ist auf einen Test-first-Workflow ausgerichtet: Ziel identifizieren, eine Kotest-Spezifikation schreiben, Abhängigkeiten mocken, den fehlschlagenden Test ausführen, den Code implementieren und anschließend die Coverage mit ./gradlew koverHtmlReport prüfen. Dadurch wird die Skill besonders hilfreich, wenn du einen Ausführungsplan brauchst und nicht nur Beispiel-Assertions.

FAQ zur kotlin-testing-Skill

Ist kotlin-testing nur für TDD?

Nein. TDD ist der Standard-Workflow in der Skill, aber die Muster sind auch nützlich, wenn du bestehendem Kotlin-Code nachträglich Tests hinzufügst. Wenn bereits Implementierungscode vorhanden ist, kannst du die Skill nutzen, um fokussierte Abdeckung und sauberere Mocks zu ergänzen.

Ersetzt das einen normalen Prompt?

Sie verbessert einen normalen Prompt deutlich, wenn du Kotlin-spezifische Entscheidungen treffen musst: welchen Kotest-Stil du wählen solltest, wie Coroutines zu mocken sind und wie Coverage einzuordnen ist. Ein allgemeiner Prompt kann Tests schreiben, aber kotlin-testing reduziert das Rätselraten bei Framework-Passung und Teststruktur.

Ist sie anfängerfreundlich?

Ja, wenn du eine einzelne Kotlin-Unit oder Klasse beschreiben kannst und einen geführten Testplan möchtest. Weniger hilfreich ist sie, wenn du dein Build-System nicht kennst, noch kein Testziel definiert hast oder statt konkretem Testcode eher allgemeine Architekturberatung brauchst.

Wann sollte ich kotlin-testing nicht verwenden?

Nutze sie nicht als Ersatz für Browser-Automation, API-Contract-Tests oder andere Test-Stacks außerhalb von Kotlin. Wenn dein Problem vor allem in Infrastruktur, instabilen Integrationsumgebungen oder Testdatenmanagement liegt, passt eine breiter angelegte Testautomations-Skill besser als kotlin-testing.

So verbesserst du die kotlin-testing-Skill

Gib mehr Kontext als nur „schreibe Tests“

Die besten Ergebnisse mit kotlin-testing entstehen durch präzise Eingaben: die Klasse unter Test, öffentliche Methoden, wichtige Verzweigungen und jeder vorhandene Teststil, den du beibehalten willst. Nenne auch, ob du Kotest StringSpec, FunSpec oder BehaviorSpec möchtest, denn das beeinflusst Lesbarkeit und Struktur.

Nenne die harten Einschränkungen direkt am Anfang

Wenn dein Code suspendierende Funktionen, Flows, private Collaborators oder strikte Coverage-Gates verwendet, solltest du das vor der Generierung klar sagen. Zum Beispiel: Use MockK for the repository, test this suspend function with coroutine test support, and keep the assertions compatible with Kover coverage goals.

Bitte um Abdeckung für Fehlerpfade

Die Skill ist am wertvollsten, wenn du sowohl Happy-Path- als auch Failure-Path-Tests verlangst und nicht nur „einen Test, der durchläuft“. Wenn eine Funktion null zurückgeben, werfen, erneut versuchen oder Eingaben validieren kann, fordere diese Fälle ausdrücklich an, damit die erzeugte Testsuite wirklich entscheidungsreif ist.

Verfeinere das Testdesign iterativ

Nach der ersten Ausgabe solltest du den Prompt mit dem nachschärfen, was noch fehlt: Edge Cases, Namenskonventionen, Fixture-Setup oder instabile Abhängigkeiten. Der schnellste Verbesserungszyklus für kotlin-testing besteht darin, die generierte Spezifikation zu prüfen, zu markieren, was übermäßig gemockt oder zu schwach abgedeckt wirkt, und dann eine engere Neuformulierung mit genau dem Branch anzufordern, den du noch brauchst.