michaelschiemer/docs/ai/EINRICHTUNG-PHPSTORM.md

Einrichtung des KI-Assistenten in PhpStorm

Übersicht

Diese Anleitung beschreibt, wie der KI-Assistent in PhpStorm eingerichtet wird, um automatisch die Projekt-Guidelines zu verwenden.

Methode 1: Über die PhpStorm-Einstellungen

1. Öffne PhpStorm und gehe zu Settings/Preferences

   • Windows/Linux: File → Settings
   • macOS: PhpStorm → Preferences

2. Navigiere zu Tools → AI Assistant → Custom Instructions

3. Aktiviere die Option Use custom instructions

4. Füge in das Textfeld den Inhalt aus der Datei /docs/ai/GUIDELINES-FÜR-AI-ASSISTANT.md ein

   • Alternativ kannst du auf einen relativen Pfad verweisen

5. Aktiviere die Option Apply project-specific instructions, damit diese Einstellungen nur für dieses Projekt gelten

6. Klicke auf Apply und dann auf OK

Methode 2: Über die Projektkonfiguration (empfohlen)

Die .idea/aiAssistant.xml-Datei ist bereits im Projekt enthalten und konfiguriert den KI-Assistenten automatisch mit den richtigen Einstellungen. Wenn du das Projekt öffnest, sollte der KI-Assistent bereits korrekt eingerichtet sein.

Um zu überprüfen, ob die Einstellungen korrekt übernommen wurden:

1. Öffne die PhpStorm-Einstellungen wie oben beschrieben
2. Navigiere zu Tools → AI Assistant → Custom Instructions
3. Überprüfe, ob Use custom instructions aktiviert ist und die Guidelines angezeigt werden

Testen der Einrichtung

Um zu testen, ob der KI-Assistent die Guidelines korrekt anwendet:

1. Öffne eine PHP-Datei im Projekt
2. Drücke Alt+A (Windows/Linux) oder Option+A (macOS) um den KI-Assistenten zu öffnen
3. Bitte den Assistenten, eine neue Klasse zu erstellen
4. Überprüfe, ob die generierte Klasse den Guidelines entspricht:
   • Sie sollte als final und wenn möglich readonly deklariert sein
   • Constructor Property Promotion sollte verwendet werden
   • Es sollten keine externen Abhängigkeiten importiert werden

Fehlerbehebung

Falls die Guidelines nicht korrekt angewendet werden:

1. Stelle sicher, dass du die neueste Version von PhpStorm verwendest
2. Überprüfe, ob die AI Assistant-Funktion aktiviert ist
3. Versuche, das Projekt neu zu öffnen
4. Führe einen Cache-Clear in PhpStorm durch: File → Invalidate Caches