Codex mit Projektregeln und wiederverwendbaren Skills steuern

Codex kann ein Repository untersuchen, Änderungen umsetzen und Prüfungen ausführen. Gib ihm die lokalen Fakten, die es leicht falsch erraten könnte: Quellordner, Prüfbefehle und die Schnittstellen, die erhalten bleiben müssen.

Prüfe die geltenden Anweisungen

Codex baut seine Anweisungskette beim Start auf. Auf globale Vorgaben folgen Projektdateien vom Stammverzeichnis bis zum Arbeitsverzeichnis. AGENTS.override.md hat am selben Ort Vorrang vor AGENTS.md; später geladene Projektvorgaben können frühere überschreiben.

Die Suche hängt am Arbeitsverzeichnis. Das Öffnen einer beliebigen tieferen Datei lädt nicht automatisch eine neue Anweisungskette.

Beginne im vorgesehenen Verzeichnis:

Nenne dein Arbeitsverzeichnis und die geltenden Anweisungsdateien. Liste daraus die Build- und Prüfbefehle auf. Zeige Konflikte oder fehlende Befehle, bevor du die Prüfung dieser Aufgabe festlegst.

Öffne die genannten Dateien selbst, wenn dich die Antwort überrascht.

Schreibe Regeln für tatsächliche Änderungen

Eine kurze Stammdatei für eine statische Dokumentationsseite könnte so aussehen:

# Projektanweisungen

- Anleitungen liegen in src/guides, erzeugte Dateien in dist.
- npm test prüft Inhalte, Build und Browserverhalten.
- Neue Artikelkennungen mit npm run register:content registrieren.
- Produktspezifische Schritte mit dem tatsächlich verwendeten Tool kennzeichnen.
- Geänderte URLs in die Migrationsliste aufnehmen und alte Links prüfen.
- Fehlgeschlagene oder nicht verfügbare Prüfungen mit dem Diff melden.

Die Befehle passen zu diesem Repository. Ersetze sie für dein Projekt durch die tatsächlich vorhandenen Befehle. Eine Genehmigung oder Ausnahme für eine einzelne Aufgabe bleibt mit ihrem Umfang im Aufgabenprotokoll.

Verpacke eine erprobte Routine

Vielleicht prüfst du nach jeder Übersetzung dieselben Dinge: Abschnitte, Quellenlinks, beide Sprachversionen und die Sprachnavigation. Führe diese Routine erfolgreich aus, bevor du daraus einen Skill machst.

Ein Repository-Skill kann unter .agents/skills/check-translated-guide/SKILL.md liegen:

---
name: check-translated-guide
description: Prüft geänderte englische und deutsche Anleitungen auf fehlende Abschnitte, defekte Links und Sprachnavigation.
---

Beschreibe darunter Eingaben, Ablauf, benötigte Werkzeuge und Ergebnisbericht. Verweise auf vorhandene Skripte für deterministische Prüfungen. Codex unterstützt den ausdrücklichen Skill-Aufruf mit $ und lokale Skills unter .agents/skills. Berechtigungen kommen weiterhin aus der Sitzung.

Was schiefgeht

Eine lange Regeldatei sammelt widersprüchliche Vorgeschichte. Eine verschachtelte Vorgabe kann in der Startkette fehlen. Ein Skill mit „gründlich prüfen“ legt weder ein wiederholbares Verfahren noch dessen Abschluss fest.

Entferne die überholte Regel, starte im passenden Verzeichnis oder definiere das prüfbare Ergebnis des Skills.

So prüfst du das Ergebnis

Gib Codex eine kleine Änderung mit einem absichtlichen Verstoß gegen eine Projektregel. Prüfe, ob es die passende Vorgabe erkennt und echte Prüfungen ausführt. Teste den Skill an einer guten Übersetzung und einer mit fehlendem Abschnitt oder Link.

Vergleiche die gemeldeten Fehler mit den Dateien. Die Routine soll einen bekannten Fehler erkennen und ihre Belege nachvollziehbar hinterlassen.