/qa — Workflow d'Assurance Qualité
Exécutez cette compétence pour effectuer une QA approfondie sur les modifications récentes ou un fichier spécifique.
Fichiers Modifiés Récemment
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "aucune modification récente détectée"
Phase 1 : Reconnaissance
- Détecter le framework de test en vérifiant :
Gemfileavec rspec/minitest → RSpec ou Minitestmix.exs→ ExUnitpackage.jsonavec jest/vitest → Jest ou Vitestplaywright.config→ Playwright
- Identifier les fichiers modifiés — si
$ARGUMENTSest un chemin de fichier, utilisez-le ; sinon exécutezgit diff --name-only HEAD~1 - Classer chaque fichier par niveau de risque :
- CRITIQUE : auth, paiements, modèles de données, utilitaires partagés, endpoints API
- ÉLEVÉ : logique métier, services, contrôleurs
- MOYEN : vues, sérialiseurs, helpers, configuration
- FAIBLE : docs, commentaires, formatage
- Lire chaque fichier modifié et ses tests existants (le cas échéant). Si plus de ~5 fichiers ont été modifiés, déléguez cette lecture à l'agent
codebase-exploreret travaillez à partir de son résumé — conservez le contexte principal pour les questions et les tests. - Construire un tableau de contexte :
| Fichier | Type | Risque | Tests existants ? |
|---|---|---|---|
| ... | ... | ... | ... |
Phase 2 : Interrogation
Avant d'écrire des tests, posez 3 à 8 questions de sondage en utilisant AskUserQuestion. Regroupez les questions — ne les posez pas une par une.
Bonnes questions (axées sur les risques) :
- "Ceci touche au flux de paiement — dois-je tester les cas extrêmes de remboursement ?"
- "La nouvelle validation rejette les entrées vides. Qu'en est-il des chaînes unicode uniquement ?"
- "Ce service appelle une API externe — dois-je la simuler ou tester l'intégration ?"
Mauvaises questions (ne les posez pas) :
- "Que fait ce code ?" (lisez-le vous-même)
- "Dois-je écrire des tests ?" (oui, toujours)
- "Quel framework de test dois-je utiliser ?" (détectez-le)
Phase 3 : Plan de Test
Présentez un plan de test structuré AVANT d'écrire des spécifications. Organisez par catégorie :
Catégories de Test
- Chemin Heureux — les entrées attendues produisent les sorties attendues
- Cas Limites — valeurs aux limites, entrées vides, valeurs maximales, nul/vide
- Cas d'Erreur — entrée invalide, échecs réseau, dépassements de délai, permission refusée
- Bizarres/Contradictoires — chaînes d'injection SQL, balises de script, emoji, chaînes de 10 Mo, accès concurrent
- Performance — requêtes N+1, collections non bornées, requêtes lentes (uniquement pour les risques CRITIQUE/ÉLEVÉ)
- Intégration — interactions entre composants (uniquement lorsque plusieurs fichiers sont modifiés)
Présentez sous forme de tableau :
| # | Catégorie | Description du Test | Niveau de Risque |
|---|---|---|---|
| 1 | Chemin Heureux | Crée un enregistrement avec des paramètres valides | ÉLEVÉ |
| ... | ... | ... | ... |
Attendez l'approbation de l'utilisateur avant de continuer.
Phase 4 : Rédaction des Spécifications
Rédigez les spécifications en suivant ces modèles :
- Une assertion par test (lorsque c'est pratique)
- Noms descriptifs —
it "retourne 404 lorsque l'enregistrement n'est pas trouvé"pasit "fonctionne" - Structure Arrange-Act-Assert
- Pas d'invités mystères — toutes les données de test visibles dans le test
- Testez le comportement, pas l'implémentation — ne testez pas les méthodes privées directement
- Utilisez des fabriques/fixtures appropriées au framework
- Regroupez par comportement avec les blocs
describe/context
Qualité du Code de Test
Les tests sont aussi du code — appliquez les mêmes principes :
- KISS : Pas de helpers de test sur-ingéniérés. Si la configuration fait >10 lignes, simplifiez le test ou le code testé.
- YAGNI : Ne testez pas des scénarios qui ne peuvent pas arriver. N'ajoutez pas de tests "au cas où" pour des états impossibles.
- DRY (avec retenue) : Préférez une duplication claire à des exemples partagés astucieux. Un test doit être lisible du début à la fin sans sauter vers 3 fichiers helpers.
- Code Propre : Des noms de tests descriptifs qui se lisent comme une documentation. Pas d'invités mystères — toutes les données visibles dans le test.
Voir @reference.md pour les notes de test spécifiques au framework (RSpec, Minitest, ExUnit, Jest/Vitest).
Phase 5 : Exécution et Vérification
- Exécutez les nouvelles spécifications — exécution ciblée (juste le nouveau fichier)
- Corrigez les échecs — lisez l'erreur, lisez la source, corrigez la cause racine
- Exécutez la suite complète — assurez-vous que rien d'autre n'est cassé
- Produisez le rapport de QA — Voir @reference.md pour le modèle de rapport, la vérification des valeurs fondamentales et la vérification de rationalisation.
Verdict : LIVRER / CORRIGER ET RE-TESTER / NÉCESSITE UNE REFONTE