CommunityRédaction et éditiongithub.com

AnjanJ/shipkit

Livrez un meilleur code avec Claude. Compétences, agents, règles et bases de connaissances pour Claude Code. Miroir de codeberg.org/AnjanJ/shipkit

Qu'est-ce que shipkit ?

Ce skill, intitulé `/qa — Quality Assurance Workflow`, est conçu pour être utilisé avec Claude Code. Il automatise un processus d'assurance qualité (QA) complet sur les modifications récentes ou un fichier spécifique. Il se déroule en cinq phases : reconnaissance de la base de code (détection du framework de test, classification des fichiers par risque), interrogation proactive de l'utilisateur avec des questions ciblées, présentation d'un plan de test structuré avec plusieurs catégories (Happy Path, Edge Cases, Error Cases, etc.), rédaction automatisée des tests en suivant les bonnes pratiques (One assertion per test, Arrange-Act-Assert, noms descriptifs), puis exécution et vérification avec production d'un rapport final. Le skill est particulièrement utile pour garantir la qualité du code avant un déploiement, en s'adaptant automatiquement à différents frameworks (RSpec, Minitest, ExUnit, Jest/Vitest) et en encourageant une approche collaborative via les questions à l'utilisateur. Il nécessite Claude Code (en mode inline pour les phases 2 et 3) et peut déléguer la phase de reconnaissance à l'agent `codebase-explorer` pour les gros volumes de modifications.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/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

  1. Détecter le framework de test en vérifiant :
    • Gemfile avec rspec/minitest → RSpec ou Minitest
    • mix.exs → ExUnit
    • package.json avec jest/vitest → Jest ou Vitest
    • playwright.config → Playwright
  2. Identifier les fichiers modifiés — si $ARGUMENTS est un chemin de fichier, utilisez-le ; sinon exécutez git diff --name-only HEAD~1
  3. 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
  4. 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-explorer et travaillez à partir de son résumé — conservez le contexte principal pour les questions et les tests.
  5. Construire un tableau de contexte :
FichierTypeRisqueTests 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

  1. Chemin Heureux — les entrées attendues produisent les sorties attendues
  2. Cas Limites — valeurs aux limites, entrées vides, valeurs maximales, nul/vide
  3. Cas d'Erreur — entrée invalide, échecs réseau, dépassements de délai, permission refusée
  4. Bizarres/Contradictoires — chaînes d'injection SQL, balises de script, emoji, chaînes de 10 Mo, accès concurrent
  5. Performance — requêtes N+1, collections non bornées, requêtes lentes (uniquement pour les risques CRITIQUE/ÉLEVÉ)
  6. Intégration — interactions entre composants (uniquement lorsque plusieurs fichiers sont modifiés)

Présentez sous forme de tableau :

#CatégorieDescription du TestNiveau de Risque
1Chemin HeureuxCré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é" pas it "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

  1. Exécutez les nouvelles spécifications — exécution ciblée (juste le nouveau fichier)
  2. Corrigez les échecs — lisez l'erreur, lisez la source, corrigez la cause racine
  3. Exécutez la suite complète — assurez-vous que rien d'autre n'est cassé
  4. 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

Skills associés