Test de non-impact (patch-regression-test)
1. Présentation et prérequis
1.1 Objectif
Vérifier que les fonctionnalités existantes de l'application sont maintenues après l'application d'un patch ou d'une correction (confirmation de non-impact). Pour ce faire, identifier et implémenter les tests manquants dans l'application cible, comparer les résultats avant/après le patch, résumer le tout dans un rapport et le publier sur l'Issue.
Ce skill est utilisé dans les trois situations suivantes décrites dans les directives :
- Urgence. Effectuer la vérification de non-impact d'un patch CVE demandé par un autre processus, dans les délais impartis.
- Préparation permanente en temps normal. Diagnostiquer le niveau de préparation de l'application et combler les tests manquants à l'avance (identique pour la première fois et les suivantes).
- Contrôle planifié. Après la première préparation permanente en temps normal, effectuer la vérification de non-impact pour les corrections faites par des outils externes ou des personnes (mise à jour de dépendances, correction de vulnérabilité, correction de code source).
1.2 Directives et normes techniques
- Avant de commencer le travail, lire impérativement les deux documents suivants :
references/guideline.md(ci-après « directives ») : ce qui doit être satisfait (classification, conditions de réussite/échec, rôles, règles de décision)references/standards.md(ci-après « normes techniques ») : comment le satisfaire (outils, méthodes de vérification, mesures, noms de fichiers)
- Les critères de décision suivent les directives, la méthode suit les normes techniques. En cas de divergence entre ce skill, les normes techniques et les directives, les directives prévalent.
- Les termes (périmètre de vérification, préparation permanente en temps normal, contrôle planifié, test fonctionnel, site d'appel, test instable, approbation provisoire, etc.) suivent les définitions de la section « 1.5 : Terminologie » des directives.
- Dans le référentiel de déploiement, placer ce skill dans
.github/skills/patch-regression-test/(emplacement lu à la fois par GitHub Copilot et Devin).
1.3 Ce que fait ce skill
- Analyse de l'application cible (langage, type d'application, tests et CI actuels, sites d'appel)
- Diagnostic du niveau de préparation (section « 3.1.1 : Niveau de préparation » des directives)
- Création d'une proposition de détermination du périmètre de vérification (section « Chapitre 2 : Classification des patches et critères de vérification » des directives)
- Identification des tests manquants
- Implémentation du code de test. L'introduction de bibliothèques pour exécuter les tests se fait avec l'autorisation de l'utilisateur
- Exécution des tests et comparaison des résultats avant/après le patch (expliquer le contenu des commandes avant de les exécuter)
- Génération du rapport de test de non-impact et publication d'un commentaire sur l'Issue (s'il y a une PR, commenter également le lien vers l'Issue sur la PR)
- Création d'une Issue si aucune Issue déclencheur n'existe (avec autorisation)
- Enregistrement de l'approbation du responsable (vérifier l'approbation de la PR et la consigner comme commentaire sur l'Issue)
1.4 Ce que ce skill ne fait pas
Les actions suivantes ne sont pas effectuées, même si l'utilisateur le demande ou avec autorisation. Orienter vers la personne responsable.
| Action non effectuée | Personne responsable |
|---|---|
| Application du patch, modification du code source de l'application (y compris la mise à jour de version des dépendances, la gestion des modifications cassantes, la correction de vulnérabilité, la réponse aux alertes d'analyse statique du code, les modifications pour écrire des tests) | Autres outils comme Dependabot, Devin, ou une personne |
| Configuration de l'environnement pour exécuter l'application (environnement d'exécution, installation ou modification de configuration des intergiciels). À l'exception de l'introduction de bibliothèques pour exécuter les tests | Personne ou CI de chaque équipe |
| Modification ou ajout de workflow | Chaque équipe (selon des directives distinctes) |
| Commit, push | L'outil qui a appelé le skill, ou une personne |
| Collecte d'informations sur les vulnérabilités, décision de la nécessité d'une réponse urgente, exécution d'une analyse statique du code | Autre processus |
| Déploiement | CD existant de chaque équipe |
| Détermination finale du périmètre de vérification, approbation des différences attendues, approbation de la PR | Responsable de l'équipe de développement |
| Décision de publication en cas d'échec de performance, décision de dépassement de délai | Cadre supérieur ou plus |
| Décision d'arrêt ou de blocage du système | Processus décisionnel défini séparément |
1.5 Livrables
| Livrable | Emplacement |
|---|---|
| Code de test | Se conformer à l'emplacement des tests existants de l'application cible |
| Liste des sites d'appel | patch-regression-reports/call-sites.md de l'application cible |
| Liste des tests instables | patch-regression-reports/flaky-tests.md de l'application cible |
| Fichier de configuration pour exécution sans interaction | patch-regression-reports/auto-settings.md de l'application cible |
| Rapport de test de non-impact | Dans patch-regression-reports/ sous le répertoire contenant les ressources de test de l'application cible (le nom suit les normes techniques) |
| Commentaire du rapport | Issue déclencheur. S'il y a plusieurs Issues concernées, toutes (section « 9.4 : Publication de commentaires sur les Issues et PR ») |
| Commentaire avec lien vers le rapport | PR concernée (si elle existe) |
| Commentaire d'enregistrement de l'approbation | Issue déclencheur (section « Chapitre 10 : Enregistrement de l'approbation ») |
Le skill va jusqu'à enregistrer les fichiers dans le référentiel ; le commit est confié à l'outil ou à la personne qui a appelé le skill.
1.6 Flux de travail
flowchart TD
S2[2. Démarrage et situation] --> J0{Situation}
J0 -- Enregistrement de l'approbation --> S10[10. Enregistrement de l'approbation]
J0 -- Urgence, préparation permanente, contrôle planifié --> S3[3. Vérification des informations d'entrée]
S3 --> S4[4. Analyse de l'application cible]
S4 --> J{Situation}
J -- Urgence, contrôle planifié --> S5[5. Proposition de détermination du périmètre de vérification]
J -- Préparation permanente --> S6[6. Identification des tests manquants]
S5 --> S6
S6 --> S7[7. Implémentation des tests]
S7 --> S8[8. Exécution des tests et comparaison]
S8 --> S9[9. Génération du rapport et publication sur l'Issue]
1.7 Points nécessitant une confirmation de l'utilisateur
Aux points suivants, présenter une proposition et sa justification, demander une confirmation à l'utilisateur et ne pas avancer avant d'avoir reçu une réponse. En cas d'exécution sans interaction (--auto), suivre la section « 2.3 : Exécution sans interaction (contrôle planifié uniquement) ».
Lors de la demande de confirmation, demander également le nom et le rôle de la personne qui décide (par exemple, responsable de l'équipe de développement).
- Confirmation de la situation et de la cible (numéro CVE, PR), niveau de préparation cible pour la préparation permanente (section « Chapitre 2 : Démarrage et situation »)
- Enregistrement/mise à jour du fichier de configuration (section « 2.3 : Exécution sans interaction (contrôle planifié uniquement) »)
- Gestion des contradictions d'informations, des informations d'entrée manquantes (section « 3.3 : Vérification de l'état », section « 3.4 : Gestion des informations manquantes »)
- Type d'application (section « 4.2 : Type d'application »)
- Proposition de détermination du périmètre de vérification, éléments à traiter dans le périmètre 3, liste des modifications cassantes, points de correction à tester (section « Chapitre 5 : Proposition de détermination du périmètre de vérification »)
- Niveaux de test à exclure, inclure V9 : Traitement parallèle et ressources (section « 6.2 : Éléments à confirmer avec l'utilisateur »)
- Périmètre d'implémentation (section « 6.4 : Sélection du périmètre d'implémentation »)
- Ajout de bibliothèques pour exécuter les tests, choix d'outil en l'absence de mécanisme de test (section « 7.1 : Principes d'implémentation »)
- Ajout à la liste des tests instables (section « 7.2 : Implémentation par type de test », section « 8.4 : Diagnostic des échecs »)
- Installation des bibliothèques pour exécuter les tests, scan de vulnérabilité utilisant le réseau, analyse statique du code, exécution locale des tests longs (section « Chapitre 8 : Exécution des tests et comparaison »)
- Caractère attendu des différences trouvées lors de l'exécution des tests, mise à jour des valeurs attendues (section « 8.5 : Gestion des différences »)
- Création d'Issue, publication de commentaires sur les Issues et PR (section « 9.4 : Publication de commentaires sur les Issues et PR »)
2. Démarrage et situation
2.1 Méthode de démarrage
Recevoir la situation comme argument au démarrage.
| Situation | Exemple d'argument |
|---|---|
| Urgence | urgent CVE-2026-12345 (pour traiter plusieurs CVE ensemble, urgent CVE-2026-12345 CVE-2026-23456) |
| Préparation permanente | readiness |
| Contrôle planifié | planned 123 (123 est le numéro de la PR de correction. Peut être omis) |
| Contrôle planifié sans interaction | planned 123 --auto |
| Enregistrement de l'approbation | approve 123 (123 est le numéro de la PR) |
- PR cible. Dans les situations d'urgence, de contrôle planifié et d'enregistrement d'approbation, on suppose que la PR contenant le patch ou la correction a été créée avant le démarrage du skill (créée par Dependabot, Devin ou une personne).
- Issue cible (destination de publication). Identifier l'Issue sur laquelle publier le rapport comme suit, selon la situation. S'il y a plusieurs Issues concernées, toutes sont ciblées.
- Urgence : Issue dont le titre contient le numéro CVE cible (directives section « 7.1 : Emplacement des informations sur les vulnérabilités et le contenu des patches »)
- Contrôle planifié : Issue liée à la PR. Sinon, chercher avec les règles de titre (« vérification périodique des écarts », « analyse statique du code »). Si introuvable, créer
- Préparation permanente : Il n'y a pas d'Issue, donc en créer une
- Enregistrement de l'approbation : Issue liée à la PR
- S'il n'y a pas d'argument, demander à l'utilisateur de quelle situation il s'agit.
- Même s'il y a un argument, montrer à l'utilisateur la situation reçue et la cible (numéro CVE, PR, Issue de destination), obtenir confirmation, puis avancer. En cas de
--auto, suivre la section « 2.3 : Exécution sans interaction (contrôle planifié uniquement) ». - PR pour contrôle planifié. Si le numéro de PR est omis, identifier la PR correspondant à la branche actuelle avec
gh, la montrer à l'utilisateur et obtenir confirmation. --autone peut être utilisé que pour le contrôle planifié (planned). Si--autoest spécifié pour une autre situation, indiquer qu'il n'est pas disponible et passer en mode interactif.
2.2 Travail par situation
| Situation | Chapitres parcourus | Actions au « Chapitre 8 : Exécution des tests et comparaison » |
|---|---|---|
| Urgence | Chapitres 3 à 9 | Exécution individuelle des tests ajoutés, comparaison avant/après patch, exécution des tests communs à tous les périmètres de vérification (directives section « 2.4 : Tests communs à tous les périmètres de vérification ») |
| Préparation permanente | Chapitres 3, 4, 6 à 9 (pas le chapitre 5) | Exécution individuelle des tests ajoutés, exécution de C1 à C4 parmi les tests communs à tous les périmètres de vérification (directives section « 2.4 : Tests communs à tous les périmètres de vérification ») (pas de comparaison d'arbre de dépendances C1, ni C5, C7 car il n'y a pas de vulnérabilité cible ni de correctif à comparer) |
| Contrôle planifié | Chapitres 3 à 9 | Exécution individuelle des tests ajoutés, comparaison avant/après correction, exécution des tests communs à tous les périmètres de vérification (directives section « 2.4 : Tests communs à tous les périmètres de vérification ») |
| Enregistrement de l'approbation | Chapitre 10 uniquement | Aucune |
- Relecture de « patch ». Dans le contrôle planifié, remplacer « patch » par « correction » dans l'ensemble du skill (par exemple, « avant le patch » devient « avant la correction »).
- Objectif de la préparation permanente. Demander à l'utilisateur de choisir le niveau de préparation à atteindre (par exemple, jusqu'à L2).
- Visualisation du temps pour l'urgence. Juste après avoir confirmé l'heure de la demande de début de l'urgence (I12) au « Chapitre 3 : Vérification des informations d'entrée », afficher les délais (24 heures pour le déploiement sur la staging, 48 heures pour la mise en production, estimation de 12 heures pour l'ajout et l'exécution des tests). Ensuite, à la fin de chaque chapitre, signaler le temps écoulé à l'utilisateur et l'enregistrer dans le rapport.
- En cas de risque de dépassement de délai (urgence). Ne pas omettre les confirmations. Signaler à l'utilisateur le risque de dépassement et la nécessité d'une escalade du responsable de l'équipe de développement vers un cadre supérieur ou plus, et l'inscrire dans la section « Éléments nécessitant une escalade » du rapport.
- Pas de délai en temps normal. Pour la préparation permanente et le contrôle planifié, ne pas afficher les délais ni signaler le temps écoulé. Ne pas utiliser l'approbation provisoire non plus.
2.3 Exécution sans interaction (contrôle planifié uniquement)
Pour le contrôle planifié, les outils de développement IA peuvent exécuter ce skill sans interaction sur la PR de correction (planned <numéro PR> --auto). Le type de contrôle (mise à jour de dépendances, correction de vulnérabilité, correction de code source) n'a pas d'importance.
Les éléments qui auraient été décidés avec confirmation humaine en mode interactif sont inscrits dans la section « Éléments à confirmer trouvés lors de l'exécution sans interaction » (ci-après « à confirmer » dans cette section) du rapport. La personne responsable doit traiter ces éléments « à confirmer » du rapport publié sur l'Issue lors de la revue de la PR.
2.3.1 Fichier de configuration
- L'exécution sans interaction présuppose l'existence du fichier de configuration
patch-regression-reports/auto-settings.md. Le modèle esttemplates/auto-settings-template.md. - Si la PR modifie le fichier de configuration, annuler. Si la liste des fichiers modifiés de la PR (ex.
git diff --name-only <branche de comparaison>...HEAD) contient le fichier de configuration, annuler sans commencer le travail et terminer en indiquant qu'une exécution interactive est nécessaire. Cela empêche la PR elle-même de modifier le périmètre des autorisations. - Enregistrement. Lors de l'exécution interactive d'une préparation permanente ou d'un contrôle planifié, à la fin, compiler les réponses de l'utilisateur dans le fichier de configuration. Montrer le contenu à l'utilisateur avant l'enregistrement, obtenir confirmation, puis enregistrer. Pour les éléments non demandés sur le moment, ne pas les écrire par déduction, demander à l'utilisateur. Si le fichier de configuration existe déjà, montrer les modifications et obtenir confirmation de la mise à jour.
- Si le fichier de configuration est absent ou au format incorrect.
--autone peut pas être utilisé. Annuler sans commencer le travail, expliquer la raison et terminer. --autone met pas à jour le fichier de configuration. Si l'on remarque un point de configuration à modifier, l'inscrire dans la section « à confirmer ».
2.3.2 Gestion des points de confirmation
En cas de --auto, aux points listés dans la section « 1.7 : Points nécessitant une confirmation de l'utilisateur », agir comme suit au lieu de poser une question à l'utilisateur.
| Point de confirmation | Gestion sans interaction |
|---|---|
| Situation et PR cible | Traiter comme un contrôle planifié. Utiliser le numéro de l'argument pour la PR. Annuler s'il n'y a pas de numéro |
| Enregistrement/mise à jour du fichier de configuration | Ne pas effectuer. Inscrire les points à modifier dans la section « à confirmer » |
| Explication des commandes | Comme il n'y a personne à qui expliquer, enregistrer les commandes exécutées et leur contenu dans le rapport |
| Contradictions d'informations | Inscrire dans la section « à confirmer » et continuer sur la base du contenu du référentiel |
| Informations d'entrée manquantes | Enregistrer comme risque résiduel |
| Type d'application | Utiliser la valeur du fichier de configuration. En cas de divergence avec l'estimation à partir du code source, inscrire dans la section « à confirmer » et continuer avec la valeur du fichier de configuration |
| Proposition de détermination du périmètre de vérification, éléments à traiter dans le périmètre 3, liste des modifications cassantes, points de correction à tester | Avancer avec la proposition et la liste. Inscrire la détermination finale dans la section « à confirmer », le responsable la fera lors de la revue de la PR |
| Niveaux de test à exclure, inclure V9 : Traitement parallèle et ressources | Utiliser la valeur du fichier de configuration |
| Périmètre d'implémentation | Suivre la politique du fichier de configuration |
| Choix d'outil en l'absence de mécanisme de test | Utiliser l'outil enregistré dans le fichier de configuration |
| Ajout de bibliothèques pour exécuter les tests | Ajouter uniquement celles figurant dans la liste d'autorisation du fichier de configuration. Ne pas ajouter les autres et les inscrire dans la section « à confirmer » |
| Ajout à la liste des tests instables | Ne pas effectuer. Inscrire les candidats dans la section « à confirmer » |
| Installation de bibliothèques, scan de vulnérabilité utilisant le réseau, analyse statique du code | Suivre les autorisations du fichier de configuration. Si non autorisé, ne pas effectuer et enregistrer « à vérifier en CI » |
| Tests longs à exécuter | Suivre la politique du fichier de configuration. Si aucune politique, déléguer à la CI |
| Caractère attendu des différences, mise à jour des valeurs attendues | Ne pas juger. Ne pas mettre à jour les valeurs attendues non plus. Si des différences apparaissent, les inscrire dans la section « à confirmer » |
| Publication de commentaires sur les Issues et PR | Effectuer. Omettre la confirmation avant la publication |
| Création d'une Issue en l'absence d'Issue déclencheur | Créer. Omettre la confirmation avant la création |
3. Vérification des informations d'entrée
Conformément au tableau (I1 à I14) de la section « Chapitre 7 : Informations à collecter avant de commencer » des directives, rassembler les informations nécessaires au travail.
3.1 Éléments à vérifier
| Situation | Éléments à vérifier |
|---|---|
| Urgence | Tous les I1 à I13. Si cela inclut une correction de code source, inclure la différence de la PR de correction dans I5 |
| Préparation permanente | I7, I8, I8a, I9, I10, I13 |
| Contrôle planifié | Selon le type de contrôle, conformément au tableau « Informations utilisées pour le contrôle planifié » de la section « Chapitre 7 : Informations à collecter avant de commencer » des directives (mise à jour de dépendances : I3 à I11, I13, correction de vulnérabilité : I1 à I11, I13, correction de code source : I5 à I11, I13, I14). Inclure également l'Issue déclencheur et le moment de l'application de la correction |
I11 (environnement de staging) est obligatoire pour les périmètres de vérification 2 et 3. I12 (heure de la demande de début et délai) n'est utilisé que pour l'urgence.
3.2 Méthode de collecte des informations
- Informations collectées par soi-même dans le référentiel. Les informations suivantes sont collectées en lisant le référentiel de l'application cible.
- I3 : Version avant/après la mise à jour (comparer les fichiers de dépendances entre la branche de comparaison source et la branche actuelle. Pour les mises à jour d'environnement d'exécution, comparer également les fichiers de la section « 3.3 : Vérification de l'état »)
- I5 : Différence de code source avant/après la mise à jour. Si cela inclut une correction de code source de l'application, la différence de la PR
- I6 : Arbre de dépendances, dépendances indirectes mises à jour conjointement
- I7 : Langage, type d'application, destinations de connexion externes
- I8, I8a : Tests actuels, workflows GitHub Actions, rapport de couverture
- Informations transmises de l'extérieur. Les informations suivantes sont collectées par d'autres processus (directives section « 7.1 : Emplacement des informations sur les vulnérabilités et le contenu des patches »). Lire avec la commande
gh. Suivre la section « 2.1 : Méthode de démarrage » pour l'identification de l'Issue.- Informations sur la vulnérabilité (I1, I2 - urgence et correction de vulnérabilité en contrôle planifié). Lire à partir de l'Issue dont le titre contient le numéro CVE.
- Résultat de l'analyse statique du code (I14 - correction de code source en contrôle planifié). Lire à partir de l'Issue dont le titre contient « analyse statique du code » et l'identifiant de l'alerte.
- Issue de vérification périodique des écarts (mise à jour de dépendances en contrôle planifié). Lire à partir de l'Issue dont le titre contient « vérification périodique des écarts » et le nom de la cible de mise à jour.
- Contenu du patch (I4, I5). Lire à partir de la description de la PR contenant le patch ou la correction (ex. PR de Dependabot).
- Moment de l'application de la correction (contrôle planifié). Lire à partir de l'Issue déclencheur (1 à 3).
- Si introuvable, ou si
ghn'est pas disponible (non authentifié, etc.), demander à l'utilisateur de le fournir par conversation.
- Informations à demander à l'utilisateur. I9 (référence de performance), I10 (niveaux de test à exclure), I11 (environnement de staging), I12 (heure de la demande de début et délai), I13 (structure) sont demandés à l'utilisateur s'ils ne sont pas trouvés dans le référentiel ou l'Issue. I13 est obligatoire car il s'agit de la destination de la demande de décision et d'approbation ; ne pas avancer avant d'avoir reçu une réponse.
3.3 Vérification de l'état
Cette section s'applique pour l'urgence et le contrôle planifié. La sauter pour la préparation permanente.
- Que le patch soit appliqué. On suppose que le skill est démarré après avoir récupéré la branche de la PR contenant le patch ou la correction. Comparer la branche de comparaison source et la branche actuelle pour vérifier que le patch est appliqué.
- Pour les mises à jour de bibliothèques, comparer les fichiers de dépendances.
- Pour les mises à jour d'environnement d'exécution, d'OS, d'intergiciels (périmètre 3), comparer également
Dockerfile, la spécification de l'environnement d'exécution dans le workflow (versions desetup-java, etc.), et les fichiers spécifiant la version de l'environnement d'exécution (.java-version,.python-version,.nvmrc,global.json, etc.). - Pour les réponses aux alertes d'analyse statique du code, vérifier que le fichier et la ligne de l'alerte (I14) sont inclus dans la différence de la PR.
- Si non appliqué, signaler à l'utilisateur et arrêter le travail.
- Code source modifié en externe. Vérifier si la différence de la PR inclut des modifications du code source de l'application. Si oui, enregistrer le fichier et l'emplacement modifié. Indépendamment de la cause, les ajouter aux cibles de test (directives section « 2.4 : Tests communs à tous les périmètres de vérification »).
- Branche de comparaison source. Vérifier la branche de comparaison source utilisée au « Chapitre 8 : Exécution des tests et comparaison » et la montrer à l'utilisateur. La branche de comparaison source est la branche de fusion de la PR. Si le workflow de directives distinctes spécifie une autre branche comme source de comparaison, s'y conformer.
- Contradictions d'informations. En cas de divergence entre les informations fournies et le contenu du référentiel (par exemple, la version après mise à jour écrite dans l'Issue ne correspond pas au fichier lock), confirmer avec l'utilisateur.
3.4 Gestion des informations manquantes
Suivre la section « Chapitre 7 : Informations à collecter avant de commencer » des directives.
| Situation | Gestion |
|---|---|
| Urgence | Lister les informations obligatoires manquantes, les montrer à l'utilisateur (responsable de l'équipe de développement) et attendre sa décision sur place. Ne pas avancer avant d'avoir reçu une réponse |
| Préparation permanente | Enregistrer les informations manquantes comme risques résiduels dans le rapport |
| Contrôle planifié | Enregistrer les informations manquantes comme risques résiduels dans le rapport et poursuivre le travail |
Enregistrer les informations manquantes et les décisions prises dans le rapport.
3.5 Enregistrement
Enregistrer les informations collectées et leur source (nom du fichier du référentiel, numéros d'Issue ou de PR, conversation, etc.) en tête du rapport de la section « Chapitre 9 : Génération du rapport et publication sur l'Issue ».
4. Analyse de l'application cible
4.1 Langage et outils de build
Déterminer le langage et les outils de build à partir des fichiers de dépendances.
| Fichier | Langage / Outils de build |
|---|---|
pom.xml, build.gradle* | Java (Maven, Gradle) |
pyproject.toml, requirements*.txt, poetry.lock | Python |
package.json, package-lock.json, tsconfig.json | TypeScript |
*.csproj, *.sln, packages.lock.json | C# |
4.2 Type d'application
Estimer le type d'application à partir du point d'entrée de démarrage (framework Web, définition de la fonction main ou du job, framework d'interface, etc.). Montrer le type estimé à l'utilisateur, présélectionné parmi les options, avec la justification, et demander confirmation. Si l'estimation est erronée, l'utilisateur peut en choisir un autre.
- Options : Backend, Traitement par lots, Frontend Web, Application de bureau (sélectionner plusieurs si combiné)
4.3 Inventaire des tests et de la CI actuels
- Tests. Examiner le framework de test utilisé, le nombre et l'emplacement par type de test (unitaire, intégration, E2E, contrat, performance), la commande pour exécuter les tests.
- CI. Lire
.github/workflows/, vérifier si les tests sont exécutés en CI et s'il existe un mécanisme pour exécuter les mêmes tests avant/après le patch et comparer les résultats (P7 de la section « 3.1.1 : Niveau de préparation » des directives). Lire le workflow uniquement, ne pas le modifier. - Tests instables. Vérifier si une liste de tests instables (
patch-regression-reports/flaky-tests.md) existe. - Destinations de connexion externes. Identifier les échanges avec l'extérieur (DB, API, fichiers, etc.). Utilisé pour déterminer les cibles des tests de contrat.
4.4 Diagnostic du niveau de préparation
Pour P1 à P11 de la section « 3.1.1 : Niveau de préparation » des directives, déterminer s'ils sont « présents », « absents » ou « exclus avec justification enregistrée », et les résumer dans un tableau avec justification. Ensuite, déterminer le niveau de préparation de l'application (L0 à L3).
La condition du niveau de préparation est « qu'il soit exécuté en CI ». Par conséquent, la simple présence de tests ou de scans dans le référentiel ne suffit pas pour « présent ». Vérifier qu'ils sont effectivement exécutés dans le workflow lu à la section « 4.3 : Inventaire des tests et de la CI actuels » avant de les considérer comme « présents ». Ceux qui sont dans le référentiel mais non exécutés en CI sont classés comme « absents (non exécutés en CI) ».
Dans le contrôle planifié, s'il existe un rapport de la préparation permanente ou du contrôle planifié précédent dans patch-regression-reports/, comparer avec le plus récent et enregistrer si le niveau de préparation a baissé. Si c'est le cas, enregistrer la nécessité de le remettre à niveau par la préparation permanente dans la section « À traiter par l'équipe » des risques résiduels et de la liste des manques.
4.5 Liste des sites d'appel
Créer une liste des endroits dans le code source de l'application où des bibliothèques externes sont appelées (P4 de la section « 3.1.1 : Niveau de préparation » des directives).
| Situation | Cible |
|---|---|
| Urgence, contrôle planifié | Bibliothèques mises à jour (inclure les dépendances indirectes mises à jour conjointement si l'application les appelle directement) |
| Préparation permanente | Toutes les bibliothèques qui sont des dépendances directes |
- Si un code source modifié en externe est trouvé à la section « 3.3 : Vérification de l'état », ajouter également l'emplacement modifié et le traitement qui l'appelle comme cibles, quelle que soit la situation.
- Pour chaque site d'appel, vérifier s'il existe un test qui le couvre. Déterminer en lisant le contenu du code de test ; utiliser le rapport de couverture comme aide s'il existe.
- Enregistrer la liste dans
patch-regression-reports/call-sites.md. Si elle existe déjà, mettre à jour le contenu pour correspondre au code source actuel.
4.6 Enregistrement
Enregistrer les résultats des sections « 4.1 : Langage et outils de build » à « 4.5 : Liste des sites d'appel » dans le rapport de la section « Chapitre 9 : Génération du rapport et publication sur l'Issue ».
5. Proposition de détermination du périmètre de vérification
Ce chapitre s'applique pour l'urgence et le contrôle planifié. La détermination finale du périmètre de vérification est effectuée par le responsable de l'équipe de développement ; ce skill ne fait qu'élaborer une proposition.
5.1 Type de contrôle (contrôle planifié uniquement)
Déterminer le type (mise à jour de dépendances, correction de vulnérabilité, correction de code source) à partir de l'Issue déclencheur et de la PR, selon la section « 3.5.1 : Cause et type du contrôle » des directives. Si une seule PR contient plusieurs types, effectuer ce qui suit pour chacun.
5.2 Procédure de détermination
- Mise à jour de dépendances, correction de vulnérabilité, et urgence. Déterminer en suivant le diagramme de la section « 2.2 : Procédure de détermination » des directives et fournir une justification pour chaque branche. Utiliser les versions avant/après (I3), les notes de version, l'historique des modifications, le guide de migration (I4), les différences de code source avant/après (I5) et l'arbre de dépendances (I6) pour la justification.
- Si les versions des dépendances indirectes changent également, les traiter comme des cibles de mise à jour et déterminer selon le périmètre de vérification le plus large (directives section « 2.3 : Points d'attention pour la détermination »).
- Vérifier les modifications de signature selon la méthode de vérification par langage des normes techniques. Expliquer le contenu des commandes avant de les exécuter. Si la construction (build) entraîne le téléchargement de bibliothèques de dépendances, obtenir l'autorisation de l'utilisateur conformément au début du « Chapitre 8 : Exécution des tests et comparaison ».
- Correction de code source (contrôle planifié). Ne pas utiliser le périmètre de vérification. Répertorier les emplacements modifiés enregistrés à la section « 3.3 : Vérification de l'état » et le traitement qui les appelle comme cibles de test. Enregistrer également si l'alerte est une vulnérabilité (utilisé pour la nécessité de C5).
5.3 En cas d'impossibilité de vérifier les changements
Pour les mises à jour couvrant plusieurs versions, s'il est impossible de vérifier les changements par version dans les notes de version ou les différences, déterminer le périmètre de vérification en fonction de l'ampleur de la montée de version, conformément à la section « 2.1.1 : En cas d'impossibilité de vérifier les changements » des directives. Mentionner la version qui n'a pas pu être vérifiée comme justification.
5.4 Éléments à traiter dans le périmètre de vérification 3
Dans le périmètre de vérification 3, déterminer lesquels des éléments du périmètre de vérification 2 de la section « 2.5 : Tests supplémentaires par périmètre de vérification » des directives sont ciblés, en fonction du contenu de la mise à jour.
- Pour les mises à jour sans modification de l'API de la bibliothèque (par exemple, mise à jour de l'image de base du conteneur), « Analyse des différences de comportement du côté de la bibliothèque » et « Liste des modifications cassantes » n'ont pas de cible. Les mentionner comme « Sans objet (raison) ».
- Pour les mises à jour impliquant des modifications de l'API de la bibliothèque (par exemple, mise à jour de la série de frameworks), cibler tous les éléments du périmètre de vérification 2.
- Si la vérification d'environnement pour le périmètre 3 (directives section « 3.3 : Automatisation CI de la vérification d'environnement pour le périmètre 3 ») n'est pas intégrée dans la CI, la traiter comme « À traiter par l'équipe » dans la liste des manques, et considérer la proposition comme « En attente de décision ». Ce skill ne doit pas créer ce workflow de vérification d'environnement.
5.5 Liste des modifications cassantes (périmètres de vérification 2 et 3)
Lire le guide de migration par version majeure et créer une liste des modifications cassantes. Même les mises à jour couvrant deux versions majeures ou plus sont traitées comme une seule PR ; pour permettre d'isoler la version responsable des différences, diviser la liste par version. Cette liste est utilisée au « Chapitre 6 : Identification des tests manquants » et pour la classification des différences à la section « 8.5 : Gestion des différences ». Si le guide de migration ne figure pas dans la description de la PR, demander à l'utilisateur de le fournir.
5.6 Vérification par rapport au niveau de préparation (urgence uniquement)
- Sur la base du périmètre de vérification déterminé et du niveau de préparation diagnostiqué à la section « 4.4 : Diagnostic du niveau de préparation », indiquer une estimation de la capacité à terminer le travail dans les délais (estimation de 12 heures pour l'ajout et l'exécution des tests, 24 heures pour le déploiement sur la staging). Si la préparation est insuffisante et que le travail ne peut probablement pas être terminé dans les délais, indiquer à l'utilisateur la nécessité d'une escalade du responsable vers un cadre supérieur ou plus, conformément aux directives section « 3.1.1 : Niveau de préparation ».
- Pour le périmètre de vérification 3, si la vérification d'environnement n'est pas intégrée dans la CI, indiquer la nécessité d'une escalade conformément aux directives section « 4.2 : Cas du périmètre de vérification 3 traité en urgence ». Ce skill ne décide pas de l'arrêt du système ni du dépassement de délai.
5.7 Détermination finale et enregistrement
Montrer à l'utilisateur (responsable de l'équipe de développement) le type de contrôle, la proposition de détermination du périmètre de vérification, les éléments à traiter dans le périmètre 3, la liste des modifications cassantes et les points de correction à tester, et ne pas avancer tant que la détermination finale n'est pas obtenue. Enregistrer le contenu déterminé, les raisons de la détermination et la personne qui a déterminé dans le rapport de la section « Chapitre 9 : Génération du rapport et publication sur l'Issue ».
6. Identification des tests manquants
6.1 Référence de comparaison
| Situation | Référence |
|---|---|
| Urgence, contrôle planifié | Tests communs à tous les périmètres de vérification (directives section « 2.4 : Tests communs à tous les périmètres de vérification ») et tests supplémentaires par périmètre de vérification déterminé (directives section « 2.5 : Tests supplémentaires par périmètre de vérification » ; pour le périmètre 3, ceux ciblés à la section « 5.4 : Éléments à traiter dans le périmètre de vérification 3 »). S'il y a du code source modifié en externe, inclure les tests de l'emplacement modifié et du traitement qui l'appelle |
| Préparation permanente | Éléments de P1 à P11 de la section « 3.1.1 : Niveau de préparation » des directives jusqu'au niveau choisi par l'utilisateur |
En cas d'inadéquation entre les références pour un cas particulier, pencher vers une vérification plus large en cas de doute et en informer l'utilisateur.
Quelle que soit la situation, utiliser V1 à V11 de la section « Chapitre 5 : Liste de contrôle des points de vérification » des directives comme perspectives pour la conception des tests. La méthode de vérification par perspective suit les normes techniques.
...
(Le contenu a été tronqué pour la traduction. Les sections manquantes doivent être traduites selon le même principe.)
10. Enregistrement de l'approbation
10.1 Vérification de l'approbation de la PR
- Vérifier que la PR cible a été approuvée. Utiliser l'API GitHub (par exemple,
gh api repos/{propriétaire}/{nom}/pulls/{numéro}/reviews) pour récupérer l'état de la revue. - L'approbation est effectuée par le responsable de l'équipe de développement, conformément aux directives section « 1.2 : Rôles ».
10.2 Enregistrement dans l'Issue
- Sur l'Issue liée à la PR (section « 2.1 : Méthode de démarrage »), publier un commentaire indiquant que la PR a été approuvée.
- Le commentaire doit inclure le numéro de la PR, la date et l'heure de l'approbation, et la personne qui a approuvé.
- S'il n'y a pas d'Issue liée, en créer une.
10.3 Gestion des cas où l'approbation n'est pas obtenue
- Si la PR n'est pas approuvée, enregistrer dans l'Issue que l'approbation est en attente.
- Ne pas fermer l'Issue ; laisser ouverte jusqu'à l'obtention de l'approbation.
- Si un délai est spécifié et que l'approbation n'est pas obtenue dans ce délai, signaler la nécessité d'une escalade dans un commentaire sur l'Issue, conformément aux directives section « 4.2 : Cas du périmètre de vérification 3 traité en urgence ».
10.4 Enregistrement supplémentaire (cas de plusieurs approbations nécessaires)
- Si l'approbation de plusieurs responsables est nécessaire (par exemple, en cas de corrections complexes), enregistrer l'état de chaque approbation dans l'Issue.
- Attendre que toutes les approbations soient obtenues avant de finaliser le rapport.
(Fin de la traduction du skill patch-regression-test)