Codex: von der Aufgabe zur geprüften Änderung

Öffne das Repository, das du ändern möchtest. Nenne Codex das Ziel, relevante Dateien, Einschränkungen und ein prüfbares Abschlusskriterium. Mit den nötigen Tools und Berechtigungen kann Codex Dateien untersuchen, Änderungen umsetzen, Prüfungen ausführen und den Diff durchsehen. Welche Tools verfügbar sind, hängt von deiner Einrichtung ab.

Probiere eine vollständige Aufgabe

Behebe, dass das Suchfeld nach jedem Tastendruck den Fokus verliert. Finde zuerst die Komponente und reproduziere den Fehler. Behalte das Design bei und füge keine Abhängigkeiten hinzu. Setze die Korrektur um, führe die relevanten Prüfungen aus und teste die Eingabe eines ganzen Satzes mit der Tastatur. Berichte, was geändert wurde, welche Prüfungen bestanden haben und was du nicht prüfen konntest. Bereite einen prüfbaren Diff vor.

Lass bei größeren Änderungen zuerst einen Plan erstellen. Kläre die Entscheidungen, die das Ergebnis beeinflussen, und beauftrage dann die Umsetzung. Für kleine Korrekturen genügt oft ein klares Abschlusskriterium.

Projektregeln in AGENTS.md festhalten

Codex liest AGENTS.md als Projektanleitung. Halte dort dauerhafte Fakten fest: Build-Befehl, wichtige Ordner, Konventionen und erforderliche Prüfungen. Die aktuelle Aufgabe gehört in deinen Prompt. Frage bei unerwartetem Verhalten nach den geltenden Anweisungen; spezifischere Regeln können allgemeinere überschreiben.

Für ein Projekt wie diese Website wäre beispielsweise nützlich:

Registriere geänderte URLs und ihre Weiterleitungen. Führe nach Template-Änderungen die Inhaltsprüfungen und den Build aus. Prüfe die erzeugten englischen und deutschen Seiten.

Aus einer Routine einen Skill machen

Ein Skill bündelt einen wiederholbaren Ablauf in einer SKILL.md, optional mit Skripten und Referenzen. Beginne mit einem Ablauf, der bereits funktioniert: etwa übersetzte Seiten auf fehlende Beschriftungen und defekte Links prüfen. Beschreibe Einsatzfall, Eingaben, Ergebnis und dessen Prüfung.

In Codex CLI oder der IDE-Erweiterung kannst du einen Skill mit $ nennen oder mit /skills suchen. Repository-Skills können unter .agents/skills liegen. Ein Skill liefert Anweisungen; er erteilt keinen Zugriff auf Tools oder Konten.

Was schiefgeht

„Verbessere die Website“ lässt das Ziel offen. Ein reiner Code-Auftrag kann ohne Prüfung der Bedienung enden. Eine veraltete AGENTS.md kann auf ungültige Befehle verweisen. Korrigiere die konkrete Anweisung oder das Abschlusskriterium, sobald die Ursache klar ist.

So prüfst du das Ergebnis

Lies den Diff und wiederhole die ursprünglich fehlerhafte Aktion selbst. Prüfe, welche Befehle tatsächlich ausgeführt wurden und welche Prüfungen blockiert waren. Tippe beim Suchbeispiel Text, lösche ihn und navigiere Ergebnisse ausschließlich mit der Tastatur. Ein erfolgreicher Build beweist noch nicht, dass der Fokus jetzt im Suchfeld bleibt.