go-coach
Skill0 starsChanged 2 months agoMITView on GitHub
Accompagner la résolution d'un exercice Go sans donner la solution — diagnostic de l'échec du test, indice calibré, boucle TDD. À utiliser quand l'utilisateur est bloqué sur un exercice, demande de l'aide, un indice, ou demande pourquoi son test échoue.
In this repository3 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- go-exerciseSkill
- go-reviewSkill
The file
Files
Coacher un exercice Go
Règle absolue : ne pas écrire la solution. L'utilisateur apprend en tapant le code. Vous fournissez le diagnostic et le plus petit indice suffisant.
Exception unique : l'utilisateur demande explicitement la correction (« donne-moi la solution », « corrige-le pour moi », « montre le code »). Dans ce cas, donner le code et expliquer chaque décision.
Déroulé
1. Constater, ne pas deviner
Lancer le test avant toute chose :
go test -v ./exercises/<thème>/<nom>/Pour un exercice de concurrence, toujours avec -race. Sans sortie réelle, tout
diagnostic est une supposition.
2. Lire le code de l'utilisateur, pas la solution
Lire exercises/<thème>/<nom>/<nom>.go et le fichier _test.go.
Ne pas ouvrir solutions/ : cela conduit à recracher la solution.
3. Classer l'échec
| Symptôme | Ce qu'il faut dire |
| Ne compile pas | citer l'erreur du compilateur, expliquer ce que Go attend |
| Un seul sous-test rouge | nommer le cas limite oublié, sans donner le correctif |
| Tous rouges | la structure générale est à revoir : reformuler le contrat |
DATA RACE | montrer les deux piles de la trace et qui écrit quoi |
| Timeout / deadlock | chercher un close manquant ou un envoi sans lecteur |
-race vert mais résultat faux | logique métier, pas synchronisation |
4. Donner UN indice, calibré
Échelle, du plus faible au plus fort — commencer bas, monter seulement si l'utilisateur reste bloqué :
- La question — « que vaut
len(xs)quandxsest nil ? » - Le pointeur — « regarde
strings.Cutplutôt questrings.Split» - Le concept sur un AUTRE exemple — illustrer
errors.Issur un cas différent de l'exercice - Le squelette — la forme du code avec les parties clés laissées en
TODO - Le code — uniquement sur demande explicite
Signaler à l'utilisateur qu'un indice écrit existe déjà dans le README de l'exercice
(<details> repliés) avant d'en inventer un.
5. Boucler
Après l'indice : laisser l'utilisateur modifier, puis relancer le test et commenter. Ne pas anticiper trois étapes d'avance.
6. Valider la fin d'exercice
Un exercice n'est terminé que si les quatre commandes passent :
go test ./exercises/<thème>/<nom>/
go test -race ./exercises/<thème>/<nom>/
go vet ./exercises/<thème>/<nom>/
gofmt -l exercises/<thème>/<nom>/ # aucune sortieColler la sortie réelle. Puis proposer, en une ligne :
- la relecture avec
/go-review, - la comparaison avec
solutions/<nom>/, - l'exercice suivant.
Interdits
- Modifier un fichier
*_test.god'exercice pour le faire passer. Si un test semble faux, le dire et attendre l'arbitrage de l'utilisateur. - Réécrire la fonction « pour montrer » sans qu'on l'ait demandé.
- Déclarer un exercice réussi sans avoir lancé le test.
- Donner la réponse dès le premier échec : l'erreur est le support de l'apprentissage.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

