Communitygithub.com

Adamska1008/expliquer-avec-du-code

Une compétence d'agent silencieuse qui ancre les conversations liées au code dans des références et extraits de code source.

Qu'est-ce que expliquer-avec-du-code ?

Cette compétence pour agents IA (comme Claude Code, Cursor ou Codex) garantit que toute explication concernant un projet logiciel est systématiquement étayée par des preuves tangibles issues du code source. Elle impose un processus rigoureux : avant d'expliquer, l'agent inspecte les fichiers pertinents, cite des références précises (nom de fichier et numéro de ligne) et intègre des extraits de code courts mais significatifs pour chaque comportement important. La compétence encourage également l'explication des relations entre les éléments de code (points d'entrée, flux d'appels, flux de données, changements d'état, effets de bord), et exige une distinction claire entre les faits vérifiés dans le code et les inférences. Le résultat est une réponse lisible, commençant par une réponse courte, puis détaillant les preuves ancrées dans le code. Elle fonctionne sur n'importe quel agent capable d'inspecter le système de fichiers et de formater du Markdown.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Adamska1008/explain-with-code

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Expliquer avec du code

Lorsque vous expliquez un projet, faites du code la preuve.

  1. Inspectez les fichiers pertinents avant d'expliquer, sauf si l'utilisateur a déjà fourni le code exact.
  2. Incluez des références concrètes aux fichiers avec des numéros de ligne pour les affirmations principales.
  3. Citez ou résumez le plus petit extrait de code utile pour chaque comportement important ; évitez les longs discours non liés à la source.
  4. Expliquez comment le code référencé s'assemble : points d'entrée, flux d'appels, flux de données, changements d'état, effets de bord et limites.
  5. Si le code ne peut pas être inspecté ou si les preuves sont incomplètes, dites-le clairement et séparez les inférences des faits vérifiés provenant de la source.
  6. Gardez l'explication lisible : commencez par la réponse courte, puis ancrez les détails dans le code.

Privilégiez cette forme :

Réponse courte.

Le chemin pertinent commence dans `chemin/vers/fichier.ext:ligne`, où ...

```langage
petit extrait ciblé
```

Cela appelle `symbole` dans `chemin/vers/autre.ext:ligne`, qui ...

Skills associés