Communitygithub.com

0xHanniba1/automatisation-qa-python

Compétence Codex pour l'automatisation des tests Python avec pytest (API) et Playwright (UI)

Qu'est-ce que automatisation-qa-python ?

Cette compétence d'assistant IA spécialisée dans l'automatisation de l'assurance qualité (QA) permet de générer, maintenir et exécuter des tests automatisés pour des projets Python. Elle prend en charge à la fois les tests d'API avec pytest et les tests d'interface utilisateur avec Playwright, en proposant des routes claires pour la conception de tests, la création de nouveaux projets, la modification de projets existants, l'intégration en livraison continue (CI) et l'analyse de défaillances. Le système impose des contrôles de qualité stricts avec des portes 'Clarifié', 'Prêt' et 'Vérifié' pour garantir que chaque intervention est correctement cadrée, exécutée et validée. Des scripts Python auxiliaires sont fournis pour inspecter les projets, générer des squelettes de test et valider les fichiers produits, ce qui en fait un outil complet pour tout développeur ou ingénieur QA cherchant à automatiser ses processus de test de manière rigoureuse et efficace.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add 0xHanniba1/python-qa-automation

Demander à votre IA préférée

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

Documentation

Automatisation QA Python

Contrat de résultat

  • Traiter cette compétence comme la boucle interne de QA après que l'attente métier est claire.
  • Réaliser un seul livrable immédiat par invocation. Ne pas passer automatiquement de la conception à l'implémentation, à l'intégration ou à la réparation d'échec.
  • Garder l'API et l'UI comme des modes séparés. En mode UI, utiliser les appels API uniquement pour la configuration, le nettoyage ou les vérifications post-conditions liées au scénario UI.
  • Passer les portes Clarifié, Prêt et Vérifié avec preuves ; invoquer la compétence n'est pas une preuve d'achèvement.

Pré-vol

  1. Lire references/common-rules.md.
  2. Résoudre <skill-dir> vers le répertoire contenant ce SKILL.md ; exécuter les scripts fournis depuis ce répertoire, pas depuis le projet cible.
  3. Identifier la racine du projet cible et lire ses instructions, ses manifestes, les tests pertinents et git status avant de modifier.
  4. Identifier le matériel source, le résultat attendu, les limites de l'environnement, la propriété des données et la méthode de vérification ; exiger une commande pour les routes produisant du code.
  5. Si un résultat attendu ne peut pas être trouvé ou confirmé, s'arrêter à la conception des tests et marquer le scénario comme exploratoire/manuel plutôt que d'inventer une assertion.

Choisir une route

Choisir exactement une route de livraison en fonction du résultat demandé immédiatement par l'utilisateur. Traiter le matériel source et le mode API/UI comme des entrées de la route, pas comme des routes supplémentaires.

RouteUtiliser lorsque le livrable immédiat estRéférence requiseFait quand
test-designUne matrice de couverture ou une recommandation d'automatisation, sans codereferences/test-design.mdLes résultats attendus, la couche, la priorité, les données et la décision d'automatisation sont explicites
new-projectUn squelette pytest minimal exécutable dans une cible nouvelle/videGuide du mode sélectionnéLe squelette valide et un test de fumée significatif se collecte ou s'exécute
existing-projectLe plus petit changement de test compatible dans un dépôt existantreferences/existing-project.md plus guide du mode sélectionnéLes conventions du projet sont préservées et la vérification affectée passe
delivery-integrationCI, Jenkins, rapports, portes de release ou test de fumée de performancereferences/delivery-integrations.mdL'intégration demandée est ajoutée et les parties vérifiables localement sont validées
failure-analysisClassification ou réparation fondée sur des preuves d'un test échouéreferences/failure-analysis.mdLa cause racine est étayée, ou la prochaine sonde manquante est nommée

Ne pas combiner les routes simplement parce qu'une tâche contient une exigence, un dépôt existant et un flux UI. Par exemple, ajouter une couverture de checkout à un projet Playwright existant est existing-project en mode ui ; charger test-design.md comme guide de support lorsque les points de test ne sont pas déjà approuvés.

Sélectionner un mode si nécessaire

  • Pour test-design, laisser la matrice sélectionner la couche fiable la plus basse ; ne pas forcer l'API ou UI avant cette décision.
  • Sélectionner api pour le comportement des endpoints, les contrats, l'auth, la validation, l'état et les intégrations. Lire references/api-mode.md.
  • Sélectionner ui pour le comportement du navigateur, la validation client, l'interaction dépendante de la mise en page et les parcours utilisateur critiques. Lire references/ui-mode.md.
  • Ne pas exiger de mode pour le travail de livraison uniquement ou l'analyse de défaillance lorsque le projet existant et les preuves déterminent déjà la pile.
  • Si le livrable demandé créerait des suites API et UI parallèles, demander à l'utilisateur d'en choisir une. Les appels API de configuration/nettoyage UI ne comptent pas comme une suite API parallèle.

Charger les références conditionnelles

  • Lire references/test-design.md pour les exigences, les user stories, les tickets de bugs, le périmètre de release, les captures d'écran ou tout changement dont les points de test ne sont pas approuvés.
  • Lire references/test-data.md pour la connexion, la création/mise à jour/suppression, les uploads, les données d'amorçage, la configuration/nettoyage ou les vérifications d'état côté serveur.
  • Lire references/flaky-diagnosis.md pour les échecs intermittents, le timing, les attentes, les tentatives, le polling, l'UI dynamique ou les interférences parallèles.
  • Lire references/api-contracts.md pour les schémas, les contrats, la compatibilité, les permissions, les rôles, les locataires, la propriété ou la couverture des codes d'erreur.
  • Lire references/advanced-ui.md pour Appium/mobile, la régression visuelle, les multiples onglets/fenêtres, les téléchargements, les uploads, les dialogues, les iframes ou les états complexes du navigateur.

Portes et actifs du projet

Passer ces portes dans l'ordre :

  • Clarifié : la source, le propriétaire ou l'autorité, le résultat attendu, le périmètre et le hors-périmètre sont explicites.
  • Prêt : la route, le mode si nécessaire, les fichiers cibles pour le travail produisant du code, la frontière des données/nettoyage, la sécurité de l'environnement et la méthode de vérification sont explicites.
  • Vérifié : les routes produisant du code ont exécuté la commande cible et la régression pertinente ; les routes de conception uniquement tracent chaque résultat attendu vers une source approuvée. Indiquer toute partie non vérifiée et la raison.

Si le projet cible a TEST_PLAN.md ou si ses instructions en exigent un, le lire avant de sélectionner la couverture, définir le scénario actif sur En cours avant l'implémentation, et le marquer Automatisé seulement après vérification. Ne pas introduire TEST_PLAN.md dans des projets qui ne l'utilisent pas sauf si l'utilisateur ou les règles du projet l'exigent.

Exécuter la route sélectionnée

  1. Pour existing-project, inspecter le dépôt et lire les fichiers rapportés avant de modifier.
  2. Indiquer la route, le mode, le livrable immédiat, les fichiers cibles et le hors-périmètre explicite.
  3. Produire ou confirmer les points de test avant le code lorsque le comportement attendu n'est pas déjà approuvé.
  4. Faire le plus petit changement qui complète la route sélectionnée ; préserver la structure existante du projet et éviter le travail de backlog adjacent.
  5. Exécuter d'abord la vérification cible étroite, puis la commande de régression pertinente.
  6. Mettre à jour le statut du plan de test du projet seulement après que la porte correspondante est passée.
  7. S'arrêter à la condition d'achèvement de la route sélectionnée et retourner le transfert. Ne pas invoquer une autre compétence ou route automatiquement.

Pour test-design, ne pas modifier le code d'automatisation. Pour failure-analysis, ne pas modifier lorsque le résultat demandé est uniquement un diagnostic ; réparer seulement lorsque l'utilisateur a demandé une correction et que les preuves soutiennent la cause racine.

Outils fournis

Remplacer <skill-dir> par le chemin absolu de cette compétence.

Inspecter un projet existant :

python "<skill-dir>/scripts/inspect_project.py" "<project-dir>"

Générer un squelette uniquement dans une cible nouvelle ou vide :

python "<skill-dir>/scripts/scaffold.py" --mode api --out "<output-dir>" --project-name "<name>"
python "<skill-dir>/scripts/scaffold.py" --mode ui --out "<output-dir>" --project-name "<name>"

Le squelette refuse d'écraser les fichiers existants. Ne pas passer --force sauf si l'utilisateur demande explicitement de remplacer les fichiers générés.

Valider les fichiers Python/TOML générés ou modifiés :

python "<skill-dir>/scripts/validate_generated.py" "<project-dir>"
python "<skill-dir>/scripts/validate_generated.py" "<project-dir>" --collect

Utiliser la propre commande de test du projet cible comme vérification principale pour les projets existants. Considérer le statut partial du validateur comme non vérifié ; installer les dépendances dans l'environnement du projet cible avant de revendiquer que la collecte est réussie. Pour l'exécution UI, s'assurer que le navigateur Playwright requis est installé.

Transfert

Rapporter :

  • la route et le mode sélectionnés ;
  • la source d'exigence et le résultat attendu utilisés comme oracle ;
  • les fichiers modifiés, plus le statut de TEST_PLAN.md le cas échéant ;
  • les commandes de vérification et le résultat exact : succès, échec, partiel ou ignoré ;
  • le travail non vérifié, le risque restant et la prochaine décision si une autre route est nécessaire.

Hors-périmètre

  • Ne pas construire de frameworks hybrides API+UI par défaut.
  • En mode UI, ne pas ajouter de couverture large d'endpoints API ; les appels API sont uniquement pour la configuration, le nettoyage ou les vérifications post-conditions liées au scénario UI.
  • Ne pas ajouter de CI, Jenkins, Allure, Appium, automatisation de bureau, régression visuelle ou tests de performance par défaut ; les ajouter uniquement lorsqu'ils sont explicitement demandés et cadrés.
  • Ne pas créer de .env, stocker des identifiants, appeler des systèmes de production ou inventer de vrais jetons.
  • Ne pas ajouter de dépendance LLM API dans le projet de test généré. L'agent hôte effectue le raisonnement et la réparation.

Skills associés