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:

Codex 技能系统

  • 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:

OrtBeschreibung
~/.codex/skills/Globales Skill-Verzeichnis, für alle Projekte verfügbar
{项目目录}/.codex/skills/Skill-Verzeichnis auf Projektebene
Configure the specified directoryAngegeben über skills.directory in config.toml

Skill-Verzeichnisse konfigurieren

Skill-Verzeichnisse anpassen

[skills]
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:

FeldTypeBeschreibungErforderlich
namestringSkill-NameJa
descriptionstringSkill-BeschreibungJa
triggerstringTrigger-Schlüsselwörternein

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

mkdir -p ~/.codex/skills/Generate tests

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

# Diese Eingaben lösen die Skill "Generate Test" aus
Hilf mir, Tests für diese Funktion zu generieren
Bitte teste dieses Modul

Integrierte Skills

Codex enthält einige gängige integrierte Skills:

Skill-NameTrigger-WörterBeschreibung
Code-ReviewÜberprüfung, AuditCode-Review durchführen und Verbesserungsvorschläge unterbreiten
DebuggingDebuggen, DebuggingHilfe beim Auffinden und Beheben von Problemen
RefactoringRefaktorisieren, RefactoringCode-Struktur optimieren, ohne die Funktionalität zu ändern
DokumentationDoku, DokumentationCode-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:

  1. Exakte Übereinstimmung (identische Triggerwörter)
  2. Enthält-Übereinstimmung (Eingabe enthält das Triggerwort)
  3. Semantische Übereinstimmung (KI bewertet Relevanz)

Erzwingen bestimmter Skills

Du kannst die Verwendung eines bestimmten Skills mit einem Slash-Befehl erzwingen:

Skill-Verwendung erzwingen

# Befehl zum Verwenden eines Skills
@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

# In Codex eingeben
/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