Zum Hauptinhalt springen

Skills und Werkzeuge

Gemeinsame Skills liegen in .agents/skills/. Bearbeiten Sie diese Quellen und führen Sie anschließend yarn ai-workflow:sync aus, um .claude/skills/ für Claude Code zu erzeugen. Codex erkennt Skills direkt in .agents/skills/.

Gemeinsame Rollen-Prompts liegen in .agents/roles/*.md. Das ist ein repository-spezifisches Quellformat, kein nativer Erkennungspfad für Agenten. scripts/ai-workflow-files.mjs wandelt diese Quellen in die unten aufgeführten app-spezifischen Dateien um; yarn ai-workflow:sync schreibt sie. Committen Sie die erzeugten Dateien zusammen mit ihren Quellen, damit ein frischer Checkout die native Konfiguration hat, ohne zuerst einen Generator auszuführen. Entfernen Sie nach dem Löschen einer Quelle deren veraltete erzeugte Ausgaben ausdrücklich; der Validator meldet sie, statt Dateien stillschweigend zu löschen.

Native Erkennungspfade​

Am 2026-09-12 mit der offiziellen Dokumentation abgeglichen:

AppProjektanweisungenVon diesem Repository genutzte SkillsVon diesem Repository genutzte benutzerdefinierte Agenten
CodexAGENTS.md.agents/skills/<name>/SKILL.mdErzeugte .codex/agents/<name>.toml
Claude CodeCLAUDE.md importiert @AGENTS.mdErzeugte .claude/skills/<name>/SKILL.mdErzeugte .claude/agents/<name>.md

Quellen: Codex-Skills, Codex-Subagenten, Claude-Memory, Claude-Skills, Claude-Subagenten.

Ersetzen Sie die nativen Agentenverzeichnisse nicht durch .agents/roles und gehen Sie nicht davon aus, dass Claude .agents/skills erkennt. Claude kann eine dort referenzierte Datei trotzdem als gewöhnlichen Projektkontext lesen.

Die KI-Verzeichnisse verwenden über .gitattributes LF-Zeilenenden, damit erzeugter Text plattformübergreifend identisch bleibt. Unterstützende Skill-Assets werden byteweise kopiert.

Skills​

SkillZweck
commitAutorisierte, klar abgegrenzte lokale Commits erstellen
commit-format, issue-formatAuf Anfrage Formatvorschläge machen
make-closed-issueEin autorisiertes Issue, einen abgegrenzten Commit und einen PR erstellen
review-and-merge-prPR-Feedback sichten; nur im angefragten Umfang korrigieren, veröffentlichen oder mergen
fix-merge-conflictsKonflikte auflösen und das zusammengeführte Ergebnis verifizieren
releaseRelease-Texte vorbereiten und autorisierte Release-Schritte ausführen
code-quality-reviewNicht triviale Diffs oder ein ausdrücklich angefragtes Qualitätsanliegen prüfen
retroNachgewiesene Fehler in gezielte Prüfungen oder Leitlinien umwandeln, die eine Wiederholung verhindern
refactor-pass, deslopAngefragtes Aufräumen bestehender Änderungen
debug-agentBelegbasiertes Debugging, bei Bedarf mit Instrumentierung
you-might-not-need-an-effectGezieltes Review von Effects und Memos
vercel-react-best-practicesZutreffende React-Performance-Leitlinien; Next.js- und reine Server-Regeln für diesen Vite-Client überspringen
translateÜbersetzungen erzeugen und die Maps dann über einen einzigen Schreiber anwenden
playwright-cli, inspect-elementsBrowser-Verifikation und Zuordnung vom DOM zum Quellcode
profile-browsingAbgegrenztes Browser- und React-Profiling
test-apkEinen bereitgestellten Android-Begleit-Wrapper verifizieren
impeccable, improve-threejsAbgegrenztes Interface-Design und Review des Three.js-Renderings
implement-planEinen Plan ausführen, optional mit begrenzter Delegation
readmeVerifizierte Projektdokumentation pflegen
context7Zur Version passende Bibliotheksdokumentation abrufen
find-skillsAuf ausdrückliche Anfrage zusätzliche Skills finden

Rollen und Modelle​

Behalten Sie die benutzerdefinierten Rollen für browser-check, profiler, test-apk, translator und reviewer bei. Verwenden Sie für gewöhnliche Implementierung und Code-Erkundung die eingebaute Worker-/General-Purpose- oder Explorer-Rolle des Harness. Der übergeordnete Agent legt Akzeptanzkriterien und Zuständigkeiten fest; ein einziger Zuständiger führt aufwendige Prüfungen aus.

Codex-Agentendateien enthalten name, description und developer_instructions. .codex/config.toml begrenzt gleichzeitige Kind-Agenten über max_concurrent_threads_per_session auf vier. Gemeinsame Rollenmetadaten enthalten Name, Beschreibung und einen optionalen Sandbox-Modus; Modellfelder fehlen absichtlich.

Lassen Sie Modell- und Reasoning-Felder in eingecheckten Skills und benutzerdefinierten Agenten weg. So greifen die Wahl beim Aufruf, Nutzervorgaben und die Vererbung vom übergeordneten Agenten gemäß der dokumentierten Rangfolge der jeweiligen App. Aliasse für Claude-Modellfamilien verringern den Pflegeaufwand bei neuen Versionen, legen aber dennoch eine Familie fest. Halten Sie solche Entscheidungen bei Bedarf in Nutzer- oder Sitzungseinstellungen fest. Vererbung verspricht keine automatische Wahl des derzeit besten Modells. Erfinden Sie keinen latest-Alias und ergänzen Sie Routineaufgaben nicht um Recherchen im Modellkatalog. Siehe Auswahl in Codex und Auswahl in Claude.

sandbox-mode: read-only entspricht der Sandbox von Codex. Bei Claude beschränken die Werkzeugliste und die Rollenanweisungen den Review-Workflow, Bash-Zugriff ist jedoch keine Sandbox auf Betriebssystemebene.

Gemeinsames Skill-Frontmatter verwendet, wo zutreffend, disable-model-invocation: true für Workflows, die der Nutzer aufruft. Die entsprechende Einstellung von Codex steht in agents/openai.yaml als policy.allow_implicit_invocation: false; der Validator verlangt beides. Aufrufmetadaten ergänzen die Regeln zur ausdrücklichen Autorisierung; eine Review-Anfrage autorisiert niemals eine Veröffentlichung, nur weil ein Skill Veröffentlichungsschritte enthält.

Prüfungen und Erkennung​

  • yarn ai-workflow:sync erzeugt die Kompatibilitätsausgaben mit den installierten js-yaml und smol-toml neu.
  • yarn ai-workflow:check parst Quellen, Frontmatter und Konfigurationen und prüft erzeugte Ausgaben, Aufrufmetadaten, die Platzierung von Modellfeldern sowie die Verdrahtung des reinen Formatter-Hooks. Modellbezeichner gleicht es nicht mit dem Katalog eines Anbieters ab.
  • yarn ai-workflow:test führt isolierte Node-Fixtures für Hook-Payloads und für die Erzeugung und Validierung des Workflows aus.
  • Verifizieren Sie nach dem Upgrade einer Agenten-App, dass diese App Skills und Rollen erkennt. Syntax- und Paritätsprüfungen ersetzen keine Prüfung des Loaders. Laden Sie die App neu, wenn eine bestehende Sitzung noch einen alten Katalog verwendet.
  • Hooks setzen das Projektvertrauen und die Hook-Prüfung des Harness voraus; umgehen Sie das Vertrauen nicht, nur damit eine Prüfung besteht. Siehe hooks-setup.md.

Nützliche Anweisungen pflegen​

Folgen Sie OpenAIs Leitfaden zu Skills und Prompts (geprüft am 2026-09-12): Halten Sie Beschreibungen präzise, laden Sie Details nur, wenn sie relevant sind, und wahren Sie den vom Nutzer angefragten Umfang. Gemeinsame Skills dienen unterschiedlichen Modellen; behalten Sie projektspezifische Invarianten bei und lassen Sie Spielraum für routinemäßige Implementierungsentscheidungen.

Halten Sie Zweck, Entscheidungsgrenzen und wesentliche Einschränkungen eines Skills in SKILL.md fest. Verlinken Sie umfangreiche modusspezifische Befehle oder Beispiele als optionale Referenzen. Nennen Sie Auslösebedingungen früh in kurzen Beschreibungen; ein passendes Schlüsselwort allein sollte die Aufgabe nicht ausweiten. Behalten Sie bestehende Aufrufmetadaten bei, sofern ihr Verhalten nicht bewusst geändert wird.

Testen Sie nach einer wesentlichen Änderung der Anweisungen einige repräsentative kleine und große Anfragen. Prüfen Sie, welche Skills und Referenzen ausgewählt wurden, ob die Aktionen im vorgesehenen Umfang blieben, ob die Verifikation zur Änderung passte und ob die autorisierte Arbeit abgeschlossen wurde. Schema- und Fixture-Tests belegen die Korrektheit der Werkzeuge, nicht die Entscheidungsqualität der Agenten.

Werkzeuge und Browser-Zuständigkeit​

Bevorzugen Sie den vorhandenen Skill- und Werkzeugkatalog sowie die installierten Projekt-CLIs. Verwenden Sie gh für GitHub, playwright-cli für Browser-Verifikation und offizielle bzw. versionsspezifische Dokumentation, wenn es auf das Verhalten einer Bibliothek ankommt. Installieren Sie keine doppelten Skills und laden Sie kein ungepinntes Paket, nur um einen vorhandenen Formatter auszuführen.

Der MCP-Overhead hängt vom Harness ab: Verzögertes Laden von Werkzeugen kann vermeiden, dass jedes Schema vorab geladen wird. Halten Sie Integrationen relevant, statt MCP an sich für überholt zu halten. Bestehende CLI-Entscheidungen bleiben für Reproduzierbarkeit und Ressourcenkontrolle nützlich.

Alle Browser-Sitzungen verwenden ./scripts/pw-session.sh, das maschinenweit nur einen aktiven Browser zulässt. Starten Sie standardmäßig eine frische, isolierte Sitzung. Zugriff auf den aktuellen persönlichen Browser erfordert eine ausdrückliche Autorisierung; diese Autorisierung gilt dann auch für die folgenden Schritte. Wählen Sie Browser und Viewports passend zum betroffenen Verhalten, führen Sie ausgewählte Engines nacheinander aus, schließen Sie beim Aufräumen genau die benannte Sitzung und verwenden Sie niemals close-all/kill-all. Siehe den Skill playwright-cli und verification.md.