Description de pull request claire

---
name: description-pull-request-claire
description: "Rédige une description de pull request claire et actionnable à partir d'un diff ou d'un résumé court. Sortie en 5 sections fixes : contexte produit, changements clés, hors scope, plan de test, screenshots ou captures si UI. À utiliser quand un dev (fullstack, backend, frontend, mobile, DevOps, freelance senior, tech lead) ouvre une PR sur GitHub, GitLab ou Bitbucket et veut épargner aux reviewers la chasse au contexte."
metadata:
  iaskills_title: "Description de pull request claire"
  metier_slug: dev
  metiers:
    - Devs et tech leads
  secteur: "Tech & DSI"
  tier: free
  compatible:
    - claude-code
    - cowork
    - cursor
    - codex
  version: "1.0.0"
  author: "iaskills"
  editorial:
    pitch: "Description de PR claire en 5 sections, prête à coller dans GitHub ou GitLab. Contexte, changements, hors scope, plan de test, captures."
    long_description: "La majorité des PR arrivent en review avec un titre flou et zéro description. Le reviewer doit ouvrir 4 fichiers pour deviner l'intention, devine de travers, demande des changements pas pertinents, et le cycle s'éternise. Ce skill prend votre diff (ou un résumé en 3 phrases) et produit une description structurée en 5 sections : contexte produit (pourquoi cette PR existe), changements clés (ce qui bouge fonctionnellement, pas un re-paraphrase du diff), hors scope (ce que la PR ne fait volontairement pas), plan de test (commandes, scénarios, données seed), captures si la PR touche l'UI. Ton direct, pas de cérémonie, prêt à coller dans le champ description GitHub ou GitLab. Style maison iaskills : pas d'em-dash, pas de superlatif, langue cohérente avec votre repo."
    bullets:
      - "5 sections fixes, prêtes à coller"
      - "Contexte produit, pas paraphrase du diff"
      - "Hors scope explicite, évite les nits"
      - "Plan de test commande par commande"
      - "Compatible GitHub, GitLab, Bitbucket"
    exemple_avant: "Vous ouvrez une PR avec pour titre 'fix bug' et description vide. Le reviewer pose 3 questions en commentaire, vous répondez à côté, deuxième passe, troisième passe. La PR met 4 jours à merger pour 15 lignes touchées."
    exemple_apres: "Le skill rend une description avec contexte SEC-142, les 3 changements clés résumés, hors scope explicite (pas de refactor session middleware), plan de test avec curl et pnpm test, capture du nouveau message 401. Approuvée en une passe, mergée le jour même."
    recommended_metiers: []
    secteurs:
      - tech-dsi
      - startup-vc
      - conseil-audit
      - finance-comptabilite
    metiers_individuels:
      - dev-backend
      - dev-frontend
      - devops
      - qa-engineer
      - architecte-si
      - mlops
      - chef-de-projet-it
      - cto
      - product-manager
      - scrum-master
---

# Description de pull request claire

## Quand utiliser ce skill

Déclencher quand un dev (fullstack, backend, frontend, mobile, DevOps, data, freelance senior, tech lead, QA) prépare l'ouverture d'une pull request ou merge request sur GitHub, GitLab ou Bitbucket et doit rédiger une description que le reviewer pourra parcourir en moins d'une minute.

À utiliser pour :

- PR feature, fix, refactor ou perf qui touche plus de 50 lignes
- PR qui touche l'UI, où une capture est attendue
- PR qui modifie un contrat API ou un schéma DB
- PR ouverte sur un repo où les conventions de description existent mais ne sont pas respectées
- PR open source vers un repo amont, où la qualité de la description conditionne le merge

Ne pas utiliser pour :

- Hotfix urgent prod où le reviewer connaît déjà le contexte (mettre un titre clair suffit)
- Bump de dépendance dépendabot ou renovate (la description est auto-générée)
- PR fixup que l'auteur va squasher avant merge