Codex CLI-Skills
Skills sind ein Erweiterungsmechanismus für Codex CLI, mit dem du benutzerdefinierte Workflows und automatisierte Aufgaben erstellen kannst. Durch Skills kannst du definieren, wie sich Codex in bestimmten Szenarien verhält.
Was ist ein Skill?
Ein Skill ist ein konfigurierbares Verhaltensmuster, das Codex vorgibt, wie es mit bestimmten Arten von Aufgaben umgehen soll. Du kannst deine eigenen Skills erstellen, um:

- Häufige Entwicklungsaufgaben automatisieren
- Domänenspezifische Verarbeitungs-Workflows definieren
- Code-Review-Standards anpassen
- Projektspezifische Vorlagen und Regeln erstellen
Das Skill-System ermöglicht es Codex, sich an die Anforderungen verschiedener Projekte und Workflows anzupassen, als würde man seinem Team einen dedizierten Entwicklungsassistenten zuweisen.
Skill-Verzeichnisse
Codex lädt Skills von den folgenden Orten:
| Ort | Beschreibung |
|---|---|
~/.codex/skills/ | Globales Skill-Verzeichnis, für alle Projekte verfügbar |
{项目目录}/.codex/skills/ | Skill-Verzeichnis auf Projektebene |
Configure the specified directory | Angegeben über skills.directory in config.toml |
Skill-Verzeichnisse konfigurieren
Skill-Verzeichnisse anpassen
enabled = true
directory = "~/my-codex-skills"
Struktur der Skill-Dateien
Jeder Skill ist ein eigenständiger Ordner, der die folgenden Dateien enthält:
skill-name/ ├── skill.md # 技能定义文件(必需) └── (可选的辅助文件)
skill.md-Dateiformat
Beispiel einer Skill-Definition
name: Code-Review
description: Führe ein ausführliches Code-Review durch und gib Verbesserungsvorschläge
trigger: /review
---
# Code-Review-Skill
Wenn ein Benutzer ein Code-Review anfordert, führe die folgenden Schritte aus:
## Bewertungsstandards
1. Code-Lesbarkeit
2. Performance-Probleme
3. Sicherheitsrisiken
4. Einhaltung von Best Practices
5. Testabdeckung
## Ausgabeformat
Erstellen Sie den folgenden strukturierten Bericht:
- Liste der Probleme (nach Schweregrad sortiert)
- Verbesserungsvorschläge
- Code-Bewertung (1-10)
Skill-Metadaten
Der Anfang jeder Skill-Datei muss YAML-formatierte Metadaten enthalten:
| Feld | Type | Beschreibung | Erforderlich |
|---|---|---|---|
name | string | Skill-Name | Ja |
description | string | Skill-Beschreibung | Ja |
trigger | string | Trigger-Schlüsselwörter | nein |
Wenn die Eingabe mit dem Trigger des Skills übereinstimmt, verwendet Codex automatisch diesen Skill, um die Aufgabe zu bearbeiten.
Benutzerdefinierte Skills erstellen
Erstellen wir einen einfachen Skill als Beispiel:
Schritt 1: Ein Skill-Verzeichnis erstellen
Erstelle den Skill-Ordner
Schritt 2: Die Skill-Definition schreiben
Erstelle skill.md
name: Tests generieren
description: Unit-Tests für Code generieren
trigger: test
---
# Skill zum Generieren von Tests
Wenn ein Benutzer das Generieren von Tests anfordert, führe die folgenden Schritte aus:
## Schritte
1. Analysiere die Funktionalität des vorhandenen Codes
2. Identifiziere Randfälle, die getestet werden müssen
3. Wähle ein geeignetes Test-Framework
4. Generiere Testfälle
## Teststandards
- Die Testabdeckung sollte Normalfälle, Randfälle und Fehlerfälle umfassen
- Jeder Testfall sollte unabhängig sein und nicht von der Ausführungsreihenfolge anderer Tests abhängen
- Verwende klare Benennungen für Testfunktionen
## Ausgabeformat
Generiere Testcode, der direkt ausgeführt werden kann, und füge erforderliche Testdaten hinzu.
Schritt 3: Verwendung der Skill
Wenn du jetzt Inhalte im Zusammenhang mit "test" eingibst, verwendet Codex automatisch diese Skill:
Skills auslösen
Hilf mir, Tests für diese Funktion zu generieren
Bitte teste dieses Modul
Integrierte Skills
Codex enthält einige gängige integrierte Skills:
| Skill-Name | Trigger-Wörter | Beschreibung |
|---|---|---|
| Code-Review | Überprüfung, Audit | Code-Review durchführen und Verbesserungsvorschläge unterbreiten |
| Debugging | Debuggen, Debugging | Hilfe beim Auffinden und Beheben von Problemen |
| Refactoring | Refaktorisieren, Refactoring | Code-Struktur optimieren, ohne die Funktionalität zu ändern |
| Dokumentation | Doku, Dokumentation | Code-Dokumentation generieren |
Sie können das Verhalten integrierter Skills überschreiben, um Versionen zu erstellen, die den Projektanforderungen entsprechen.
Skill-Priorität
Wenn mehrere Skills übereinstimmen, wählt Codex nach folgender Priorität aus:
- Exakte Übereinstimmung (identische Triggerwörter)
- Enthält-Übereinstimmung (Eingabe enthält das Triggerwort)
- Semantische Übereinstimmung (KI bewertet Relevanz)
Erzwingen bestimmter Skills
Du kannst die Verwendung eines bestimmten Skills mit einem Slash-Befehl erzwingen:
Skill-Verwendung erzwingen
@skill-name deine Aufgabenbeschreibung
Erweiterte Skill-Konfiguration
Bedingte Trigger
Du kannst Skills so konfigurieren, dass sie unter bestimmten Bedingungen ausgelöst werden:
Beispiel für bedingten Trigger
name: Python Skill
description: Python-projektspezifische Handhabung
trigger: python
when:
file_pattern: "*.py"
directory: "src/"
---
# Python-Projekt-Skill
Dieser Skill wird nur beim Verarbeiten von Python-Dateien wirksam.
Mehrstufige Aufgaben
Skills können komplexe mehrstufige Workflows definieren:
Mehrstufige Skills
name: Vollständige Feature-Entwicklung
description: Vollständiger Workflow von den Anforderungen bis zur Implementierung
Trigger: Feature entwickeln
---
# Vollständiger Workflow zur Feature-Entwicklung
## Phase 1: Anforderungsanalyse
- Funktionale Anforderungen verstehen
- Randfälle identifizieren
- Datenstrukturen entwerfen
## Phase 2: Entwurf
- Funktions-/Klassenstruktur entwerfen
- Schnittstellen definieren
- Algorithmen auswählen
## Phase 3: Implementierung
- Code schreiben
- Kommentare hinzufügen
- Dokumentation schreiben
## Phase 4: Testen
- Unit-Tests schreiben
- Randfälle überprüfen
- Abdeckung prüfen
## Phase 5: Commit
- Einen Git-Commit erstellen
- Commit-Nachricht schreiben
Best Practices für Skills
Namenskonventionen
- Klare, beschreibende Namen verwenden
- Namen sollten die Funktionalität des Skills widerspiegeln
- Vermeiden Sie chinesische Namen (kann zu Kodierungsproblemen führen)
Auswahl von Trigger-Wörtern
- Wählen Sie häufig verwendete Schlüsselwörter
- Vermeiden Sie zu allgemeine Trigger-Wörter
- Berücksichtigen Sie die natürlichen Ausdrucksweisen der Nutzer
Skill-Granularität
- Die Verantwortung eines Skills auf einen einzigen Zweck beschränken
- Ein Skill löst einen Problemtyp
- Komplexe Workflows können durch Skill-Kombinationen realisiert werden
Ein guter Skill sollte Nutzern das Gefühl vermitteln, dass "Codex meine Bedürfnisse versteht", anstatt dass sie eine spezielle Syntax lernen müssen.
Skills verwalten
Verfügbare Skills auflisten
Skill-Liste anzeigen
/skills
Skills deaktivieren
Wenn Sie einen Skill nicht verwenden möchten, können Sie die entsprechende Datei löschen oder sie in ein anderes Verzeichnis verschieben.
Skills aktualisieren
Nach dem Ändern einer Skill-Datei müssen Sie Codex neu starten, damit die Änderungen wirksam werden.
Skill-Beispielbibliothek
OpenAI stellt offiziell einige vorgefertigte Skills als Referenz und zur Nutzung bereit:
Besuchen Sie das GitHub-Repository, um weitere Beispiele zu sehen:https://github.com/openai/codex/tree/main/skills
FAQ
Frage: Skill wird nicht ausgelöst?
Prüfen Sie, ob das Metadatenformat der Skill-Datei korrekt ist, stellen Sie sicher, dass das YAML-Header-Format korrekt ist und die Datei endet mit.mddie richtige Endung.
F: Wie debugge ich einen Skill?
Sie können es in Codex verwenden/debugBefehl zum Anzeigen detaillierter Informationen über das Skill-Matching.
F: Beeinflussen Skills das normale Verhalten von Codex?
Skills bieten nur Richtlinien; Codex trifft weiterhin eigenständige Entscheidungen. Wenn Skills unsachgemäß konfiguriert sind, verwendet Codex das Standardverhalten.
Weitere Erweiterungen