go-review
Skill0 starsChanged 2 months agoMITView on GitHub
Relire du code Go selon les conventions du dépôt (docs/BEST-PRACTICES.md) — nommage, erreurs, interfaces, concurrence, tests, allocations. À utiliser après avoir terminé un exercice, ou quand l'utilisateur demande une revue, une relecture, un avis sur son code Go.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- y-miyazaki/configtheir own version, first seen Nov 14, 2026
- BaratovSokhibjon/skillstheir own version, first seen Oct 25, 2026
- ArangoGutierrez/claude-toolkittheir own version, first seen Oct 15, 2026
- tslateman/skillstheir own version, first seen Oct 11, 2026
- weiweimhy/agent-skillstheir own version, first seen Jul 1, 2026
- TheKREATORS/my-claude-skillstheir own version, first seen Mar 19, 2026
Used with
Projects with it also use typescript-review and refactor.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
samsam007bSkilltypescript-review
TypeScript & code quality audit: strict mode, explicit types, no-any, SOLID patterns, Clean Code naming. Sources: Martin Fowler, Google Engineering Practices, Microsoft TypeScript Handbook.
Also in 3 projects that use this
GitHubSkillrefactor
Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.
Also in 3 projects that use this
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- ArangoGutierrez/claude-toolkit★ 4same name
- BaratovSokhibjon/skills★ 1same name
- TheKREATORS/my-claude-skills★ 1same name
- tslateman/skills★ 1same name
- y-miyazaki/config★ 1same name
- weiweimhy/agent-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- go-coachSkill
- go-exerciseSkill
The file
Files
Revue de code Go
Objectif : faire passer du code « qui marche » à du code « idiomatique ». Le vert des tests est un prérequis, pas une conclusion.
1. Outils d'abord
Ne jamais signaler à la main ce qu'un outil trouve :
gofmt -l . # aucune sortie attendue
go vet ./...
go test ./...
go test -race ./... # obligatoire dès qu'il y a une goroutine
golangci-lint run # si installéLancer ces commandes avant de lire le code, et coller la sortie réelle.
2. Grille de relecture
Parcourir dans cet ordre. Pour chaque point : citer fichier.go:ligne, montrer
l'avant/après, dire pourquoi.
Correction
- Erreur ignorée (
_ = err) ou perdue en chemin %woublié :errors.Is/errors.Asne retrouvent plus rien en amont- Comparaison
err == ErrXau lieu deerrors.Is - Slice de l'appelant mutée sans que le contrat le dise
- Slice
nilretournée là où[]est attendu (nullen JSON) - Indice hors bornes possible, division par zéro, entier qui déborde
- Pointeur nil retourné dans une interface
error
Concurrence
- Goroutine sans condition d'arrêt garantie
closepar le consommateur, ou doubleclose- Envoi sur channel sans
selectsurctx.Done()→ fuite si personne ne lit wg.Addà l'intérieur de la goroutine au lieu d'avant lego- Accès concurrent à une map ou un champ sans verrou
- Struct contenant un
sync.Mutexcopiée (récepteur valeur) —go vetle dit time.Sleeplà où une attente interruptible est requise
Idiomes
elseaprès unreturn: aplatir, chemin heureux à gauche- Imbrication > 3 niveaux : sortir tôt
- Nom de package
utils/helpers/common - Bégaiement
user.NewUser, acronymeId/Url, getterGetX - Interface définie côté implémentation plutôt que côté consommateur
- Interface à plus de 3 méthodes
anylà où un paramètre de type ferait l'affairepanichors d'un helperMustXxxsur valeur codée en dur- Identifiant exporté sans doc comment, ou doc ne commençant pas par son nom
Tests
- Cas limites absents : vide, nil, zéro, négatif, doublon
- Message d'échec sans
got/want t.Fatallà oùt.Errorpermettrait de voir tous les échecs (ou l'inverse)- Assertion sur un ordre issu d'une map sans tri
- Test dépendant du temps réel sans marge (flaky)
t.Helper()manquant dans une fonction d'assertion
Performance — seulement si mesurée
appenddans une boucle sans préallocation, taille connue- Concaténation
+=en boucle au lieu destrings.Builder - Conversions
[]byte↔stringrépétées deferdans une boucle chaude
Ne jamais proposer une micro-optimisation sans benchmark à l'appui.
3. Format du retour
## Bloquant
1. `fichier.go:42` — <problème>. <pourquoi c'est faux / ce qui casse>.
```go
// avant → aprèsÀ corriger
...
Suggestions
...
Ce qui est bien fait
- <2 ou 3 points précis, pas de flatterie générique>
Trier par gravité : bloquant (bug, race, fuite) → correction (idiome, contrat) →
suggestion (style, lisibilité). Si rien n'est bloquant, le dire clairement.
Rester concret : pas plus de dix points, les plus importants d'abord. Une revue de
trente remarques n'est pas lue.
## 4. Appliquer
Ne modifier le code que si l'utilisateur le demande. Sinon, fournir les diffs et le
laisser choisir. Ne jamais toucher aux fichiers `*_test.go` d'un exercice.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.

