Que fait Auto-évaluation avant validation ?
Avant de valider des modifications importantes, parcourez cette checklist. Attrapez les problèmes avant que l'intégration continue ne les attrape — ou pire, avant que les utilisateurs ne les attrapent.
Quand l'utiliser
Exécutez cette compétence lorsque l'une de ces conditions est vraie :
- Plus de 100 lignes modifiées
- Plus de 5 fichiers modifiés
- Infrastructures critiques touchées (exécuteur, stockage, boucles de répartition principales)
- Nouveaux concepts ou APIs publiques introduits
- Incertitude sur des cas limites ou des choix de conception
Porte d'entrée rapide :
git diff --stat HEAD | tail -5 # Combien de changements ?
git diff --name-only HEAD | wc -l # Combien de fichiers ?
Sauter si
- Modification triviale (≤ 50 lignes, ≤ 3 fichiers)
- Mises à jour de documentation ou de cours uniquement
- Modifications de tests uniquement (les tests ont leur propre révision)
- Correction de bogue simple d'une seule ligne avec une portée évidente et limitée
- Refactorisation mécanique sans changement de logique
La checklist
1. Cas limites
- [ ] Entrées nulles/vides gérées ?
- [ ] Conditions limites testées (décalage d'un, listes vides, zéro) ?
- [ ] Accès concurrentiels ou conditions de concurrence considérés ?
- [ ] Problèmes d'Unicode/encodage si traitement de texte ?
2. Chemins d'erreur
- [ ] Toutes les exceptions attrapées au bon niveau (pas trop larges) ?
- [ ] Messages d'erreur informatifs (qu'est-ce qui a échoué, pourquoi, que faire) ?
- [ ] Modes de défaillance échouent élégamment, pas silencieusement ?
- [ ] Pas de `except:` nu ou d'erreurs avalées ?
3. Couverture de tests
- [ ] Chemins critiques couverts par des tests ?
- [ ] Cas limites identifiés ci-dessus couverts par des tests ?
- [ ] Les tests s'exécutent réellement et passent ?
- [ ] Pas de squelettes de tests laissés avec `pass` ou `...` ?
4. Documentation
- [ ] Docstrings/commentaires correspondent au comportement actuel ?
- [ ] README mis à jour si l'interface publique a changé ?
- [ ] Message de validation capture ce qui a changé et pourquoi ?
- [ ] Documentation d'architecture pertinente toujours exacte ?
5. Qualité du code
- [ ] Nommage clair et cohérent avec le code environnant ?
- [ ] Pas d'odeurs de code évidentes (fonctions god, nombres magiques, chemins codés en dur) ?
- [ ] Suit les motifs existants dans le fichier/package ?
- [ ] Analyse statique / vérification de type passe ?
Test unitaire rapide
# Exécuter avant la validation (adapte à votre pile) :
make format && make typecheck && pytest -x -q && echo "✅ Prêt à valider"
Si une étape échoue, corrigez-la avant de valider. Ne livrez pas en échec.
Anti-patrons
| Anti-patron | Correction |
|---|---|
| "L'IC attrapera ça" | L'IC est un dernier recours, pas un substitut à votre propre jugement. Attrapez-le d'abord. |
| "J'ajouterai les tests plus tard" | Plus tard n'arrive pas. Écrivez le test maintenant ou acceptez la lacune définitivement. |
| "Ça a fonctionné quand je l'ai testé manuellement" | Les tests manuels ne sont pas reproductibles. Écrivez un test automatisé pour que les futures sessions puissent aussi le vérifier. |
| "Le message d'erreur est un TODO" | Les messages d'erreur TODO sont livrés en tant que messages d'erreur TODO. Écrivez le vrai message maintenant. |
| "Je peux voir à partir du code que ça gère ce cas" | Si ce n'est pas testé, une future refactorisation le cassera invisiblement. |
Pourquoi c'est important
Les agents autonomes sont entraînés à produire des résultats assez bons pour éviter les corrections. Sans une porte d'auto-révision structurée, les validations de code autonomes contournent la vérification humaine qui normalement détecte les régressions et les cas limites. Cette compétence agit comme cette porte — cinq lentilles ciblées exécutées en séquence pour que rien d'évident ne passe entre les mailles.
Les bénéfices s'accumulent : chaque passage de révision qui attrape un vrai problème est un aller-retour d'IC économisé, un bogue utilisateur évité et une PR d'annulation non nécessaire.
Liens connexes
- Compétence Auto-Validation — vérification qualité/paresse complémentaire à cette révision structurelle
- Compétence Révision Multi-Lentilles — révision parallèle approfondie pour les changements à fort enjeu