Si Codex Skills est installé mais ne se déclenche pas, vérifiez d’abord s’il est situé dans le répertoire de scan et si le SKILL.md a name et description complets, puis appelez explicitement pour vérifier. La plupart des problèmes concernent des « compétences non découvertes » ou « les descriptions ne correspondent pas aux tâches ».
Le répertoire doit être correctement défini, et le nom du fichier ne doit pas changer
Les compétences spécifiques à l’entrepôt se trouvent dans :
$REPO_ROOT/.agents/skills/skill-name/SKILL.mdLes compétences personnelles universelles pour tous les projets incluent :
~/.agents/skills/skill-name/SKILL.mdCodex scanne .agents/skills du répertoire courant vers le répertoire racine du dépôt. Les compétences placées dans des annuaires adjacents en dehors de l’entrepôt ou qui manquent de dossiers de compétences séparés peuvent être indétectables.
La description détermine quand il faut déclencher
Le fichier minimum disponible doit inclure les informations d’en-tête YAML :
---
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 Soyez stable et évitez les noms en double ; description Énoncez clairement les objectifs de l’utilisateur, les conditions déclencheuses et les limites. Écrire uniquement « une compétence de publication très utile » ne comporte pas de signaux de tâche correspondants ; les scénarios clés doivent être placés au début de la description.
Les appels explicites peuvent distinguer deux types de problèmes
Saisissez /skills dans l’extension CLI ou IDE pour consulter la liste, ou tapez $ pour sélectionner des compétences. Si $release-checker est sélectionné et exécuté, cela signifie que l’installation fonctionne correctement. Ce qui nécessite une optimisation est description ; Si ce n’est pas dans la liste, vérifiez le répertoire, le nom du fichier et le format YAML.
Les mises à jour de compétences sont généralement découvertes automatiquement ; Redémarrez Codex lorsqu’il n’y a pas de rafraîchissement. Lorsqu’il y a trop de compétences, la liste initiale est limitée par le budget contextuel, les descriptions peuvent être raccourcies, certaines compétences peuvent être omis et des consignes peuvent apparaître. À ce stade, les compétences non liées doivent être désactivées ou les compétences requises explicitement invoquées.
Les compétences du même name ne seront pas automatiquement fusionnées. D’abord, confirmez le chemin dans /skills, gardez la bonne version, puis testez.
