Codex Compétences CLI

Les Skills sont un mécanisme d'extension pour Codex CLI qui vous permet de créer des workflows personnalisés et des tâches automatisées. Grâce aux Skills, vous pouvez définir le comportement de Codex dans des scénarios spécifiques.


Qu'est-ce qu'un Skill ?

Un Skill est un modèle de comportement configurable qui indique à Codex comment gérer des types de tâches spécifiques. Vous pouvez créer vos propres Skills pour :

Codex 技能系统

  • Automatiser les tâches de développement courantes
  • Définir des workflows de traitement spécifiques à un domaine
  • Personnaliser les normes de revue de code
  • Créer des modèles et des règles spécifiques au projet

Le système de compétences permet à Codex de s'adapter aux besoins de différents projets et workflows, comme si vous affectiez un assistant de développement dédié à votre équipe.


Répertoires de compétences

Codex charge les compétences depuis les emplacements suivants :

EmplacementDescription
~/.codex/skills/Répertoire de compétences global, disponible pour tous les projets
{项目目录}/.codex/skills/Répertoire de compétences au niveau du projet
Configure the specified directorySpécifié via skills.directory dans config.toml

Configuration des répertoires de compétences

Personnalisation des répertoires de compétences

[skills]
enabled = true
directory = "~/my-codex-skills"

Structure des fichiers de compétence

Chaque compétence est un dossier autonome contenant les fichiers suivants :

skill-name/
├── skill.md          # 技能定义文件(必需)
└── (可选的辅助文件)

Format du fichier skill.md

Exemple de définition de compétence

---
name: Revue de code
description: Effectuer une revue de code approfondie et fournir des suggestions d'amélioration
trigger: /review
---

# Compétence de revue de code

Lorsqu'un utilisateur demande une revue de code, effectuez les étapes suivantes :

## Normes de révision

1. Lisibilité du code
2. Problèmes de performance
3. Risques de sécurité
4. Respect des bonnes pratiques
5. Couverture des tests

## Format de sortie

Fournissez le rapport structuré suivant :
- Liste des problèmes (triés par gravité)
- Suggestions d'amélioration
- Score du code (1-10)

Métadonnées de compétence

Le début de chaque fichier de compétence doit contenir des métadonnées au format YAML :

ChampTypeDescriptionRequis
namestringNom de la compétenceOui
descriptionstringDescription de la compétenceOui
triggerstringMots-clés de déclenchementnon

Lorsque votre saisie correspond au déclencheur de la compétence, Codex utilisera automatiquement cette compétence pour traiter la tâche.


Création de compétences personnalisées

Créons une compétence simple comme exemple :

Étape 1 : Créer un répertoire de compétence

Créer le dossier de compétence

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

Étape 2 : Écrire la définition de la compétence

Créer skill.md

---
name: Générer des tests
description: Générer des tests unitaires pour le code
trigger: test
---

# Compétence : Générer des tests

Lorsqu'un utilisateur demande de générer des tests, effectuez les étapes suivantes :

## Étapes

1. Analyser la fonctionnalité du code existant
2. Identifier les cas limites à tester
3. Choisir un framework de test approprié
4. Générer des cas de test

## Normes de test

- La couverture doit inclure des cas normaux, des cas limites et des cas d'erreur
- Chaque cas de test doit être indépendant et ne pas dépendre de l'ordre d'exécution des autres tests
- Utilisez une nomenclature claire pour les fonctions de test

## Format de sortie

Générez du code de test qui peut s'exécuter directement, et incluez les données de test nécessaires.

Étape 3 : Utilisation de la compétence

Désormais, lorsque vous saisissez du contenu lié à « test », Codex utilisera automatiquement cette compétence :

Déclenchement des compétences

# Ces entrées déclencheront la compétence « Generate Test »
Aidez-moi à générer des tests pour cette fonction
Veuillez tester ce module

Compétences intégrées

Codex est fourni avec quelques compétences intégrées courantes :

Nom de la compétenceMots de déclenchementDescription
Revue de coderevue, auditEffectuer une revue de code et fournir des suggestions d'amélioration
Débogagedéboguer, débogageAider à localiser et corriger les problèmes
Refactorisationrefactoriser, refactorisationOptimiser la structure du code sans modifier les fonctionnalités
Documentationdoc, documentationGénérer la documentation du code

Vous pouvez redéfinir le comportement des compétences intégrées pour créer des versions qui répondent aux besoins du projet.


Priorité des compétences

Lorsque plusieurs compétences correspondent, Codex sélectionne selon la priorité suivante :

  1. Correspondance exacte (mots déclencheurs identiques)
  2. Correspondance par inclusion (l'entrée contient le mot déclencheur)
  3. Correspondance sémantique (l'IA évalue la pertinence)

Forcer des compétences spécifiques

Vous pouvez forcer l'utilisation d'une compétence spécifique à l'aide d'une commande slash :

Forcer l'utilisation d'une compétence

# Utiliser la commande de compétence
@skill-name description de votre tâche

Configuration avancée des compétences

Déclencheurs conditionnels

Vous pouvez configurer des compétences pour qu'elles se déclenchent sous des conditions spécifiques :

Exemple de déclencheur conditionnel

---
name: Python Skill
description: Gestion spécifique au projet Python
trigger: python
when:
  file_pattern: "*.py"
  directory: "src/"
---

# Compétence de projet Python

Cette compétence ne prend effet que lors du traitement de fichiers Python.

Tâches multi-étapes

Les compétences peuvent définir des flux de travail complexes à plusieurs étapes :

Compétences multi-étapes

---
name: Développement complet de fonctionnalité
description: Flux de travail complet, des exigences à la mise en œuvre
déclencheur : développer une fonctionnalité
---

# Flux de développement complet d'une fonctionnalité

## Phase 1 : Analyse des exigences
- Comprendre les exigences fonctionnelles
- Identifier les cas limites
- Concevoir les structures de données

## Phase 2 : Conception
- Concevoir la structure des fonctions/classes
- Définir les interfaces
- Choisir les algorithmes

## Phase 3 : Implémentation
- Écrire le code
- Ajouter des commentaires
- Rédiger la documentation

## Phase 4 : Tests
- Écrire des tests unitaires
- Vérifier les cas limites
- Vérifier la couverture

## Phase 5 : Commit
- Créer un commit Git
- Rédiger le message de commit

Bonnes pratiques des compétences

Conventions de nommage

  • Utilisez des noms clairs et descriptifs
  • Les noms doivent refléter la fonctionnalité de la compétence
  • Évitez d'utiliser des noms chinois (peut entraîner des problèmes d'encodage)

Choisir les mots déclencheurs

  • Choisissez des mots-clés couramment utilisés
  • Évitez les mots déclencheurs trop généraux
  • Tenez compte des façons naturelles de s'exprimer des utilisateurs

Granularité des compétences

  • Gardez une responsabilité unique pour une compétence
  • Une compétence résout un seul type de problème
  • Les flux de travail complexes peuvent être réalisés grâce à des combinaisons de compétences
Une bonne compétence devrait donner aux utilisateurs l'impression que « Codex comprend mes besoins », plutôt que de les obliger à apprendre une syntaxe spéciale.

Gestion des compétences

Lister les compétences disponibles

Afficher la liste des compétences

# Saisir dans Codex
/skills

Désactiver les compétences

Si vous ne souhaitez pas utiliser une compétence, vous pouvez supprimer le fichier correspondant ou le déplacer vers un autre répertoire.

Mettre à jour des Skills

Après avoir modifié un fichier de compétence, vous devez redémarrer Codex pour que les modifications prennent effet.


Bibliothèque d'exemples de compétences

OpenAI fournit officiellement quelques compétences préconstruites pour référence et utilisation :

Consultez le dépôt GitHub pour voir plus d'exemples :https://github.com/openai/codex/tree/main/skills


FAQ

Q : La compétence ne se déclenche pas ?

Vérifiez si le format des métadonnées du fichier de compétence est correct, assurez-vous que le format de l'en-tête YAML est correct et que le fichier se termine par.mdla fin correcte.

Q : Comment déboguer une compétence ?

Vous pouvez utiliser dans Codex/debugcommande pour afficher des informations détaillées sur la correspondance des compétences.

Q : Les compétences affecteront-elles le comportement normal de Codex ?

Les compétences ne fournissent que des lignes directrices ; Codex continue de porter des jugements indépendants. Si les compétences sont mal configurées, Codex utilisera le comportement par défaut.

Autres extensions