Compétence Agent Plugin Doctor
Cette compétence offre des capacités de diagnostic et de validation pour les plugins d'agents.
Exigences d'exécution
L'installation de cette compétence n'installe pas l'interface en ligne de commande Doctor. Doctor est un package npm séparé (@agent-plugins-doctor/cli, exposé via le binaire agent-plugins-doctor) que cette compétence invoque via le terminal :
- Bun —
bunx agent-plugins-doctor check <répertoire-du-plugin> - npm —
npx agent-plugins-doctor check <répertoire-du-plugin>
bunx/npx récupèrent l'interface CLI depuis le registre npm lors de la première utilisation et l'exécutent — aucune extraction de code source, construction d'espace de travail ou installation globale n'est requise. Au moins l'un de ces outils (Bun ou npm) doit être installé, accessible via le PATH, et capable d'atteindre le registre npm. Si aucun n'est disponible, les commandes ci-dessous échouent avec une erreur « commande introuvable ».
Quand utiliser cette compétence
Utilisez cette compétence lorsque les utilisateurs demandent :
- « Pourquoi mon plugin d'agent ne fonctionne-t-il pas ? »
- « Vérifie ce plugin d'agent »
- « Corrige ce plugin »
- « Ce plugin est-il compatible avec Cursor/Codex/VS Code ? »
- « Audite ce plugin d'agent »
- « Valide ce plugin »
Utilisation
Exécutez l'interface Doctor pour valider les plugins :
# Vérifier un plugin
bunx agent-plugins-doctor check <répertoire-du-plugin>
# Appliquer des corrections sûres
bunx agent-plugins-doctor fix <répertoire-du-plugin>
# Générer un rapport
bunx agent-plugins-doctor report <répertoire-du-plugin> --format markdown
# Vérifier la compatibilité
bunx agent-plugins-doctor compatibility <répertoire-du-plugin>
(npx agent-plugins-doctor ... fonctionne de manière identique avec npm.)
Ce qui est vérifié
Doctor valide :
- Le manifeste du plugin (plugin.json) par rapport au schéma officiel
- Les définitions de compétences (fichiers SKILL.md) pour leur exactitude
- Les configurations du serveur MCP (mcp.json) pour leur validité
- Les problèmes de sécurité (secrets, traversée de chemins, échappements de liens symboliques)
- La compatibilité avec les clients vérifiés (VS Code, Cursor, GitHub Copilot, ChatGPT & Codex, Kiro)
Sortie
Doctor fournit :
- Des messages d'erreur clairs avec des codes de diagnostic
- Les emplacements des fichiers
- Des explications sur ce qui ne va pas et pourquoi
- Des corrections automatiques sûres lorsque c'est possible
- Des rapports de compatibilité pour tous les clients vérifiés
Exemples
# Valider le répertoire courant
bunx agent-plugins-doctor check .
# Corriger les problèmes dans un plugin
bunx agent-plugins-doctor fix ./mon-plugin
# Générer un rapport au format markdown
bunx agent-plugins-doctor report ./mon-plugin --format markdown > rapport.md
# Vérifier la compatibilité avec un client spécifique
bunx agent-plugins-doctor compatibility ./mon-plugin --client cursor