agentleFS
drangohtdrangoht/go-training/.claude/skills/go-coach/SKILL.md

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.

The file

Files
SKILL.md

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ômeCe qu'il faut dire
Ne compile pasciter l'erreur du compilateur, expliquer ce que Go attend
Un seul sous-test rougenommer le cas limite oublié, sans donner le correctif
Tous rougesla structure générale est à revoir : reformuler le contrat
DATA RACEmontrer les deux piles de la trace et qui écrit quoi
Timeout / deadlockchercher un close manquant ou un envoi sans lecteur
-race vert mais résultat fauxlogique 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é :

  1. La question — « que vaut len(xs) quand xs est nil ? »
  2. Le pointeur — « regarde strings.Cut plutôt que strings.Split »
  3. Le concept sur un AUTRE exemple — illustrer errors.Is sur un cas différent de l'exercice
  4. Le squelette — la forme du code avec les parties clés laissées en TODO
  5. 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 sortie

Coller 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.go d'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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.