For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Hauptnavigation
Codex

Codex use case

Eine CLI erstellen, die Codex nutzen kann

Gib Codex einen flexibel kombinierbaren Befehl für eine API, eine Protokollquelle, einen Export oder ein Team-Skript.

Difficulty Mittelstufe
Time horizon 1 h

Bitte Codex, eine flexibel kombinierbare CLI zu erstellen. Codex soll sie aus jedem Ordner ausführen, mit Repository-Skripten kombinieren und zum Herunterladen von Dateien verwenden können; ein zugehöriger Skill soll die Nutzung für spätere Aufgaben festhalten.

Am besten geeignet für

  • Wiederkehrende Aufgaben, bei denen Codex denselben Dienst, denselben Export, dasselbe lokale Archiv oder dasselbe Repository-Skript durchsuchen und daraus lesen oder Dateien herunterladen bzw. Daten sicher zurückschreiben muss.
  • Agenten-Tools, die paginierte Suchen, exaktes Lesen anhand einer ID, vorhersehbares JSON, Datei-Downloads, lokale Indizes oder Befehle benötigen, bei denen vor dem Schreibzugriff ein Entwurf erstellt wird.

Contents

    ← Alle Anwendungsfälle

    Eine CLI erstellen, die Codex nutzen kann

    Gib Codex einen flexibel kombinierbaren Befehl für eine API, eine Protokollquelle, einen Export oder ein Team-Skript.

    Bitte Codex, eine flexibel kombinierbare CLI zu erstellen. Codex soll sie aus jedem Ordner ausführen, mit Repository-Skripten kombinieren und zum Herunterladen von Dateien verwenden können; ein zugehöriger Skill soll die Nutzung für spätere Aufgaben festhalten.

    Mittelstufe
    1 h

    Bitte Codex, eine flexibel kombinierbare CLI zu erstellen. Codex soll sie aus jedem Ordner ausführen, mit Repository-Skripten kombinieren und zum Herunterladen von Dateien verwenden können; ein zugehöriger Skill soll die Nutzung für spätere Aufgaben festhalten.

    Mittelstufe
    1 h

    Am besten geeignet für

    • Wiederkehrende Aufgaben, bei denen Codex denselben Dienst, denselben Export, dasselbe lokale Archiv oder dasselbe Repository-Skript durchsuchen und daraus lesen oder Dateien herunterladen bzw. Daten sicher zurückschreiben muss.
    • Agenten-Tools, die paginierte Suchen, exaktes Lesen anhand einer ID, vorhersehbares JSON, Datei-Downloads, lokale Indizes oder Befehle benötigen, bei denen vor dem Schreibzugriff ein Entwurf erstellt wird.

    Skills und Plug-ins

    • Entwirf die Befehlsstruktur, entwickle die CLI, füge Prüfungen für Setup und Authentifizierung hinzu, mache den Befehl über den PATH verfügbar und teste ihn aus einem anderen Ordner.
    • Erstelle den zugehörigen Skill, der Codex bei späteren Aufgaben zeigt, welche CLI-Befehle zuerst ausgeführt werden sollen und welche Schreibvorgänge eine Genehmigung erfordern.
    Skill Why use it
    Cli Creator Entwirf die Befehlsstruktur, entwickle die CLI, füge Prüfungen für Setup und Authentifizierung hinzu, mache den Befehl über den PATH verfügbar und teste ihn aus einem anderen Ordner.
    Skill Creator Erstelle den zugehörigen Skill, der Codex bei späteren Aufgaben zeigt, welche CLI-Befehle zuerst ausgeführt werden sollen und welche Schreibvorgänge eine Genehmigung erfordern.

    Einstiegs-Prompt

    Erstelle mit $cli-creator eine CLI, die du verwenden kannst, und erstelle mit $skill-creator im selben Chat den zugehörigen Skill. Quelle, die du auswerten sollst: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. Erste Aufgabe, die die CLI unterstützen soll: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script]. Optionale Schreibaufgabe: [create a draft comment, upload media, retry a failed job, or read-only for now]. Befehlsname: [cli-name, or recommend one]. Zeige mir vor dem Schreiben des Codes die vorgeschlagene Befehlsstruktur und frage nur nach fehlenden Angaben, ohne die du die CLI nicht entwickeln kannst.
    Erstelle mit $cli-creator eine CLI, die du verwenden kannst, und erstelle mit $skill-creator im selben Chat den zugehörigen Skill. Quelle, die du auswerten sollst: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. Erste Aufgabe, die die CLI unterstützen soll: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script]. Optionale Schreibaufgabe: [create a draft comment, upload media, retry a failed job, or read-only for now]. Befehlsname: [cli-name, or recommend one]. Zeige mir vor dem Schreiben des Codes die vorgeschlagene Befehlsstruktur und frage nur nach fehlenden Angaben, ohne die du die CLI nicht entwickeln kannst.

    Einführung

    Wenn Codex immer wieder mit einer bestimmten API, Protokollquelle, einem exportierten Postfach, einer lokalen Datenbank oder einem Team-Skript arbeitet, stelle dafür eine flexibel kombinierbare Schnittstelle bereit: einen Befehl, den Codex aus jedem Ordner ausführen und mit git, gh, rg, Tests und Repository-Skripten kombinieren kann und dessen Ergebnisse sich prüfen und eingrenzen lassen.

    Füge einen zugehörigen Skill hinzu, der festhält, wann Codex die CLI verwenden soll, was zuerst auszuführen ist, wie sich die Ausgabe begrenzen lässt, wo heruntergeladene Dateien gespeichert werden und welche Schreibbefehle eine Genehmigung erfordern.

    In diesem Workflow hilft $cli-creator Codex dabei, den Befehl zu entwickeln. Mit $skill-creator kann Codex einen wiederverwendbaren Skill wie $ci-logs speichern, der sich bei späteren Aufgaben anhand seines Namens aufrufen lässt.

    Anwendung

    Lege fest, was die CLI tun soll

    Beginne mit dem, was Codex tun soll, nicht mit der Technologie, die Codex dafür entwickeln soll. Eine gute CLI verpackt wiederkehrende Vorgänge wie Lesen, Suchen, Herunterladen, Exportieren, Entwerfen, Hochladen, Statusabfragen oder sicheres Schreiben in einen Befehl, den Codex aus jedem Repository ausführen kann.

    SituationWas Codex mit der CLI tun kann
    CI-Protokolle sind nur über eine Build-Seite zugänglich.Eine Build-URL übernehmen, die Protokolle fehlgeschlagener Jobs nach ./logs herunterladen und Dateipfade sowie kurze Ausschnitte zurückgeben.
    Supporttickets werden wöchentlich exportiert.Den neuesten CSV- oder JSON-Export indexieren, nach Kundennamen oder Formulierungen suchen und ein einzelnes Ticket anhand einer stabilen ID lesen.
    Eine API-Antwort ist zu groß für den Kontext.Nur die benötigten Felder auflisten, das vollständige Objekt anhand seiner ID lesen und die gesamte Antwort in eine Datei exportieren.
    Ein Slack-Export enthält lange Threads.Mit --limit suchen, einen einzelnen Thread lesen und den umgebenden Kontext statt des gesamten Archivs zurückgeben.
    Ein Team-Skript umfasst vier verschiedene Schritte.Setup, Suche, Download, Entwurf, Upload, Statusabfrage und direktes Schreiben in separate Befehle aufteilen.
    Ein Plug-in findet den Datensatz, aber Codex benötigt eine Datei.Das Plug-in weiterhin im Chat verwenden und eine CLI nutzen, um den Anhang, Trace, Bericht, das Video oder Protokollpaket herunterzuladen und den Pfad zurückzugeben.

    Dokumentation, Dateien oder Befehle bereitstellen

    Codex braucht konkrete Inhalte, die es auswerten kann: eine Dokumentation oder OpenAPI-Spezifikation, einen um vertrauliche Angaben bereinigten curl-Befehl, den Pfad zu einem Export oder einer Datenbank, einen Protokollordner oder ein vorhandenes Skript. Wenn die CLI einem vertrauten Stil folgen soll, füge eine kurze Ausgabe ein, die gh, kubectl oder das Tool deines Teams mit --help erzeugt.

    Wenn der Befehl eine Authentifizierung erfordert, teile Codex den Namen der Umgebungsvariable, den Pfad zur Konfigurationsdatei oder das Anmeldeverfahren mit, das die CLI unterstützen soll. Hinterlege den geheimen Wert selbst in deiner Shell oder Konfigurationsdatei. Füge keine geheimen Werte in den Chat ein. Bitte Codex, die Setup-Prüfung der CLI bei fehlender Authentifizierung mit einer klaren Fehlermeldung abbrechen zu lassen.

    Bitte Codex, die CLI und den Skill zu entwickeln

    Verwende den Start-Prompt auf dieser Seite. Gib die Quelle an, die Codex auswerten soll, sowie die erste Aufgabe, die die CLI unterstützen soll.

    Bevor Codex Code schreibt, soll es die vorgeschlagene Befehlsstruktur zeigen und nur nach fehlenden Angaben fragen, ohne die die Entwicklung nicht möglich ist.

    Prüfe, ob der Befehl aus jedem Ordner funktioniert

    Codex sollte nicht schon nach cargo run, python path/to/script.py oder einem Befehl für ein nicht installiertes Paket aufhören. Bitte Codex, den installierten Befehl aus einem anderen Repository oder einem temporären Ordner so zu testen, wie ihn eine spätere Aufgabe verwenden wird.

    Teste die CLI so, wie es ein zukünftiger Agent tun würde

    Teste [cli-name] so, wie du die CLI in einer zukünftigen Aufgabe verwenden würdest. Bitte belege Folgendes: - command -v [cli-name] kann außerhalb des CLI-Quellordners erfolgreich ausgeführt werden - [cli-name] --help erklärt die wichtigsten Befehle - die Prüfung für setup/auth wird ausgeführt - ein sicherer Befehl zum Ermitteln, Auflisten oder Suchen funktioniert - ein Befehl zum exakten Lesen funktioniert mit einer ID aus dem Ermittlungsergebnis - große Protokolle, Exporte, Traces oder Payloads werden jeweils in eine Datei geschrieben und der Pfad wird zurückgegeben - Befehle für direkte Schreibvorgänge werden nur ausgeführt, wenn ich sie ausdrücklich genehmigt habe Lies dann den zugehörigen Skill und nenne mir den kürzesten Prompt, mit dem ich diese CLI später erneut verwenden kann.

    Wenn Codex einen riesigen JSON-Datenblock zurückgibt, bitte es, die Standardantwort stärker einzugrenzen und einen Dateiexport für vollständige Payloads hinzuzufügen. Falls Codex vergisst, welche Schreibaktionen eine Genehmigung erfordern, bitte es, den zugehörigen Skill zu aktualisieren, bevor du ihn für eine weitere Aufgabe verwendest.

    Skill später verwenden

    Wenn du die CLI wieder brauchst, rufe den Skill auf, statt die Dokumentation erneut einzufügen:

    Lade mit $ci-logs die Protokolle fehlgeschlagener Jobs für diese Build-URL herunter und nenne mir den ersten fehlgeschlagenen Schritt.
    Durchsuche mit $support-export die Rückerstattungsbeschwerden dieser Woche und lies die drei Tickets mit den höchsten Beträgen.
    Finde mit $admin-api den Workspace dieser Person, lies den Abrechnungseintrag und entwirf eine unbedenkliche Kontonotiz.

    Teste den Skill bei wiederkehrenden Aufgaben zunächst einmal in einem Chat und bitte Codex dann, für denselben Aufruf direkt aus dem Chat eine Aufgabe zu planen.

    Verwandte Anwendungsfälle