In einem TYPO3 MCP Server-Projekt soll ein neues Tool hinzugefügt werden, das Ordner in TYPO3-File-Storages erstellt. Die Besonderheit: Das Tool muss ausschließlich offizielle TYPO3-FAL-APIs verwenden (kein direkter Filesystem- oder Datenbankzugriff) und sich nahtlos in die bestehende Extension-Architektur einfügen. Die Session zeigt das Plan-First-Muster: Copilot analysiert zuerst die Architektur, erstellt einen detaillierten Plan – und implementiert dann autonom inklusive Tests.
Besonderheit dieser Session: Der erste "start the implementation"-Prompt scheiterte, weil Copilot sich im Plan-Modus befand und keine Write-Tools hatte. Der zweite Versuch (nach Moduswechsel) war erfolgreich: 10 Tests, 28 Assertions – alles grün.
CreateFolderTool im File/-Namespace, das über die offizielle TYPO3 FAL Storage-API Ordner erstellt. Folgt exakt dem Muster der bestehenden File-Tools und nutzt ResourceStorage::createFolder().CreateFolderTool.php – Validierung, ResourceFactory, hasFolderInFolder()-Check, createFolder(), Exception-HandlingCreateFolderToolTest.php – 7 Test-Cases: Erfolg, Sub-Folder, Idempotenz, Invalid storageUid, leerer Name, unbekannter Parent, nicht-schreibbarer Storageautoconfigure: true kein manueller Services.yaml-Eintrag nötig ist. Das zeigt tiefes TYPO3-Symfony-Verständnis.Plan-Modus vs. Agent-Modus: Dieser Austausch scheiterte, weil der Chat noch im Plan-Modus war. Copilot hatte keine Write-Tools und musste den Code als Textblöcke ausgeben. Lösung: In den Agent-Modus wechseln.
Classes/MCP/Tool/File/CreateFolderTool.php: Rekursive Ordner-Erstellung bei Slash, Idempotenz, Pfad-Traversal-Schutz, Race-Condition-sicherTests/Functional/MCP/Tool/CreateFolderToolTest.php: 10 Tests inkl. verschachtelte Pfade, ungültige Eingaben, Berechtigungsprüfung
#[AutoconfigureTag('mcp.tool')] auf dem Interface wird das neue Tool automatisch registriert. Copilot hat das im Plan erkannt und keinen manuellen Eintrag erstellt.Diese Session zeigt, warum der Plan-First-Ansatz bei komplexen Features so wertvoll ist. Copilot analysiert zuerst die bestehende Architektur und entwickelt daraus einen Plan, der von Anfang an passt: richtiger Namespace, richtiges Basis-Interface, gleiche Teststrategie, kein überflüssiger Services.yaml-Eintrag.
Der Zwischenfall mit dem falschen Modus ist ein typisches PhpStorm-Copilot-Problem: Plan-Modus und Agent-Modus haben unterschiedliche Tool-Sets. Für Implementierungen ist der Agent-Modus zwingend erforderlich. Der gleiche Prompt funktioniert im richtigen Modus einwandfrei.
Das Ergebnis: 10 Functional Tests, 28 Assertions, alle grün – ohne dass der Entwickler eine einzige Zeile manuell angepasst hat. Das ist das Optimum für Feature-Entwicklung mit Copilot.
Wenn ein Feature bestehende Architektur-Konventionen einhalten muss, zuerst einen Plan anfragen. Copilot analysiert die bestehenden Patterns (AbstractTool, Namespace, Test-Fixtures) und liefert einen Plan, der von Anfang an kompatibel ist.
"Only use official TYPO3 APIs that respect user permissions" ist nicht selbstverständlich. Ohne diesen Hinweis hätte Copilot möglicherweise mkdir() oder direkte Datenbankabfragen verwendet. Constraints gehören in den ersten Prompt.
In PhpStorm hat jeder Chat-Modus andere Tools. Plan-Modus: nur Lesen und Analysieren. Agent-Modus: Lesen, Schreiben, Ausführen. Implementierungsaufgaben immer im Agent-Modus starten.
"Don't use a recursive parameter but create recursive folders when the user sends a foldername containing /" – das ist eine Design-Entscheidung, die im Prompt getroffen wurde. Copilot setzt sie 1:1 um. Je klarer das gewünschte Verhalten, desto weniger Nacharbeit.
TYPO3 12+ nutzt Symfony Dependency Injection mit autoconfigure: true. Neue Tools werden durch Tags automatisch registriert. Copilot kennt dieses Muster – man muss nur sicherstellen, dass er die bestehende Services.yaml analysiert hat.
Copilot erstellt Functional Tests zusammen mit dem Tool, nicht als Nachschritt. Das ist richtig: Wer Tests nach der Implementierung schreibt, schreibt Tests, die bestehende Bugs mitdokumentieren. Immer "create tool AND test" fordern.
| Element | Qualität | Anmerkung |
|---|---|---|
| Austausch 1 – Prompt | ✓ Sehr gut | Plan-First, drei explizite Constraints, Architektur-Konformität gefordert |
| Austausch 1 – Antwort | ✓ Sehr gut | Architektur-Analyse vor Plan, Autoconfigure-Detail erkannt, 7 Test-Cases geplant |
| Austausch 2 – Prompt | ✓ Sehr gut | Kluge API-Design-Entscheidung (Slash statt recursive-Parameter) |
| Austausch 2 – Antwort | ⚠ Einschränkung | Korrekt transparent – aber kein Ergebnis wegen Plan-Modus-Limitation |
| Austausch 3 – Prompt | ✓ Sehr gut | Identischer Prompt, richtiger Modus – funktioniert sofort |
| Austausch 3 – Antwort | ✓ Exzellent | Vollständige Implementierung, Tests ausgeführt, 10/10 grün, Production-Quality-Details |