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 :

- 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 :
| Emplacement | Description |
|---|---|
~/.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 directory | Spécifié via skills.directory dans config.toml |
Configuration des répertoires de compétences
Personnalisation des répertoires de compétences
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 :
| Champ | Type | Description | Requis |
|---|---|---|---|
name | string | Nom de la compétence | Oui |
description | string | Description de la compétence | Oui |
trigger | string | Mots-clés de déclenchement | non |
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
É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
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étence | Mots de déclenchement | Description |
|---|---|---|
| Revue de code | revue, audit | Effectuer une revue de code et fournir des suggestions d'amélioration |
| Débogage | déboguer, débogage | Aider à localiser et corriger les problèmes |
| Refactorisation | refactoriser, refactorisation | Optimiser la structure du code sans modifier les fonctionnalités |
| Documentation | doc, documentation | Gé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 :
- Correspondance exacte (mots déclencheurs identiques)
- Correspondance par inclusion (l'entrée contient le mot déclencheur)
- 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
@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
/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