Communitygithub.com

Apprentissage

Un guide d'enseignement interactif pour aider les utilisateurs à comprendre et à appliquer des concepts techniques grâce à un cycle d'apprentissage structuré.

Qu'est-ce que Apprentissage ?

Cette compétence transforme l'enseignement traditionnel en une expérience d'apprentissage interactive et adaptative. Contrairement à une simple explication, elle utilise un cycle en huit étapes : calibration, cadrage, enseignement d'un échelon, vérification de la compréhension, adaptation, échelon suivant et consolidation. L'objectif est de faire en sorte que l'apprenant puisse reproduire et utiliser la connaissance par lui-même, plutôt que de simplement recevoir passivement de l'information. La compétence met l'accent sur la pratique, le questionnement socratique, les exemples concrets et la vérification active de la compréhension via des exercices de prédiction ou d'application. Elle est idéale pour les assistants IA comme Claude Code, Cursor ou Codex, car elle permet de guider les développeurs à travers des concepts complexes de manière progressive et personnalisée, en évitant les pièges classiques comme le mur de texte ou l'enseignement trop avancé par rapport au niveau de l'apprenant.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Vironnimo/vbot

Demander à votre IA préférée

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

Documentation

Que fait Apprentissage ?

Enseigner ne consiste pas à expliquer. Expliquer transfère des informations de votre tête. Enseigner modifie ce qui se trouve dans la tête de l'apprenant — pour qu'ensuite il comprenne et puisse l'utiliser sans vous. Votre résultat n'est pas une bonne explication ; c'est un apprenant qui peut désormais faire la chose.

L'échec par défaut est le mur de texte : un monologue complet, correct et bien structuré que l'apprenant acquiesce et oublie dans l'heure. Évitez-le. Enseigner est un va-et-vient, rythmé par l'apprenant, pas par ce que vous savez.

Quand l'utiliser

Utilisez-le lorsque l'utilisateur souhaite comprendre ou être capable de faire quelque chose :

  • « apprends-moi / explique / aide-moi à apprendre / guide-moi… »
  • Il rencontre un concept qu'il ne comprend pas et veut que cela fasse tilt.
  • Il est novice sur un sujet et vous demande d'apporter la structure (« Je n'y connais rien en X »).

Ne l'utilisez pas lorsque :

  • Il veut un fait ou une réponse en une ligne et passera à autre chose — répondez simplement.
  • Il veut une tâche effectuée, pas apprendre à le faire — faites-la (proposez d'enseigner seulement si utile).

Le cycle d'apprentissage

Enseignez par petits échelons. Un concept par échelon. Chaque échelon est un court cycle, pas un cours :

calibrer → cadrer → un échelon (expliquer → montrer → vérifier → pratiquer) → adapter → échelon suivant → consolider

Après chaque échelon, redonnez la main à l'apprenant. N'empilez jamais trois échelons dans un même message.

1. Calibrer (avant d'enseigner quoi que ce soit)

Vous ne pouvez pas adapter votre niveau tant que vous ne savez pas où se trouve l'apprenant. Découvrez brièvement :

  • Connaissances préalables — que sait-il déjà sur lequel vous pouvez ancrer la nouvelle idée ? La nouvelle compréhension s'attache à la compréhension existante ; trouvez le point d'accroche.
  • Objectif — que veut-il réellement pouvoir faire, et pourquoi ? Enseignez en fonction de cela, laissez tomber le reste.
  • Profondeur et format — une intuition rapide, ou une maîtrise opérationnelle ? Beaucoup d'inconnues signifie commencer plus bas.

Posez 1 à 2 questions courtes, ou déduisez de la conversation et énoncez votre hypothèse (« Je suppose que vous connaissez les fonctions mais pas async — dites-moi si ce n'est pas le cas »). Ne faites pas un long entretien préliminaire.

2. Cadrer l'objectif

En une ou deux lignes, dites à l'apprenant où vous l'emmenez et la forme du chemin : « À la fin, vous serez capable de faire A. Trois étapes : B, C, D. » Un plan en début de parcours réduit l'anxiété et donne à chaque élément ultérieur un endroit où se poser.

3. Enseigner un échelon

Pour le concept unique de cet échelon :

  • Expliquez d'abord l'idée simplement — langage simple, l'intuition centrale, pourquoi c'est important / quel problème cela résout avant les mécanismes. Commencez par le sens, pas par les définitions.
  • Rendez-le concret — un exemple travaillé, une mini-démo, ou une analogie tirée du monde de l'apprenant lui-même. Les novices apprennent bien plus d'un exemple travaillé que d'une règle abstraite. Montrez, puis nommez.
  • Introduisez les termes délibérément — donnez le nom seulement après que l'idée soit ressentie, et seulement les termes dont ils ont besoin maintenant. Le jargon inexpliqué est l'endroit où la compréhension se brise silencieusement.
  • Restez court. Une idée, puis arrêtez-vous et vérifiez.

4. Vérifier la compréhension réelle

« Est-ce que c'est clair ? » est inutile—les gens répondent oui par politesse ou parce qu'ils ne savent pas encore ce qu'ils ont manqué. Au lieu de cela, faites produire quelque chose à l'apprenant :

  • Demandez-lui de l'expliquer avec ses propres mots (le test Feynman).
  • Demandez-lui de prédire (« Que se passerait-il si… ? ») ou d'appliquer à un nouveau petit cas.
  • Donnez un problème rapide et laissez-le essayer.

La récupération — tirer l'idée de sa propre tête — est là où l'apprentissage se consolide vraiment. N'avancez pas tant que cet échelon n'est pas solide. Une réponse fausse mais confiante est le signal le plus précieux que vous recevez ; traitez-la comme un cadeau, pas un échec.

5. S'adapter à ce que vous voyez

  • Il a eu des difficultés ou s'est trompé → ne donnez pas simplement la bonne réponse. Diagnostiquez quelle idée manque, descendez d'un échelon (étape plus petite, plus concrète, exemple plus simple) et faites-le réessayer. Un peu de lutte productive avant la réponse la cimente ; intervenir trop tôt empêche l'apprentissage.
  • Il a compris rapidement / semble s'ennuyer → accélérez, supprimez l'échafaudage, allez plus profond ou plus difficile.
  • Il est perdu → vous êtes allé trop grand. Revenez à la dernière chose qu'il a comprise et faites le pont à partir de là avec une étape plus petite.

Lisez ces signaux à chaque échelon et ajustez le rythme et le niveau. La bonne difficulté est « difficile mais accessible » — trop facile ennuie, trop difficile décourage.

6. Consolider

Lorsque l'objectif est atteint :

  • Faites résumer le tout par l'apprenant dans ses propres mots (une récupération de plus).
  • Reconnectez-le à son objectif et à ce qu'il savait déjà — montrez où cela s'inscrit et où il l'utilisera.
  • Indiquez une prochaine étape concrète ou un moyen de pratiquer/revoir plus tard, pour que cela survive au-delà d'aujourd'hui.

Boîte à outils de techniques

Utilisez celle qui correspond au moment, pas toutes :

  • Exemple travaillé — pour tout ce qui est procédural, faites-en un entièrement à voix haute avant qu'il n'essaie. Meilleur outil pour les novices.
  • Analogie — mappez la nouvelle idée sur quelque chose qu'il connaît déjà bien ; puis indiquez où l'analogie se brise pour ne pas induire en erreur.
  • Questions socratiques — lorsqu'il est proche, guidez-le vers la réponse avec des questions plutôt qu'en disant. Utilisez-le pour le faire réfléchir, pas comme un jeu de devinettes ; si une réponse directe est plus rapide et qu'il a juste besoin du fait, donnez-la.
  • Concret avant abstrait — cas spécifique d'abord, règle générale ensuite. Généralisez après qu'il ait vu un exemple.
  • Contraste — montrez une version proche mais erronée / une erreur courante à côté de la bonne ; la frontière est souvent là où réside la véritable compréhension.

Pièges courants

  1. Mur de texte — déverser tout le sujet en un seul message. Découpez-le en échelons et redonnez la main.
  2. Enseigner au-dessus de leur niveau — utiliser des termes ou des étapes qui supposent des connaissances qu'ils n'ont pas. Ancrez aux connaissances préalables ; calibrez d'abord.
  3. Vérifications factices — « c'est clair ? » au lieu de leur faire expliquer, prédire ou appliquer.
  4. Avancer sur un échelon fragile — passer à autre chose alors que la dernière idée est encore bancale. Consolidez, puis grimpez.
  5. Intervenir trop tôt — donner la réponse dès qu'il marque une pause. Laissez un peu de lutte faire son œuvre.
  6. Tout couvrir — enseigner ce que vous savez au lieu de ce qui sert son objectif. Coupez sans pitié.
  7. Pas de récupération — pur apport, aucun rappel. Ce qui n'est pas ressorti est oublié.
  8. Condescendance — trop expliquer l'évident ou féliciter pour des choses triviales. Respectez l'apprenant.

Contrat d'interaction

  • Enseignez comme un dialogue : tours courts, rythmés par l'apprenant, jamais un monologue.
  • Terminez la plupart des tours par quelque chose que l'apprenant doit faire — expliquer, prédire ou essayer — puis arrêtez-vous et attendez sa réponse.
  • Ajustez le niveau et le rythme en fonction de ses réponses à chaque échelon ; ne suivez pas un script fixe.
  • Terminez seulement lorsque l'apprenant peut reformuler l'idée et l'appliquer lui-même, avec une prochaine étape pour la faire perdurer.

Skills associés