Namensverbesserer

Das Problem

Namen wie data, temp, handleClick, processStuff und utils verraten nichts ueber die Absicht. Schlechte Benennung ist die haeufigste Ursache fuer Verwirrung in Codebasen, und sie potenziert sich — wenn ein Entwickler etwas schlecht benennt, versteht jeder nachfolgende Entwickler es etwas anders. Gute Namen machen die meisten Kommentare ueberfluessig.

Der Prompt

Du bist ein Clean-Code-Experte mit Spezialisierung auf Namenskonventionen. Pruefe folgenden Code und schlage bessere Namen vor:

CODE:
[fuege deinen Code mit den Variablen, Funktionen oder Klassen ein, die umbenannt werden sollen]

SPRACHE: [z.B. TypeScript, Python, Java]
NAMENSKONVENTION: [z.B. camelCase, snake_case, PascalCase]

Fuer jeden verbesserungswuerdigen Namen:
1. **Aktueller Name**: Der bestehende Name
2. **Problem**: Warum er unklar ist (zu vage, irrefuehrend, abgekuerzt, etc.)
3. **Vorgeschlagene Namen**: 3 Optionen, gereiht von optimal bis akzeptabel
4. **Begruendung**: Warum der Top-Vorschlag die Absicht besser kommuniziert

Melde ausserdem:
- Inkonsistente Namensmuster im Code
- Namen, die mit Sprach-Builtins oder gaengigen Bibliotheken kollidieren
- Abkuerzungen, die ausgeschrieben werden sollten

Beispielausgabe

1. Aktuell: data → fetchedUserProfiles
   Problem: "data" sagt nichts ueber die Art der Daten oder ihre Herkunft aus.
   Optionen: fetchedUserProfiles > userProfileResponse > profileData
   Begruendung: "fetchedUserProfiles" beschreibt die Quelle (fetched), den Typ
   (User-Profile) und dass es eine Sammlung ist (Plural).

2. Aktuell: handleClick → submitContactForm
   Problem: "handleClick" beschreibt den Ausloeser, nicht die Aktion.
   Optionen: submitContactForm > sendContactInquiry > processFormSubmission
   Begruendung: "submitContactForm" beschreibt die Geschaeftsaktion und ist
   suchbar und selbstdokumentierend.

3. Aktuell: temp → pendingValidationResult
   Problem: "temp" ist universell nichtssagend.
   Optionen: pendingValidationResult > intermediateCheckResult > validationBuffer
   Begruendung: Benennt den Zweck (Validierungsergebnis) und den Status (ausstehend).

Wann verwenden

Verwenden Sie diesen Skill bei Code-Reviews, beim Refactoring von Legacy-Code oder immer dann, wenn Sie sich dabei ertappen, einen generischen Namen wie result oder value einzutippen. Ebenso nuetzlich in einer neuen Fachdomaene — die KI kann domaenspezifische Begriffe vorschlagen, die Sie moeglicherweise noch nicht kennen.

Profi-Tipps

• Fuegen Sie den umgebenden Kontext ein — eine Variable namens count in einer Schleife ist in Ordnung, aber count als Klasseneigenschaft braucht einen besseren Namen. Der Kontext aendert die Empfehlung.
• Geben Sie die Geschaeftsdomaene an — ergaenzen Sie “Dies ist ein E-Commerce-Checkout-Modul”, damit die KI Fachbegriffe wie cartTotal statt generischer Ausdruecke wie sum verwendet.
• Wenden Sie den Zeitungstest an — wenn Sie nur die Funktions- und Variablennamen ohne Implementierung lesen, verstehen Sie dann, was der Code tut? Falls nicht, muessen die Namen verbessert werden.