--- name: dossier-de-preuves description: "Rassemble et présente les preuves qu'une pull request Contoso peut être fusionnée (checks, nouvelles alertes de code scanning, revue Copilot, conversations ouvertes, règles de la branche) et rédige le dossier de preuves. À utiliser quand on demande si une PR est prête, pourquoi elle est bloquée, ou de préparer le dossier de preuves." --- # Dossier de preuves d'une pull request Objectif : qu'un humain décide de fusionner **sur preuves**, pas sur intuition. ## 1. Collecter Si le canvas **Portail plateforme** (plugin `plateforme-contoso`) est disponible, ouvre-le et appelle l'action `afficher_preuves` avec `{ "depot": "PROPRIETAIRE/DEPOT", "pr": NUMERO }`. Elle affiche les preuves à l'écran et te renvoie un résumé structuré avec un verdict. Sinon, utilise GitHub CLI : ```shell gh pr view NUMERO --repo PROPRIETAIRE/DEPOT --json title,state,mergeStateStatus,reviewDecision,headRefOid,baseRefName,url gh pr checks NUMERO --repo PROPRIETAIRE/DEPOT gh api "repos/PROPRIETAIRE/DEPOT/code-scanning/alerts?ref=refs/pull/NUMERO/merge&state=open" gh api repos/PROPRIETAIRE/DEPOT/rules/branches/BRANCHE_DE_BASE gh api repos/PROPRIETAIRE/DEPOT/pulls/NUMERO/reviews ``` Pour les alertes, ne compte que les **nouvelles** : celles ouvertes sur la PR et absentes de la branche de base. ## 2. Juger | Élément | Prêt si | | --- | --- | | Checks | tous terminés et réussis, dont les checks requis par les règles (`tests`) | | Sécurité | aucune nouvelle alerte de code scanning haute ou critique | | Revue | revue Copilot reçue et ses commentaires traités ; approbations requises obtenues | | Règles | `mergeStateStatus` vaut `CLEAN` (aucune règle de la branche ne bloque) | Ne déclare jamais une PR prête si un élément est inconnu : écris « inconnu » et la raison. ## 3. Rédiger Présente le dossier ainsi, en français : ```markdown ## Dossier de preuves : (#) **Verdict :** Prête à fusionner | Bloquée | En attente | Preuve | État | Détail | | --- | --- | --- | | Checks | ✅ / ❌ / ⏳ | … | | Sécurité (code scanning) | … | … | | Revue Copilot | … | … | | Règles de la branche | … | … | **Reste à faire :** … ``` Ne publie le dossier en commentaire de la PR (`gh pr comment`) que si l'utilisateur le demande. Ne fusionne jamais : la décision appartient à l'humain ou à Agent Merge une fois les règles satisfaites.