✓ Gutes Beispiel

Iterative Test-Generierung

Agent erstellen → Cypress E2E → Hürden meistern → Vitest Unit Tests
📁 Projekt: mmsitepackage (TYPO3) 📄 Log: vue-cypress-test 💬 10 Austausche ⏱ ~20 Minuten
Legende:
Vorbildlich
Problematisch
Achtung / Hinweis
Lerntipp

🗂 Hintergrund & Ausgangslage

ℹ️

Für das TYPO3 Sitepackage mmsitepackage wurde eine neue product-list.vue-Komponente entwickelt. Die Aufgabe: vollständige Testabdeckung aufbauen – E2E mit Cypress und Unit Tests mit einem noch zu definierenden Framework.

Diese Session zeigt den vollständigen Bogen: Von einem Custom Agent über mehrere Hürden (fehlendes Binary, fehlende Env-Variable, fehlendes Test-Framework) bis zu drei erfolgreichen Unit-Tests. Jede Hürde wird durch einen kurzen Einzeiler überwunden.

Session-Überblick auf einen Blick

1

Custom Agent definieren

Cypress-Test-Agent für wiederkehrende Aufgaben erstellen

2

Cypress-Tests + Fixtures generieren

"erzeuge tests samt testdaten" – E2E-Spec + Fixture in einem Schritt

3

Hürde: Cypress nicht gefunden

Binary-Pfad fehlt → Entwickler gibt Hinweis → Copilot passt Befehl an

4

Hürde: Env-Variable fehlt

Cypress.env('url_website_testpages') nicht gesetzt → mit --env-Parameter starten

5

Vitest-Setup + Unit Tests

Kein Framework vorhanden → Copilot schlägt Vitest vor → volles Setup in einem Schritt

6

ESM-Migration + Aufräumen

Deprecation-Warnung behoben, alte Config-Datei entfernt – 3 Tests grün

💬 Die Session im Detail

Austausch 1 – Custom Agent erstellen
Entwickler
ich benötige einen copilot agent, der für neue frontend komponenten automatisierte cypress tests schreibt
✓Agent vor Arbeit. Statt direkt Tests zu generieren, wird zuerst ein spezialisierter Agent definiert. Eine 30-Sekunden-Investition, die alle zukünftigen Test-Sessions effizienter macht – Copilot muss nicht jedes Mal neu orientiert werden.
✓Klare Zweckbeschreibung. "für neue frontend komponenten" und "automatisierte cypress tests" geben Copilot genug Kontext für eine sinnvolle Agent-Datei ohne weitere Rückfragen.
💡Wann einen Agent erstellen? Immer wenn dieselbe Aufgabe (Tests schreiben, Code reviewen, Migrations-Schritte) regelmäßig wiederholt werden soll. Agent-Dateien sind das Langzeitgedächtnis für spezialisierte Workflows.
Copilot
[erstellt .github/agents/create-cypress-test.agent.md]
description: "Erstellt automatisierte Cypress-Tests
  für neue Frontend-Komponenten."
tools: []
---

## Zweck
Dieser Chat-Modus erstellt Cypress-Tests für neu
entwickelte Frontend-Komponenten im Projekt.

## Verhalten
- Fokus auf stabile, wartbare End-to-End-Tests
- Bestehende Projektmuster verwenden, falls vorhanden
- Keine Änderungen außerhalb der Tests ohne
  ausdrückliche Aufforderung
- Stabile Selektoren nutzen (data-testid, data-cy)

## Einschränkungen
- Keine Refactorings ohne Anweisung
- Keine Änderungen an Produktionscode
✓Copilot denkt die Einschränkungen mit. "Keine Änderungen außerhalb der Tests ohne ausdrückliche Aufforderung" und "Keine Refactorings ohne Anweisung" hat der Entwickler nicht explizit angefordert – Copilot hat sie sinnvoll ergänzt.
✓Selektoren-Empfehlung inklusive. "Stabile Selektoren nutzen (data-testid, data-cy)" ist eine Best Practice, die Copilot selbst in den Agent eingebaut hat.
Austausch 2 – Tests + Fixtures in einem Schritt
Entwickler
erzeuge tests samt testdaten für diese komponente
✓"samt testdaten" – der entscheidende Zusatz. Ohne diesen Zusatz hätte Copilot möglicherweise nur die Testdatei erstellt. "samt testdaten" signalisiert explizit: auch Fixture-Dateien anlegen.
✓Kurzer Prompt, großer Output. Zwei Wörter mehr als nötig würden den Prompt nicht verbessern. Copilot weiß aus dem Kontext (aktiver Tab = product-list.vue, Agent aktiv), was gemeint ist.
Copilot
Plan:
  • Testdaten-Fixture anlegen
  • E2E-Tests für Rendering, Filter und Sortierung
  • Testlauf anstoßen und Ergebnis melden
[erstellt productList.cy.js + product-list.json Fixture]

Testlauf: fehlgeschlagen, weil Cypress lokal nicht installiert ist (fehlendes Binary).

Zum Installieren:
cd /path/to/mmsitepackage
npx cypress install
npx cypress run --spec Tests/cypress/e2e/productList.cy.js
✓Copilot listet seinen Plan auf. Vor der Ausführung: drei Punkte, was er tun wird. Das gibt dem Entwickler die Möglichkeit, einzugreifen, bevor Code entsteht.
✓Transparentes Scheitern. Copilot führt den Test aus, schlägt fehl, und erklärt präzise warum. Kein "erfolgreich" bei einem Fehler – er berichtet ehrlich.
✓Sofort nutzbare Lösung. Copilot liefert die exakten Befehle zum Installieren und Starten – der Entwickler muss nichts nachschlagen.
Austausch 3 – Hürde 1: Cypress-Binary-Pfad
Entwickler
cypress ist im node_modules/bin ordner zu finden
✓Minimale Korrektur, maximale Wirkung. Ein Satz gibt Copilot den fehlenden Kontext über die lokale Projektstruktur. Kein Erklären, kein Nachforschen.
💡Lokale Umgebungs-Infos immer nachliefern. Copilot kann nicht in die lokale Umgebung schauen. Wenn etwas nicht am Standard-Pfad liegt, einfach sagen wo es ist – das ist die effizienteste Form der Korrektur.
Copilot
Der Lauf scheitert weiterhin, weil das Cypress-Binary im Cache fehlt (Installation der App ist erforderlich). Der lokale Wrapper ist vorhanden, aber das eigentliche Cypress-Executable fehlt.

Nächster Schritt:
cd /path/to/mmsitepackage
./node_modules/.bin/cypress install
./node_modules/.bin/cypress run \
  --spec Tests/cypress/e2e/productList.cy.js
Sag Bescheid, wenn ich den Lauf nach der Installation erneut starten soll.
✓Copilot analysiert weiter, gibt nicht auf. Der Binary ist da, aber der Cache fehlt noch – das ist ein zweiter Fehler, den Copilot sofort diagnostiziert und den nächsten Schritt liefert.
✓Konkrete Angebots-Formulierung. "Sag Bescheid, wenn ich den Lauf nach der Installation erneut starten soll" – Copilot macht ein konkretes Angebot statt eine offene Frage zu stellen.
Austausch 4 – Hürde 2: Env-Variable fehlt
Entwickler
du kannst cypress jetzt starten
✓Kurze Freigabe nach abgeschlossener Aktion. Nach der Installation ist ein Einzeiler genug. Copilot erinnert sich, welchen Test er starten soll.
Copilot
Der Lauf ist gestartet, aber fehlgeschlagen, weil Cypress.env('url_website_testpages') nicht gesetzt ist. Dadurch wird cy.visit() gegen undefined/product-list aufgerufen.

Konkreter Fehler:
  • cy.visit() versucht undefined/product-list
  • Resultat: 404 vom internen Cypress-Server
Nächster Schritt: Bitte die Env-Variable setzen oder Cypress mit --env starten.
⚠Copilot hat die Env-Variable im Test verwendet, ohne zu wissen, dass sie nicht gesetzt ist. Das ist keine Unaufmerksamkeit von Copilot – er kann die lokale Umgebung nicht sehen. Das ist eine strukturelle Schwäche: Env-Konfigurationen gehören in die copilot-instructions.md.
✓Präzise Fehlerdiagnose. Copilot erklärt nicht nur den Fehler, sondern auch die Kausalkette: Variable nicht gesetzt → undefined in URL → 404.
Austausch 5 – Hürde 2 lösen: Env-Parameter
Entwickler
starte mit parameter
✓Implizite Anweisung. Copilot hat im vorherigen Austausch "mit --env starten" vorgeschlagen. "starte mit parameter" greift das auf, ohne es zu wiederholen. Der Kontext ist noch intakt.
Copilot
Ausgefuehrter Befehl:
cd /path/to/mmsitepackage
./node_modules/.bin/cypress run \
  --spec Tests/cypress/e2e/productList.cy.js \
  --env url_website_testpages=https://mmtypo3.local/testpages
Der Run wurde mit dem Parameter gestartet, aber der Lauf wurde abgebrochen (CTRL+C). Wenn du willst, starte ich ihn erneut oder passe den Parameter an.
✓Copilot zeigt exakt den ausgeführten Befehl. Reproduzierbarkeit: der Entwickler sieht genau, was ausgeführt wurde und kann es auch manuell wiederholen.
⚠CTRL+C mitten im Lauf. Der Entwickler hat den Cypress-Lauf abgebrochen. Das ist OK – Copilot protokolliert es neutral und bietet Optionen an. Kein Fehler, aber ein Signal, dass hier bewusst gestoppt wurde.
Austausch 6-7 – Pivot zu Unit Tests
Entwickler
erstelle unit test für die komponente
⚠Themen-Wechsel innerhalb derselben Session. Von Cypress E2E zu Unit Tests ist ein konzeptueller Schwenk. Idealerweise wäre das eine neue Session – hier hat es trotzdem funktioniert, weil der Kontext (Komponente) noch frisch war und die Session noch nicht zu lang war.
💡Faustregel: Themen-Wechsel sind tolerierbar, solange die Session insgesamt unter ~15 Austauschen bleibt und der Kontext (die aktive Komponente) gleich bleibt. Bei größerem Wechsel (andere Datei, anderer Layer) besser neue Session.
Copilot
Aktuell gibt es kein Vue-Unit-Test-Setup in packages/mmsitepackage/package.json (kein Vitest/Jest).

Soll ich ein kleines Setup für Vue Unit Tests anlegen (z.B. Vitest + @vue/test-utils) und die Tests dort platzieren? Oder hast du bereits ein bevorzugtes Test-Framework/Setup?
✓Proaktive Lücken-Erkennung + Nachfrage. Copilot erkennt das fehlende Setup und fragt nach, bevor er losläuft. Das verhindert ein inkonsistentes oder unerwünschtes Setup.
✓Konkrete Optionen. Vitest + @vue/test-utils ist ein spezifischer Vorschlag, kein vages "soll ich was aufsetzen?" – das erleichtert die Entscheidung.
💡Diese Frage-vor-Implementierung ist ein Zeichen, dass der Session-Kontext noch intakt ist. Copilot agiert weiterhin vorsichtig und zielgenau.
Austausch 8 – Vollständiges Setup in einem Schritt
Entwickler
setze deinen vorschlag um
✓Die effizienteste Antwort auf einen Copilot-Vorschlag. Vier Wörter. Copilot weiß genau was zu tun ist. Kein Wiederholen, kein Bestätigen von Details.
💡"Setze deinen Vorschlag um" ist eine der nützlichsten Phrasen im Copilot-Workflow. Immer wenn Copilot am Ende seiner Antwort einen konkreten nächsten Schritt nennt, kann diese Phrase als Bestätigung dienen.
Copilot
Plan:
  • Vitest-Setup inkl. jsdom und Vue Test Utils anlegen
  • Testdaten und Tests schreiben
  • Tests lokal ausführen und Ergebnis berichten
[erstellt folgende Dateien:]
~ packages/mmsitepackage/package.json
+ packages/mmsitepackage/vitest.config.js
+ Tests/Frontend/setup.js
+ Tests/Frontend/fixtures/product-list.json
+ Tests/Frontend/components/product-list.spec.js
+ Tests/Frontend/README.md

Tests: npm run test:unit ✅ (erfolgreich, 3 Tests bestanden).

Hinweis: Vite meldet eine Deprecation-Warnung für die CJS Node API – die Tests laufen trotzdem.

Wenn du die CJS-Deprecation-Warnung entfernen willst, kann ich die Vitest-Konfig auf ESM umstellen.
✓Maximaler Output aus minimalem Input. Aus "setze deinen vorschlag um" entstehen 6 Dateien, ein vollständiges Test-Setup und 3 grüne Tests. Das ist der Wert von gut aufgebauten Copilot-Sessions.
✓Ehrlicher Hinweis auf Warnung. Die Deprecation-Warnung wird transparent gemeldet – Copilot versteckt sie nicht. Und er bietet sofort die Lösung an.
✓Optionaler nächster Schritt. "Wenn du willst..." – Copilot macht keine Annahmen. Der Entwickler entscheidet.
Austausch 9-10 – ESM-Migration und Aufräumen
Entwickler
setze deinen letzten vorschlag um
✓Konsistente Sprache. "Deinen letzten Vorschlag" – eindeutig. Copilot weiß, was gemeint ist (ESM-Migration).

Entwickler (nach ESM-Migration)
entfernen
✓Einwort-Anweisung. Copilot hat gefragt "Soll ich die alte vitest.config.js entfernen?" – "entfernen" als Antwort reicht vollständig. Extremstes Beispiel von minimalem Follow-up-Prompt.
Copilot
[Migration auf ESM-Config:]
+ vitest.config.mjs (ESM)
~ package.json (test:unit Script aktualisiert)
Tests: npm run test:unit ✅ (3 Tests bestanden, keine CJS-Warnung mehr).

Soll ich die alte vitest.config.js jetzt entfernen?

Copilot (nach "entfernen")
packages/mmsitepackage/vitest.config.js ist entfernt.

Wenn du möchtest, kann ich die Unit-Tests noch einmal laufen lassen.
✓Sauberes Aufräumen. Copilot verwaltet die Migration vollständig: neue Config erstellen, altes entfernen, Tests verifizieren. Kein manuelles Eingreifen nötig.
✓Angebot statt Annahme. "Wenn du möchtest, kann ich die Tests noch einmal laufen lassen" – Copilot fragt, statt einfach zu tun. Respektiert die Autonomie des Entwicklers.

📦 Was diese Session produziert hat

✅

Gesamtergebnis: Aus 10 Austauschen (davon viele Einzeiler) entstand eine vollständige Testinfrastruktur für die product-list.vue-Komponente.

+ .github/agents/create-cypress-test.agent.md
+ Tests/cypress/e2e/productList.cy.js
+ Tests/cypress/fixtures/product-list.json
+ Tests/Frontend/setup.js
+ Tests/Frontend/fixtures/product-list.json
+ Tests/Frontend/components/product-list.spec.js
+ Tests/Frontend/README.md
+ vitest.config.mjs
~ package.json (+vitest dependencies +test:unit script)
- vitest.config.js (entfernt, durch .mjs ersetzt)

📋 Fazit & Bewertung

✓ Gesamtbewertung: Vorbildlich – mit einem Lerntipp

Diese Session zeigt den produktivsten Copilot-Workflow: Agent zuerst, dann iterativ arbeiten, jede Hürde mit einem Einzeiler überwinden, Vorschläge mit "setze deinen Vorschlag um" bestätigen. Der Output-Qualitäts-Verhältnis ist außerordentlich gut.

Der einzige nennenswerte Mangel: Die Env-Variable url_website_testpages war Copilot unbekannt. Das ist nicht Copilots Fehler – er kann die lokale Umgebung nicht kennen, wenn sie nicht in der Instructions-Datei dokumentiert ist. Die Lösung: Umgebungskonfigurationen in copilot-instructions.md dokumentieren.

Der Themen-Wechsel von Cypress zu Vitest hätte in einer neuen Session sauberer sein können – hat hier aber funktioniert, weil der Kontext (die Komponente) gleich blieb und die Session noch nicht zu lang war.

🎓 Learnings aus dieser Session

💡

6 übertragbare Erkenntnisse

1

Agent vor der Arbeit erstellen

30 Sekunden für eine Agent-Datei machen alle zukünftigen Sessions dieser Art effizienter. Copilot hält sich an den definierten Scope und muss nicht jedes Mal neu orientiert werden.

2

"samt testdaten" = Fixtures inklusive

Dieser Zusatz verhindert, dass Tests ohne Testdaten generiert werden. Allgemein gilt: Je genauer beschrieben, was zum Output gehören soll, desto vollständiger der Output.

3

Umgebungskonfigurationen in die Instructions-Datei

Env-Variablen, lokale Pfade, Port-Nummern, Test-URLs – all das muss in der copilot-instructions.md stehen. Copilot kann die lokale Umgebung nicht sehen; was er nicht weiß, muss er erraten.

4

Hürden mit Einzeilern überwinden

Binary-Pfad? "cypress ist im node_modules/bin ordner". Env-Variable fehlt? "starte mit parameter". Jede Hürde braucht nur den minimalen Kontext, den Copilot nicht selbst wissen kann.

5

"Setze deinen Vorschlag um" = Copilots Vorausplanung nutzen

Copilot plant oft mehrere Schritte voraus und nennt optionale Folgeschritte. Diese immer lesen und mit dem kurzen Bestätigungs-Prompt annehmen, wenn sinnvoll.

6

Fehlendes Framework → Copilot fragt, nicht rät

Wenn Infrastruktur fehlt (kein Test-Framework, kein Build-Setup), fragt Copilot nach statt einfach etwas aufzusetzen. Diese Fragen immer beantworten – entweder bestätigen oder eine Alternative nennen.

Auf einen Blick: Was hat diese Session richtig gemacht?

ElementQualitätWarum
Agent-Erstellung zuerst⬆ Sehr gutLangzeit-Investment für Wiederverwendbarkeit
"samt testdaten"-Prompt⬆ Sehr gutFixtures werden automatisch miterstellt
Hürden-Bewältigung⬆ Sehr gutEinzeiler statt langen Erklärungen
Copilots transparente Fehlerberichte⬆ Sehr gutKein "erfolgreich" bei Fehlern
Env-Variable Dokumentation⚠ VerbesserbarHätte in Instructions-Datei stehen sollen
Themen-Wechsel (E2E → Unit)⚠ TolerierbarHat funktioniert, besser in neuer Session

🔗 Weitere Walk-Throughs