Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design
Codex

Anwendungsfall für Codex

Ein Ziel verfolgen

Gib Codex ein Ziel, das bei längeren Aufgaben über mehrere Gesprächsrunden hinweg gilt.

Schwierigkeitsgrad Advanced
Zeithorizont Long-running

Verwende /goal, wenn Codex über mehrere Gesprächsrunden hinweg an einer Aufgabe weiterarbeiten soll, bis eine überprüfbare Abschlussbedingung erfüllt ist.

Besonders geeignet für

  • Längere Programmieraufgaben mit einem klaren Erfolgskriterium, bei denen Codex Zwischenergebnisse regelmäßig überprüfen kann.
  • Codemigrationen, umfangreiche Refactorings, wiederholte Deployment-Versuche, Experimente, Spiele und Nebenprojekte, bei denen Codex Schritt für Schritt innerhalb des vorgegebenen Rahmens weiterarbeiten kann.
  • Teams, die länger laufende Experimente mit klaren Erfolgskriterien durchführen müssen.

Inhalt

    ← Alle Anwendungsfälle

    Ein Ziel verfolgen

    Gib Codex ein Ziel, das bei längeren Aufgaben über mehrere Gesprächsrunden hinweg gilt.

    Verwende /goal, wenn Codex über mehrere Gesprächsrunden hinweg an einer Aufgabe weiterarbeiten soll, bis eine überprüfbare Abschlussbedingung erfüllt ist.

    Advanced
    Long-running

    Verwende /goal, wenn Codex über mehrere Gesprächsrunden hinweg an einer Aufgabe weiterarbeiten soll, bis eine überprüfbare Abschlussbedingung erfüllt ist.

    Advanced
    Long-running

    Besonders geeignet für

    • Längere Programmieraufgaben mit einem klaren Erfolgskriterium, bei denen Codex Zwischenergebnisse regelmäßig überprüfen kann.
    • Codemigrationen, umfangreiche Refactorings, wiederholte Deployment-Versuche, Experimente, Spiele und Nebenprojekte, bei denen Codex Schritt für Schritt innerhalb des vorgegebenen Rahmens weiterarbeiten kann.
    • Teams, die länger laufende Experimente mit klaren Erfolgskriterien durchführen müssen.

    Prompt für den Einstieg

    /goal Complete [objective] without stopping until [verifiable end state].
    /goal Complete [objective] without stopping until [verifiable end state].

    Einführung

    Verwende /goal, wenn Codex über eine einzelne Antwort hinaus an einem festen Ziel weiterarbeiten soll. Das eignet sich für Aufgaben, bei denen das gewünschte Ergebnis klar ist, Codex den Fortschritt regelmäßig überprüfen kann und du nicht jeden Schritt vorgeben musst. Mit /goal kann Codex mehrere Stunden selbstständig arbeiten, ohne dass du eingreifen musst.

    Lege mit /goal <objective> ein Ziel fest und rufe mit /goal das aktuelle Ziel ab. Mit /goal pause, /goal resume oder /goal clear kannst du den Ablauf steuern.

    Falls /goal in der Liste der Slash-Befehle fehlt, aktiviere features.goals in config.toml:

    [features]
    goals = true

    Du kannst auch codex features enable goals in der CLI ausführen oder Codex bitten, den Befehl auszuführen.

    Geeignete Aufgaben auswählen

    Ein gutes Ziel umfasst mehr, als sich mit einem einzelnen Prompt erledigen lässt, ist aber enger gefasst als ein offenes Backlog. Halte fest, was Codex erreichen soll, was unverändert bleiben soll, wie Codex den Fortschritt überprüfen soll und wann es aufhören soll.

    Das eignet sich gut für:

    • Code-Migrationen, bei denen der Ziel-Stack, die Prüfungen auf gleichwertiges Verhalten und die Rahmenbedingungen feststehen
    • umfangreiche Refactorings, bei denen Codex nach jedem Etappenziel Tests ausführen kann
    • Experimente, Spiele oder Prototypen, bei denen Codex eine bereits funktionierende Version schrittweise verbessern kann

    Fasse lose Aufgaben ohne inhaltlichen Zusammenhang nicht zu einem Ziel zusammen.

    Den Ablauf festlegen

    1. Formuliere ein Ziel und eine Bedingung, unter der Codex die Arbeit beenden soll.
    2. Zeige Codex, welche Dateien, Dokumentationsseiten, Issues, Logs oder Pläne es zuerst lesen muss.
    3. Lege fest, mit welchen Befehlen oder Arbeitsergebnissen sich der Fortschritt nachweisen lässt.
    4. Bitte Codex, in Etappen zu arbeiten und den Fortschritt kurz zu protokollieren.
    5. Rufe mit /goal den aktuellen Stand ab, während Codex arbeitet.
    6. Pausiere das Ziel, setze es fort oder lösche es, je nachdem, ob die Arbeit abgeschlossen ist, Codex nicht weiterkommt oder sich die Richtung ändert.

    Entscheidend ist, dass du die Abschlusskriterien festlegst. Codex sollte vor dem Start wissen, was „fertig“ bedeutet. Bei einer Migration kann das heißen, dass der neue Codepfad die Vertragstests besteht und ein Rollback auf den bisherigen Codepfad weiterhin möglich ist. Bei einem Spiel oder Prototyp kann das heißen, dass sich die App kompilieren und starten lässt und der bereitgestellten Vorlage entspricht oder sich wie erwartet verhält.

    Lass dir von Codex helfen. Besprich zuerst, was du entwickeln möchtest. Bitte Codex dann, direkt ein Ziel festzulegen und mit der Arbeit zu beginnen.

    Codex selbstständig arbeiten lassen

    Bitte Codex während der Arbeit um kurze Fortschrittsberichte, damit du den Ablauf nachvollziehen kannst. Ein guter Bericht nennt das aktuelle Etappenziel und hält fest, was Codex überprüft hat, was noch aussteht und ob etwas die weitere Arbeit blockiert. Wenn die Berichte zu ungenau werden, formuliere das Ziel präziser, statt weitere Einzelanweisungen zu geben. Sag Codex genau, welches Etappenziel als Nächstes zählt, mit welchem Befehl sich überprüfen lässt, ob es erreicht ist, und wann Codex pausieren soll.

    Wenn Codex an einem Ziel arbeitet, kann es viele Stunden selbstständig weitermachen, ohne dass du nachsehen musst. Codex beendet die Arbeit, sobald es sich sicher ist, dass die festgelegte Abschlussbedingung erfüllt ist. Du kannst /goal daher als Hintergrundaufgabe laufen lassen, ohne sie überwachen zu müssen.

    Beispielziele

    Migrationen

    Ob du Spiele auf einen neuen Stack, mobile Apps auf eine neue Plattform oder eine Codebasis auf ein neues Framework migrierst: Mit /goal kannst du Codex die Migration durchführen lassen.

    /goal Migriere dieses Projekt von [legacy stack or system] auf [target stack or system]. Stelle sicher, dass alle Ansichten genauso aussehen wie zuvor. Überprüfe das Ergebnis mit playwright interactive.

    Prototypen erstellen

    Wenn du eine App von Grund auf entwickelst, ein neues Spiel erstellst oder eine neue Funktion hinzufügst, kannst du Codex mit /goal eine ausgearbeitete erste Version erstellen lassen. In einer Datei namens PLAN.md kannst du genau beschreiben, was du entwickeln möchtest. So hat Codex eine Anleitung für die erste Version.

    /goal Setze PLAN.md um, erstelle Tests für jeden Meilenstein und überprüfe das Ergebnis mit playwright interactive. [include reference screens as needed]

    Prompts optimieren

    Wenn du eine Eval-Suite hast, kannst du mit /goal Prompts anhand der Ergebnisse optimieren lassen. Codex kann fehlgeschlagene Fälle untersuchen, den Prompt anpassen und die Evals erneut ausführen. Das kann Codex so lange wiederholen, bis sich die Bewertung verbessert oder deine Abschlussbedingung erfüllt ist.

    /goal Optimiere die Prompts in [prompt file or directory], bis die Eval-Suite [target score or pass rate] erreicht. Führe nach jeder Änderung [eval command] aus und untersuche die fehlgeschlagenen Fälle. Ändere die Prompts gezielt und so wenig wie möglich. Beende die Arbeit, sobald das Ziel erreicht ist oder weitere Änderungen an den Prompts eine Klärung der Produktanforderungen oder Richtlinien erfordern.

    Verwandte Anwendungsfälle