
de code-explainer74
Parcours interactifs du code qui analysent une base de code, planifient des segments et narrent les points forts avec une profondeur configurable et une intégration VS Code.
La compétence Code Explainer analyse un dépôt pour identifier une fonctionnalité ou un chemin de code, construit un plan de parcours segmenté et fournit des explications interactives avec des points forts et une narration TTS optionnelle. Elle prend en charge une configuration de modèle à plusieurs niveaux (éclaireur/vue d'ensemble vs planificateurs d'analyse approfondie), la génération de segments parallèles et un mode d'intégration de barre latérale qui route la sortie via une API HTTP locale lorsqu'elle est disponible. La compétence prescrit des listes de contrôle strictes pour les phases d'éclaireur, de planification, d'exécution et de clôture afin de garantir des parcours reproductibles et de haute qualité.
Utilisez cette compétence lorsqu'un utilisateur demande d'expliquer comment fonctionne le code, de "me guider" à travers un module, ou pour obtenir un parcours contextuel d'une fonctionnalité. Utilisez-la également lors de sessions de parcours actives où l'agent doit répondre à des questions et réponses de suivi basées sur l'état du segment actuel. Choisissez "Deep Dive" pour une analyse approfondie et "Overview" pour des résumés rapides.
explainer.sh state).Idéal pour les agents capables d'exécuter Bash, de gérer des sous-processus et d'interagir avec des barres latérales d'éditeur (agents Claude/Codex/autres agents spécialisés dans le code capables de CLI).
Code Explainer est une compétence de guidage interactif qui scanne une base de code, établit des plans de segments et narre les points forts du code via l'intégration de la barre latérale de VS Code et la TTS. Le fichier SKILL.md est bien structuré avec un système de niveaux de modèles, une checklist étape par étape et un tableau des erreurs courantes. Les scripts incluent un script shell de communication avec la barre latérale, un serveur TTS persistant, un générateur de podcasts et un installateur d'extension VS Code — tous ont échoué car des dépendances étaient manquantes (extension VS Code, modèle mlx_audio). Risque d'injection de shell dans les commandes save/load de explainer.sh où l'entrée utilisateur est interpolée dans le JSON sans assainissement.
mlx_audiovscode-extension-ecosystemCompétence solide conceptuellement. L'injection de shell dans save/load est la principale préoccupation — elle devrait utiliser une construction JSON appropriée (jq ou printf %s). Les scripts sont par ailleurs bien écrits avec une bonne gestion des erreurs et une documentation complète.