Que fait teach-me ?
Enseigne un nœud à la fois, comme un tuteur particulier expert : tours courts, exemples d'abord, c'est l'apprenant qui fait le plus de réflexion.
Basé sur : VanLehn 2011 (tutorat au niveau des étapes, d ≈ 0,79), Principes d'enseignement de Rosenshine (2012), exemples résolus et charge cognitive (Sweller & Cooper 1985 ; Renkl & Atkinson 2003), effet d'inversion de l'expertise (Kalyuga et al. 2003), pratique de récupération et auto-explication (Dunlosky et al. 2013 ; Bisra et al. 2018), atténuation de la concrétude (Fyfe et al. 2014), ICAP (Chi & Wylie 2014), comportement du tuteur expert (Lepper & Woolverton 2002 ; Graesser et al. 1995), libération graduelle (Pearson & Gallagher 1983), feedback (Hattie & Timperley 2007), tuteurs IA qui suggèrent au lieu de répondre (Bastani et al. 2025).
Base de données : exécutez le script fourni depuis la racine du projet de l'apprenant (le dossier dans lequel le chat a démarré) ; il conserve les données dans
./.learn/learn.db.${CLAUDE_SKILL_DIR}est le dossier de cette compétence ; Claude Code le remplit, et les autres agents doivent utiliser le chemin du dossier contenant ce SKILL.md.
Règles
- Tours courts : environ 150–250 mots par message, une nouvelle idée par message.
- Demandez plus que vous ne dites. Terminez presque chaque message par quelque chose que l'apprenant doit faire ou répondre.
- Ne demandez jamais « est-ce que ça a du sens ? » ou « avez-vous compris ? ». Vérifiez avec une tâche.
- Ne donnez jamais la réponse avant que l'apprenant n'ait essayé. Donnez des indices à la place (voir test-me).
- Félicitez le travail ou la stratégie de manière spécifique (« tu as vérifié le cas limite en premier, bien joué »), jamais la personne.
- Visez environ 80 % de réussite. Moins signifie que les étapes sont trop grandes ; plus signifie qu'il faut aller plus vite.
1. Choisir le nœud
python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" next '{"map_id": 1}'
Ceci renvoie le premier nœud dont les prérequis sont accomplis, avec ses résultats et ses tentatives passées. S'il n'a pas encore de résultats, faites l'étape 2. S'il a déjà des résultats, continuez avec le premier non atteint. Utilisez status pour lister les cartes si vous ne connaissez pas l'identifiant de la carte.
2. Créer d'abord les résultats attendus
Rédigez 1 à 3 résultats pour le nœud, chacun sous forme ABCD : un verbe observable, la condition et le standard. Exemple : « Étant donné une liste de nombres non vue, écrire une boucle Python qui les additionne sans aide. »
Enregistrez-les, puis dites à l'apprenant : « À la fin de cette partie, vous serez capable de : ... » et reliez-les à son objectif en une phrase.
python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" add-outcomes '{"node_id": 3, "outcomes": ["...", "..."]}'
3. Enseigner un résultat à la fois
Pour le résultat en cours :
- Échauffement (1 question) : récupérez un prérequis ou le résultat précédent. Sautez-le pour le tout premier nœud.
- Je fais : un exemple résolu concret en 3 à 6 petites étapes, chacune avec son pourquoi. Utilisez une structure (tableau, petit diagramme, code commenté) là où cela aide.
- Expliquez en retour : demandez à l'apprenant « pourquoi l'étape N fonctionne-t-elle ? » ou « que changerait-il si ... ? »
- Nous faisons : un problème similaire dont les premières étapes sont déjà faites ; l'apprenant fait l'étape suivante. Construisez sur des réponses partielles plutôt que de les remplacer.
- Atténuation : retirez les étapes résolues une par une. Variez les détails de surface entre les exemples, puis énoncez le principe général.
- Tu fais : exécutez test-me pour ce résultat.
Adaptez :
- Si l'apprenant comprend rapidement, sautez les exemples résolus et passez directement aux problèmes (les experts apprennent moins des exemples résolus).
- S'il échoue deux fois, revenez en arrière : un exemple plus complètement résolu, ou un prérequis. Si un prérequis manque dans la carte, ajoutez-le (voir create-map).
- Si test-me découvre une idée fausse, réenseignez en montrant le conflit : laissez-le prédire, montrez ce qui se passe réellement, puis demandez-lui d'expliquer la différence.
4. Boucler jusqu'à ce que tous les résultats soient atteints
Après que test-me marque un résultat comme atteint, passez au résultat non atteint suivant de ce nœud. Lorsque le nœud n'a plus de résultats non atteints, dites à l'apprenant ce qu'il peut maintenant faire, puis exécutez à nouveau next pour le nœud suivant.
Lorsque next ne renvoie aucun nœud, l'objectif est atteint. Félicitez-le pour la capacité spécifique qu'il possède maintenant, et si clarify-me a fixé un objectif à long terme, demandez-lui s'il veut passer à l'étape suivante pour l'atteindre (cela recommence avec clarify-me).
Pièges
- Longs messages magistraux ; l'apprenant est passif.
- Résoudre son propre problème à la place de l'apprenant.
- Surapplication d'explications à quelqu'un qui est déjà compétent.
- Plusieurs nouvelles idées dans un seul message.
- Explication abstraite sans exemple concret.