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êtetVérifiéavec preuves ; invoquer la compétence n'est pas une preuve d'achèvement.
Pré-vol
- Lire
references/common-rules.md. - Résoudre
<skill-dir>vers le répertoire contenant ceSKILL.md; exécuter les scripts fournis depuis ce répertoire, pas depuis le projet cible. - Identifier la racine du projet cible et lire ses instructions, ses manifestes, les tests pertinents et
git statusavant de modifier. - 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.
- 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.
| Route | Utiliser lorsque le livrable immédiat est | Référence requise | Fait quand |
|---|---|---|---|
test-design | Une matrice de couverture ou une recommandation d'automatisation, sans code | references/test-design.md | Les résultats attendus, la couche, la priorité, les données et la décision d'automatisation sont explicites |
new-project | Un squelette pytest minimal exécutable dans une cible nouvelle/vide | Guide du mode sélectionné | Le squelette valide et un test de fumée significatif se collecte ou s'exécute |
existing-project | Le plus petit changement de test compatible dans un dépôt existant | references/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-integration | CI, Jenkins, rapports, portes de release ou test de fumée de performance | references/delivery-integrations.md | L'intégration demandée est ajoutée et les parties vérifiables localement sont validées |
failure-analysis | Classification ou réparation fondée sur des preuves d'un test échoué | references/failure-analysis.md | La 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
apipour le comportement des endpoints, les contrats, l'auth, la validation, l'état et les intégrations. Lirereferences/api-mode.md. - Sélectionner
uipour le comportement du navigateur, la validation client, l'interaction dépendante de la mise en page et les parcours utilisateur critiques. Lirereferences/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.mdpour 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.mdpour 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.mdpour les échecs intermittents, le timing, les attentes, les tentatives, le polling, l'UI dynamique ou les interférences parallèles. - Lire
references/api-contracts.mdpour 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.mdpour 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
- Pour
existing-project, inspecter le dépôt et lire les fichiers rapportés avant de modifier. - Indiquer la route, le mode, le livrable immédiat, les fichiers cibles et le hors-périmètre explicite.
- Produire ou confirmer les points de test avant le code lorsque le comportement attendu n'est pas déjà approuvé.
- 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.
- Exécuter d'abord la vérification cible étroite, puis la commande de régression pertinente.
- Mettre à jour le statut du plan de test du projet seulement après que la porte correspondante est passée.
- 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.mdle 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.