Loop Goal Runner
Verwenden Sie diesen Skill, um eine offene Codex-Aufgabe in eine kleine, zustandsbehaftete Schleife zu verwandeln. Die Schleife muss ein klares Ziel, einen dauerhaften Zustand, ein objektives Gate und eine Stopp-Regel haben. Halten Sie den Standardpfad leichtgewichtig; fügen Sie Unteragenten oder Worktrees nur hinzu, wenn die Aufgabe die zusätzlichen Kosten rechtfertigt.
Kernvertrag
Jeder Schleifendurchlauf muss diese vier Artefakte oder Entscheidungen pflegen:
- Ziel: das aktuelle Benutzerziel und die Fertigstellungskriterien.
- Zustand: eine dauerhafte
STATE.md-Datei oder ein explizit benanntes externes Zustandssystem. - Gate: Tests, Lint, Typprüfungen, Build, Datenvalidierung, Screenshot-Prüfungen oder ein anderer objektiver Nachweisbefehl.
- Stopp-Regel: Erfolg, Blockade, maximale Versuche, maximale Laufzeit, Budgetgrenze oder Grenze für menschliche Freigabe.
Behaupten Sie keine Fertigstellung ohne frische Überprüfungsnachweise. Wenn es kein objektives Gate gibt, lassen Sie die Arbeit im beratenden/manuellen Modus und sagen Sie, dass es kein guter Kandidat für eine Schleife ist.
Arbeitsablauf
1. Führen Sie die Loop-Fit-Prüfung durch
Überprüfen Sie vor dem Erstellen oder Fortsetzen einer Schleife, ob die Aufgabe geeignet ist:
- Wiederholt sich mindestens wöchentlich oder ist lang genug, dass der dauerhafte Zustand wichtig ist.
- Hat ein objektives Gate, das schlechte Ausgaben zurückweisen kann.
- Kann in der verfügbaren Umgebung ausgeführt werden.
- Hat eine harte Stopp-Bedingung.
- Erfordert keine unbeaufsichtigte Beurteilung von Architektur, Authentifizierung, Zahlungen, Produktionsbereitstellungen oder irreversiblen Aktionen.
Wenn eine dieser Bedingungen fehlschlägt, erklären Sie die fehlgeschlagene Bedingung und verwenden Sie einen normalen One-Shot-Workflow, es sei denn, der Benutzer bittet ausdrücklich um Fortsetzung.
2. Zustand lokalisieren oder erstellen
Behandeln Sie den Zustand standardmäßig als zielbezogen. Jedes eigenständige Ziel sollte seine eigene dauerhafte Zustandsdatei haben, es sei denn, der Benutzer bittet ausdrücklich um die Wiederverwendung einer vorhandenen Zustandsdatei oder die vorhandene Datei gehört eindeutig zum selben aktiven Ziel.
Rangfolge des Zustandsdateipfads:
- Verwenden Sie den genauen Zustandsdateipfad, der vom Benutzer benannt wurde, falls vorhanden.
- Wenn ein vorhandenes Ziel fortgesetzt wird und sein vorheriger Zustandspfad bekannt ist, verwenden Sie dieselbe Datei erneut.
- Wenn das Ziel ein Aufgaben-Repository oder Artefakt-Verzeichnis erstellt oder hauptsächlich ändert, verwenden Sie das
STATE.mdim Stammverzeichnis dieser Aufgabe. - Erstellen Sie andernfalls eine zielspezifische Datei unter
.codex/goals/<ziel-slug>/STATE.mdim aktuellen Arbeitsbereich. - Verwenden Sie
STATE.mdim Arbeitsbereichsstammverzeichnis nur, wenn der Arbeitsbereich selbst das Ziel ist oder wenn der Benutzer es ausdrücklich auswählt.
Prüfen Sie vor der Wiederverwendung einer vorhandenen STATE.md die Abschnitte „Ziel“ und „Aktueller Status“. Wenn sie ein anderes Ziel beschreiben, überschreiben oder zweckentfremden Sie die Datei nicht. Erstellen Sie stattdessen eine neue zielbezogene Zustandsdatei und erwähnen Sie die Trennung kurz.
Wenn die ausgewählte Zustandsdatei nicht existiert und Dateibearbeitungen erlaubt sind, erstellen Sie sie aus references/state-template.md. Wenn Bearbeitungen nicht erlaubt sind, entwerfen Sie den anfänglichen Zustand in der Antwort und bitten Sie den Benutzer, ihn zu platzieren.
Zu Beginn jedes Schleifendurchlaufs:
- Lesen Sie die ausgewählte zielbezogene Zustandsdatei, bevor Sie planen.
- Lesen Sie das nächstgelegene anwendbare
AGENTS.mdoder entsprechende Projektanweisungen, wenn verfügbar. - Extrahieren Sie den letzten Durchlauf, aktuellen Status, offene Blockaden, nächste Aktionen, Überprüfungsverlauf, gewonnene Erkenntnisse und den Pfad der Zustandsdatei.
Am Ende jedes Schleifendurchlaufs:
- Aktualisieren Sie nur die ausgewählte zielbezogene Zustandsdatei mit den tatsächlich durchgeführten Aktionen.
- Notieren Sie Überprüfungsbefehle und -ergebnisse.
- Notieren Sie die nächste Aktion oder den Stopp-Grund.
- Bewahren Sie Erkenntnisse, die eine Komprimierung oder zukünftige Durchläufe überleben sollten.
- Verschieben, archivieren oder überschreiben Sie nicht den Zustand eines nicht verwandten Ziels, es sei denn, der Benutzer bittet ausdrücklich darum.
3. Das Ziel formen
Schreiben Sie das Ziel für den Codex-Zielmodus so, dass es messbar ist:
/goal <Ziel>. Fertig, wenn: <objektives Gate besteht>. Einschränkungen: Aktualisieren Sie die ausgewählte zielbezogene Zustandsdatei bei jedem Durchlauf; stoppen Sie nach <N> fehlgeschlagenen Versuchen oder wenn menschliches Urteilsvermögen erforderlich ist.
Wenn ein Ziel bereits aktiv ist, verwenden Sie das aktuelle Ziel als Quelle der Wahrheit, es sei denn, der Benutzer ändert es. Wenn kein Ziel aktiv ist, leiten Sie ein Arbeitsziel aus der Benutzeranfrage ab und geben Sie es kurz an.
4. Eine Schleifeniteration ausführen
Verwenden Sie diese Iterationsform:
- Zustand und Anweisungen lesen.
- Die nächstkleinste nützliche Aktion auswählen.
- Die Aktion ausführen.
- Das relevante Gate ausführen oder erklären, warum es nicht ausgeführt werden kann.
- Das Diff oder die Ausgabe überprüfen.
- Die ausgewählte zielbezogene Zustandsdatei aktualisieren.
- Entscheiden: fortsetzen, stoppen oder eskalieren.
Halten Sie Änderungen begrenzt. Bevorzugen Sie einen zuverlässigen manuellen Durchlauf, bevor Sie die Automatisierung planen.
5. Entscheiden, ob Unteragenten verwendet werden sollen
Standardmäßig einen einzelnen Agenten verwenden. Verwenden Sie Unteragenten nur, wenn mindestens eines zutrifft:
- Unabhängige Untersuchungen können parallel laufen.
- Eine Aufteilung in Ersteller/Prüfer würde das Risiko wesentlich verringern.
- Die Aufgabe hat mehrere nicht zusammenhängende Fehler, Subsysteme oder Dokumente.
- Der Benutzer bittet ausdrücklich um parallele Agenten oder Unteragenten.
Wenn Sie Unteragenten verwenden, wenden Sie diese Muster an:
- Ersteller/Prüfer: Ein Agent implementiert oder untersucht, ein anderer überprüft die Spezifikationseinhaltung und Codequalität.
- Paralleler Versand: Ein Agent pro unabhängigem Problembereich.
- Prüfer: Ein frischer Agent überprüft Nachweise, nicht versteckte Argumentation.
Behandeln Sie die Meinung eines Unteragenten nicht als hartes Gate. Die objektive Überprüfung hat weiterhin Vorrang.
6. Entscheiden, ob Worktrees verwendet werden sollen
Verwenden Sie Worktrees für Codeänderungen, wenn mehrere Agenten oder langlaufende Branches gleichzeitig schreiben könnten. Überspringen Sie Worktrees für reine Recherche, Dokumentenanalyse, kleine Ein-Datei-Bearbeitungen oder Nicht-Repository-Arbeitsbereiche.
Wenn Worktrees benötigt werden, bevorzugen Sie die native Worktree-Unterstützung von Codex, wenn verfügbar. Verwenden Sie andernfalls Git-Worktrees nur nach Bestätigung des Ziel-Repositorys und nachdem sichergestellt wurde, dass das Worktree-Verzeichnis nicht versehentlich committet wird.
7. Fertigstellung und Eskalation
Stoppen und klar berichten, wenn:
- Das Gate besteht und die Zielkriterien erfüllt sind.
- Die maximale Anzahl von Versuchen, Laufzeit oder das Budgetlimit erreicht ist.
- Erforderliche Berechtigungen, Anmeldeinformationen, externe Dienste oder menschliches Urteilsvermögen benötigt werden.
- Derselbe Blocker über drei aufeinanderfolgende Schleifendurchläufe hinweg wiederholt auftritt.
- Die Schleife Architektur, Authentifizierung, Zahlungen, Produktionsbereitstellungen, Geheimnisse oder umfassende Berechtigungen ohne ausdrückliche menschliche Genehmigung berühren müsste.
Die endgültige Antwort muss den aktuellen Zustand, die Überprüfungsnachweise und die nächste empfohlene Aktion enthalten.
Auslösezuverlässigkeit
Das Auslösen des Skills erfolgt beschreibungsbasiert. Damit dieser Skill bei zukünftiger Verwendung des Zielmodus automatisch ausgeführt wird, fügen Sie den Ausschnitt in references/agents-snippet.md zu einem globalen oder projektspezifischen AGENTS.md hinzu.
Referenzen
references/state-template.md: Vorlage für neueSTATE.md-Dateien.references/agents-snippet.md: optionale dauerhafte Anweisung, damit Codex diesen Skill aufruft, wann immer der Benutzer ein Ziel startet oder bespricht.