Wird Codex Skills nach der Installation nicht ausgelöst? Überprüfen Sie das Inhaltsverzeichnis und die Beschreibungen

Wenn Codex Skills installiert ist, aber nicht ausgelöst wird, prüfen Sie zunächst, ob es im Scan-Verzeichnis liegt und ob das SKILL.md vollständige name und description hat, und rufen Sie dann explizit zur Verifizierung auf. Die meisten Probleme sind "Fähigkeiten nicht entdeckt" oder "Beschreibungen stimmen nicht mit den Aufgaben überein."

Das Verzeichnis muss korrekt gesetzt werden, und der Dateiname darf sich nicht ändern

Lagerspezifische Fähigkeiten befinden sich in:

$REPO_ROOT/.agents/skills/skill-name/SKILL.md

Universelle persönliche Fähigkeiten für alle Projekte umfassen:

~/.agents/skills/skill-name/SKILL.md

Der Codex scannt .agents/skills vom aktuellen Verzeichnis zum Repository-Root-Verzeichnis. Fähigkeiten, die in benachbarten Verzeichnissen außerhalb des Lagers platziert sind oder separate Fertigkeitsordner fehlen, können nicht nachweisbar sein.

Die Beschreibung bestimmt, wann ausgelöst werden soll

Die minimal verfügbare Datei sollte YAML-Headerinformationen enthalten:

---
name: release-checker
description: Use when checking whether a web project is ready to release, including build, tests and rollback verification.
---

Follow the project release checklist and report every failed check.

name Sei stabil und vermeide doppelte Namen; description Klarstellen Sie die Ziele, Auslöserbedingungen und Grenzen des Nutzers. Nur "eine sehr nützliche Veröffentlichungsfähigkeit" zu schreiben, hat keine passenden Aufgabensignale; Schlüsselszenarien sollten am Anfang der Beschreibung platziert werden.

Explizite Aufrufe können zwischen zwei Arten von Problemen unterscheiden

Geben Sie /skills in der CLI- oder IDE-Erweiterung ein, um die Liste anzuzeigen, oder tippen Sie $, um Fähigkeiten auszuwählen. Wenn $release-checker ausgewählt und ausgeführt wird, bedeutet das, dass die Installation ordnungsgemäß funktioniert. Was optimiert werden muss, ist description; Wenn es nicht in der Liste ist, überprüfe das Verzeichnis, den Dateinamen und das YAML-Format.

Fertigkeitsupdates werden in der Regel automatisch entdeckt; Starte Codex neu, wenn kein Aktualisieren stattfindet. Wenn es zu viele Fähigkeiten gibt, ist die anfängliche Liste durch das Kontextbudget begrenzt, Beschreibungen können gekürzt werden, einige Fähigkeiten fehlen und Prompts erscheinen. An diesem Punkt sollten nicht verwandte Fähigkeiten deaktiviert oder ausdrücklich geforderte Fähigkeiten aktiviert werden.

Fähigkeiten derselben name werden nicht automatisch zusammengeführt. Zuerst den Pfad in /skills bestätigen, die korrekte Version behalten und dann testen.