Codex-Auftrag schreiben: Vorlage für klare Änderungen

Das Problem

Sie schreiben Codex: «Mach das Kontaktformular besser.» Das Ergebnis: Der Assistent ändert die Gestaltung, baut zusätzliche Felder ein, passt die Mail-Funktion an und verändert drei weitere Dateien. Nichts davon war gewünscht, und nun müssen Sie Änderungen rückgängig machen, die Sie nicht überblicken.

KI-Programmierassistenten sind fähig, aber wörtlich: Sie füllen unklare Aufträge mit eigenen Annahmen. Je weniger Sie vorgeben, desto grösser ist der Spielraum, und desto schwieriger wird die Prüfung. Das gilt besonders bei bestehendem Code, wo jede Änderung Folgen haben kann.

Ein guter Auftrag ist eine kleine, präzise Arbeitsanweisung: Was soll am Ende anders sein? Wo im Projekt? Was darf sich nicht ändern? Woran erkenne ich, dass es stimmt? Mit einer festen Vorlage schreiben Sie solche Aufträge schnell und prüfbar. Stand: Oktober 2026; Bedienung variiert je nach Variante (Terminal, Entwicklungsumgebung, Web).

So lösen Sie es mit KI – Schritt für Schritt

1. Ein Ziel pro Auftrag. Zum Beispiel «Das Kontaktformular prüft die E-Mail-Adresse». Nicht mehrere Dinge gleichzeitig (Aufgaben aufteilen).

1. Ausgangslage beschreiben. Was passiert heute, was ist das Problem? Bei Fehlern: Meldung, Schritte zum Nachstellen.

1. Ort nennen. Dateien, Ordner oder Funktionen, die betroffen sind. Das spart Suche und verhindert Streuung.

1. Vorgaben festlegen. Sprache, Stil, vorhandene Bibliotheken, Namensregeln. Dauerhafte Regeln gehören in eine Anweisungsdatei (AGENTS.md).

1. Verbote nennen. Keine neuen Abhängigkeiten, keine Änderung an Datenbankstruktur, keine Änderungen ausserhalb der genannten Dateien.

1. Abnahmekriterium formulieren. Woran erkenne ich, dass es stimmt? Beobachtbares Verhalten, Testfälle, Ausgaben.

1. Tests angeben. Welche Tests soll Codex ausführen oder ergänzen? Wie startet man sie?

1. Ergebnis prüfen. Lesen Sie die Änderungen im Diff, führen Sie Tests aus, prüfen Sie auf Nebenwirkungen und übernehmen Sie nur, was Sie verstehen (Code-Review mit Codex).

Vorlage zum Kopieren

Ziel:
[Ein Satz: was soll nach der Änderung anders sein?]

Ausgangslage:
[Was passiert heute? Bei Fehlern: Fehlermeldung und Schritte zum Nachstellen.]

Betroffener Ort:
[Dateien, Ordner oder Funktionen]

Vorgaben:
- Verwende die vorhandenen Bibliotheken und den bestehenden Stil.
- [weitere Vorgaben, zum Beispiel Namensregeln, Sprache der Texte: Deutsch (Schweiz)]

Nicht tun:
- Keine Änderungen ausserhalb von [Dateien].
- Keine neuen Abhängigkeiten, keine Änderung der Datenbankstruktur, keine Änderung von Konfigurations- oder Zugangsdaten.
- Keine Formatierungsänderungen an unbeteiligten Zeilen.

Abnahmekriterien:
1. [Beobachtbares Verhalten 1]
2. [Beobachtbares Verhalten 2]

Tests:
Führe [Befehl für Tests] aus. Ergänze Tests für [Fälle]. Beschreibe am Ende, was geändert wurde, welche Tests laufen und was nicht geprüft werden konnte.

Füllen Sie nur, was nötig ist, und halten Sie den Auftrag klein. Prüfen Sie das Ergebnis auch dann, wenn Codex Erfolg meldet.

Worauf Sie achten müssen

• Zu grosse Aufträge. Sie erzeugen grosse Änderungen, die niemand mehr sauber prüft. Teilen Sie Aufgaben auf.
• Unbemerkte Nebenwirkungen. Prüfen Sie den Diff auf Änderungen ausserhalb des Ziels.
• Tests, die nichts prüfen. Von der KI geschriebene Tests können so gebaut sein, dass sie immer bestehen. Lassen Sie sie fehlschlagen, wenn der Code falsch ist (Tests mit Codex erstellen).
• Geheimnisse. Geben Sie Zugangsdaten nie in Aufträge oder Dateien, auf die Codex zugreift (Geheimnisse schützen).
• Rückgängig machen. Arbeiten Sie mit Versionsverwaltung, damit sich Änderungen zurücknehmen lassen (Änderungen rückgängig machen).
• Verantwortung. Wer Code übernimmt, verantwortet ihn, unabhängig davon, wer ihn geschrieben hat. Datenschutz und Lizenzfragen klären Sie nach den Vorgaben Ihres Betriebs.

Ein Beispiel aus der Praxis

Ein Beispiel: Eine Webentwicklerin in Aarau betreut den Online-Shop eines Weinhändlers. Das Versandformular akzeptiert Postleitzahlen mit Buchstaben. Ihr erster Auftrag an Codex lautet «Verbessere die Formularprüfung» und führt zu Änderungen in sechs Dateien.

Sie verwirft die Änderungen und formuliert neu: Ziel «Postleitzahl muss in der Schweiz vierstellig numerisch sein», Ort «checkout/validierung.php», Verbot «keine anderen Dateien», Abnahme «ungültige PLZ zeigt Fehlermeldung, gültige wird akzeptiert», dazu die Testfälle 8001, 80010, 80A1 und leer. Codex ändert eine Datei und ergänzt vier Tests. Sie prüft den Diff und führt die Tests aus.

Vorher unübersichtliche Änderungen, nachher eine kleine, nachvollziehbare. Die Zeit für das Schreiben des Auftrags holt sie bei der Prüfung ein.

So hilft Ihnen Alpasana

Wie man Programmieraufgaben an KI delegiert und die Ergebnisse systematisch verifiziert, lernen Sie im Kurs KI für Developer mit Claude und Codex von absofort. Beschrieben sind Codegenerierung, Debugging, Refactoring und Review, das Delegieren von Aufgaben und Verifizieren von Ergebnissen sowie ein Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen.

Der Kurs ist online, mit Abschlussquiz, KI-geprüfter Praxisaufgabe und verifizierbarem Zertifikat.

Häufige Fragen

Wie lang darf ein Auftrag sein?

So lang wie nötig, aber das Ziel bleibt klein. Lange Beschreibungen sind in Ordnung, wenn sie eine einzige Änderung betreffen.

Soll ich Codex Rückfragen stellen lassen?

Ja, bei unklaren Aufträgen kann das Fehler vermeiden. Bitten Sie ihn, offene Fragen zu nennen, bevor er Änderungen vornimmt.

Wohin gehören dauerhafte Regeln?

In eine Anweisungsdatei im Projekt (AGENTS.md), damit Sie sie nicht in jedem Auftrag wiederholen.

Was, wenn das Ergebnis schlecht ist?

Verwerfen Sie die Änderung und verbessern Sie den Auftrag, statt Fehler durch Nachbessern zu stapeln.