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

Eine CLI für Codex erstellen

Gib Codex einen Befehl für eine API, eine Logquelle, einen Datenexport oder ein Skript deines Teams. Codex kann ihn mit anderen Befehlen kombinieren.

Schwierigkeitsgrad Intermediate
Zeithorizont 1h

Lass Codex eine CLI erstellen, die es aus jedem Verzeichnis aufrufen, mit Skripten aus dem Repository kombinieren und zum Herunterladen von Dateien nutzen kann. Ein zugehöriger Skill hält fest, wie Codex die CLI bei späteren Aufgaben einsetzt.

Besonders geeignet für

  • Wiederkehrende Aufgaben, bei denen Codex immer mit demselben Dienst, Datenexport, lokalen Archiv oder Repository-Skript arbeitet und dabei Daten suchen, lesen, herunterladen oder sicher schreiben muss.
  • Werkzeuge für Agenten, die Suchergebnisse seitenweise abrufen, einzelne Einträge gezielt per ID auslesen, JSON in einem vorhersehbaren Format verarbeiten oder mit heruntergeladenen Dateien und lokalen Indizes arbeiten müssen. Auch für Werkzeuge, die Befehle brauchen, mit denen sie vor dem Schreiben einen Entwurf erstellen können.

Inhalt

    ← Alle Anwendungsfälle

    Eine CLI für Codex erstellen

    Gib Codex einen Befehl für eine API, eine Logquelle, einen Datenexport oder ein Skript deines Teams. Codex kann ihn mit anderen Befehlen kombinieren.

    Lass Codex eine CLI erstellen, die es aus jedem Verzeichnis aufrufen, mit Skripten aus dem Repository kombinieren und zum Herunterladen von Dateien nutzen kann. Ein zugehöriger Skill hält fest, wie Codex die CLI bei späteren Aufgaben einsetzt.

    Intermediate
    1h

    Lass Codex eine CLI erstellen, die es aus jedem Verzeichnis aufrufen, mit Skripten aus dem Repository kombinieren und zum Herunterladen von Dateien nutzen kann. Ein zugehöriger Skill hält fest, wie Codex die CLI bei späteren Aufgaben einsetzt.

    Intermediate
    1h

    Besonders geeignet für

    • Wiederkehrende Aufgaben, bei denen Codex immer mit demselben Dienst, Datenexport, lokalen Archiv oder Repository-Skript arbeitet und dabei Daten suchen, lesen, herunterladen oder sicher schreiben muss.
    • Werkzeuge für Agenten, die Suchergebnisse seitenweise abrufen, einzelne Einträge gezielt per ID auslesen, JSON in einem vorhersehbaren Format verarbeiten oder mit heruntergeladenen Dateien und lokalen Indizes arbeiten müssen. Auch für Werkzeuge, die Befehle brauchen, mit denen sie vor dem Schreiben einen Entwurf erstellen können.

    Skills und Plug-ins

    • Lege die Befehle und ihre Optionen fest, entwickle die CLI und ergänze Prüfungen für Setup und Authentifizierung. Installiere den Befehl in einem Verzeichnis, das in PATH aufgeführt ist, und teste ihn von einem anderen Verzeichnis aus.
    • Erstelle den zugehörigen Skill, damit Codex bei späteren Aufgaben weiß, welche CLI-Befehle es zuerst ausführen soll und für welche Schreibvorgänge es eine Genehmigung braucht.
    Skill Nutzen
    Cli Creator Lege die Befehle und ihre Optionen fest, entwickle die CLI und ergänze Prüfungen für Setup und Authentifizierung. Installiere den Befehl in einem Verzeichnis, das in PATH aufgeführt ist, und teste ihn von einem anderen Verzeichnis aus.
    Skill Creator Erstelle den zugehörigen Skill, damit Codex bei späteren Aufgaben weiß, welche CLI-Befehle es zuerst ausführen soll und für welche Schreibvorgänge es eine Genehmigung braucht.

    Prompt für den Einstieg

    Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same chat. Source to learn from: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. First job the CLI should support: [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]. Optional write job: [create a draft comment, upload media, retry a failed job, or read-only for now]. Command name: [cli-name, or recommend one]. Before coding, show me the proposed command surface and ask only for missing details that would block the build.
    Use $cli-creator to create a CLI you can use, and use $skill-creator to create the companion skill in this same chat. Source to learn from: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. First job the CLI should support: [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]. Optional write job: [create a draft comment, upload media, retry a failed job, or read-only for now]. Command name: [cli-name, or recommend one]. Before coding, show me the proposed command surface and ask only for missing details that would block the build.

    Einführung

    Wenn Codex immer wieder dieselbe API, dieselbe Logquelle, einen exportierten Posteingang, eine lokale Datenbank oder ein Skript deines Teams nutzt, lohnt sich ein eigener Befehl. Codex kann ihn aus jedem Ordner ausführen, die Ausgabe prüfen und eingrenzen und ihn mit git, gh, rg, Tests und Skripten aus dem Repository kombinieren.

    Ergänze die CLI um einen Skill. Halte darin fest, wann Codex die CLI verwenden soll, welchen Befehl es zuerst ausführen soll, wie es die Ausgabe begrenzt, wo heruntergeladene Dateien landen 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 und ihn bei späteren Aufgaben über seinen Namen aufrufen.

    Vorgehensweise

    Lege fest, was die CLI können soll

    Beschreibe zuerst, was Codex erledigen soll. Die Wahl der Technik kommt danach. Eine gute CLI macht aus wiederkehrenden Aufgaben einen Befehl, den Codex aus jedem Repository ausführen kann. Das kann das Lesen, Suchen, Herunterladen oder Exportieren von Daten sein, das Erstellen von Entwürfen, das Hochladen von Dateien, das regelmäßige Abfragen eines Status oder ein sicherer Schreibvorgang.

    Situation Was Codex mit der CLI tun kann
    CI-Logs sind über eine Build-Seite zugänglich. Über eine Build-URL die Logs fehlgeschlagener Jobs nach ./logs herunterladen und die Dateipfade zusammen mit kurzen Auszügen ausgeben.
    Supporttickets liegen als wöchentlicher Export vor. Den neuesten CSV- oder JSON-Export indexieren, nach einem Kundennamen oder einer Wortgruppe suchen und ein einzelnes Ticket anhand seiner 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 abrufen und die gesamte Antwort in eine Datei exportieren.
    Ein Slack-Export enthält lange Threads. Die Suche mit --limit begrenzen, einen einzelnen Thread lesen und die Nachrichten rund um den Treffer ausgeben, statt das gesamte Archiv zurückzugeben.
    Ein Skript des Teams führt vier verschiedene Schritte aus. Separate Befehle für das Setup, das Ermitteln vorhandener Daten, Downloads, Entwürfe, Uploads, Statusabfragen und Schreibzugriffe auf das Live-System bereitstellen.
    Ein Plugin findet den Datensatz, aber Codex braucht eine Datei. Das Plugin im Chat weiterverwenden und mit einer CLI den Anhang, den Trace, den Bericht, das Video oder das Logpaket herunterladen und den Dateipfad zurückgeben.

    Stelle Dokumentation, Dateien oder Befehle bereit

    Codex braucht eine konkrete Grundlage. Das kann eine Dokumentation oder OpenAPI-Spezifikation sein, ein curl-Befehl ohne vertrauliche Angaben, der Pfad zu einem Export oder einer Datenbank, ein Ordner mit Logs oder ein vorhandenes Skript. Soll sich die CLI an einem vertrauten Werkzeug orientieren, füge eine kurze --help-Ausgabe von gh, kubectl oder einem Tool deines Teams ein.

    Wenn der Befehl eine Authentifizierung erfordert, nenne Codex den Namen der Umgebungsvariablen, den Pfad zur Konfigurationsdatei oder das Anmeldeverfahren, das die CLI unterstützen soll. Hinterlege den geheimen Wert selbst in deiner Shell oder Konfigurationsdatei. Füge keine geheimen Zugangsdaten in den Chat ein. Bitte Codex, die Setup-Prüfung der CLI bei fehlender Authentifizierung mit einer eindeutigen Fehlermeldung abzubrechen.

    Lass Codex die CLI und den Skill erstellen

    Verwende den Einstiegsprompt auf dieser Seite. Gib an, welches Ausgangsmaterial Codex verwenden soll und welche Aufgabe die CLI als Erstes unterstützen soll.

    Bevor Codex Code schreibt, sollte es die vorgesehenen Befehle und ihre Aufrufsyntax zeigen. Es sollte nur nach Angaben fragen, ohne die es die CLI nicht entwickeln kann.

    Prüfe, ob der Befehl aus jedem Ordner funktioniert

    Ein Test mit cargo run, python path/to/script.py oder einem Befehl aus einem noch nicht installierten Paket reicht nicht aus. Bitte Codex, den installierten Befehl aus einem anderen Repository oder einem temporären Ordner zu testen, so wie es ihn bei einer späteren Aufgabe verwenden wird.

    Teste die CLI so, wie ein Agent sie später verwenden würde

    Teste [cli-name] so, wie du die CLI bei einer späteren Aufgabe verwenden würdest. Zeige mir bitte, dass folgende Punkte erfüllt sind: - command -v [cli-name] ist auch außerhalb des Quellordners der CLI erfolgreich. - [cli-name] --help erklärt die wichtigsten Befehle. - Die Prüfung von Setup und Authentifizierung läuft. - Ein sicherer Befehl zum Ermitteln, Auflisten oder Suchen von Daten funktioniert. - Mit einer ID aus dem Ergebnis lässt sich der zugehörige Datensatz gezielt per Lesebefehl abrufen. - Bei großen Logs, Exporten, Traces oder Payloads schreibt die CLI die Daten in eine Datei und gibt deren Pfad zurück. - Schreibbefehle für das Live-System führst du nur aus, wenn ich sie ausdrücklich genehmigt habe. Lies anschließend den zugehörigen Skill und nenne mir den kürzesten Prompt, mit dem ich diese CLI später wieder verwenden kann.

    Wenn Codex eine riesige JSON-Antwort zurückgibt, bitte es, die Standardausgabe zu begrenzen und für vollständige Payloads einen Dateiexport hinzuzufügen. Übersieht Codex, welche Befehle eine Genehmigung erfordern, lass es den zugehörigen Skill aktualisieren, bevor du ihn für eine andere Aufgabe verwendest.

    Verwende den Skill bei späteren Aufgaben

    Wenn du die CLI wieder brauchst, rufe den Skill auf. So musst du die Dokumentation nicht erneut einfügen.

    Lade mit $ci-logs die Logs der fehlgeschlagenen Jobs für diese Build-URL herunter und nenne mir den ersten fehlgeschlagenen Schritt.
    Suche mit $support-export nach Beschwerden dieser Woche zu Rückerstattungen und lies die drei Tickets mit den höchsten Beträgen.
    Finde mit $admin-api den Workspace dieser Person, lies den Abrechnungsdatensatz und entwirf eine Kontonotiz, die sich bedenkenlos hinterlegen lässt.

    Teste den Skill für wiederkehrende Aufgaben einmal in einem Chat. Bitte Codex anschließend, direkt im Chat eine Aufgabe mit demselben Aufruf zu planen.

    Verwandte Anwendungsfälle