AI CodeOps

Template de description de PR pour les changements écrits par l'IA

Mis à jour le

Un template de PR pour les changements écrits par un agent IA : tâche, outil, ce qui a été vérifié ou non, et où les relecteurs devraient regarder d'abord.

Enregistrez le bloc ci-dessous sous .github/pull_request_template.md (GitHub) ou comme fichier Markdown dans .gitlab/merge_request_templates/ (GitLab). Supprimez les sections que votre équipe n'utilise pas, ainsi que cette note.

## What this changes

<!-- One or two sentences a reviewer can check the diff against. -->

## Why

<!-- The issue, ticket or decision this comes from. -->

Closes #

## How it was made

- [ ] Written by a person
- [ ] Written with an AI assistant (completion or chat)
- [ ] Written by a coding agent

Tool and model:
Task given to the tool (paste it, or link to it):

## What was verified

- [ ] Tests ran on this exact commit: <!-- link to the run -->
- [ ] New tests fail without this change
- [ ] No tests were deleted, skipped or loosened (or the reason is below)
- [ ] Checked by hand: <!-- what, and how -->

## What was NOT verified

<!-- Be specific. "Not run against production-sized data", "No browser test for Safari". Write "Nothing" only if that's true. -->

## Where to look first

<!-- The files or lines where a mistake would be expensive: money, auth, permissions, personal data, migrations. -->

## Out of scope

<!-- Anything the tool changed that the task didn't ask for, and why it stays. Empty is best. -->

## Risk and rollback

- Risk: low / medium / high, because
- Rollback: revert this commit / feature flag / other:
- Needs a migration or config change: yes / no

## Reviewer

- [ ] I read the task and the test results before the code
- [ ] I'm not the person who gave the tool its task

Comment le remplir

What this changes (ce que cela change). Rédigez-le de façon qu'un relecteur puisse le placer à côté du diff. Si le résumé et le diff ne concordent pas, l'un des deux est faux, et cela mérite d'être su avant de lire quoi que ce soit d'autre.

How it was made (comment il a été produit). Cochez une case et indiquez l'outil et le modèle. Les relecteurs ne lisent pas le code écrit par un agent de la même façon : le risque tient moins à la syntaxe qu'au périmètre, aux hypothèses et aux tests. Collez la tâche. C'est la véritable spécification de ce que l'agent a construit.

What was verified (ce qui a été vérifié). Chaque case cochée nécessite une preuve, idéalement un lien vers l'exécution de tests de ce commit. Une exécution antérieure au dernier push ne compte pas. Si vous avez coché « New tests fail without this change », vous l'avez vérifié en annulant le correctif et en exécutant ces tests.

What was NOT verified (ce qui n'a PAS été vérifié). C'est la section la plus utile, et celle que l'on laisse le plus souvent vide. Les agents décrivent leur propre travail comme terminé. La personne qui remplit cette section sert de contrôle sur ce point.

Where to look first (où regarder d'abord). Indiquez les quelques endroits où une erreur coûte vraiment de l'argent ou de la confiance. Un relecteur qui dispose de peu de temps devrait le consacrer à ces endroits.

Out of scope (hors périmètre). Les agents corrigent ce qu'ils remarquent en chemin. Listez ces corrections ici, ou mieux, déplacez-les dans leur propre pull request.

Reviewer (relecteur). Deux cases pour la personne qui approuve. La seconde existe parce que la personne qui a rédigé la tâche est, de fait, l'auteur du changement.

Questions fréquentes

Où placer ce template de pull request ?

Sur GitHub, enregistrez-le sous .github/pull_request_template.md. Sur GitLab, enregistrez-le comme fichier Markdown dans .gitlab/merge_request_templates/ et choisissez-le lorsque vous ouvrez la merge request.

Pourquoi demander ce qui n'a pas été vérifié ?

Parce qu'un relecteur ne peut pas voir ce qui ne s'est pas produit. Une ligne indiquant que la migration n'a pas été exécutée sur une copie de la production lui dit exactement où regarder, et coûte dix secondes à l'auteur.

L'agent IA devrait-il remplir ce template lui-même ?

Il peut en rédiger un brouillon, mais une personne le vérifie avant de demander une revue. La section de vérification en particulier est une affirmation, et une affirmation sur des tests a besoin de l'exécution de tests qui l'étaye.

Citer cette page

AI CodeOps (2026). Template de description de PR pour les changements écrits par l'IA. https://aicodeops.dev/templates/ai-pr-description

Cette page et ses téléchargements sont sous licence CC BY 4.0 : copiez-les et adaptez-les pour votre équipe, et faites un lien vers cette page lorsque vous publiez votre version.