Correction de PR
Lit les commentaires de revue, implémente les correctifs, pousse, répond aux fils de discussion.
Invocation
/fix-pr # corrige la PR de la branche courante
/fix-pr 42 # corrige la PR #42
Processus
1. Identifier et récupérer la PR
gh pr view <PR> --json number,title,headRefName,state
Refuser si la PR est fermée ou fusionnée.
Si la branche courante n'est pas la branche de la PR (le pipeline /developer exécute ceci dans un worktree frais), la récupérer d'abord :
gh pr checkout <PR>
Ne jamais faire git checkout main — dans un worktree lié, cela échoue car main est extrait dans le worktree primaire.
2. Lire tous les retours
# Commentaires de premier niveau
gh pr view <PR> --comments
# Fils de discussion (en ligne)
gh api repos/{owner}/{repo}/pulls/<PR>/comments \
--jq '[.[] | {id, path, line, body, in_reply_to_id}]'
# Résumés de revue
gh api repos/{owner}/{repo}/pulls/<PR>/reviews \
--jq '[.[] | select(.body != "") | {id, state, body}]'
Collecter : fils de discussion en ligne non résolus, commentaires de résumé de revue, commentaires généraux de la PR.
Refuser s'il n'y a rien à traiter — aucun retour trouvé.
3. Implémenter les correctifs
- Traiter chaque commentaire non résolu
- Garder les modifications minimales — uniquement ce que demande le retour
- Ne pas refactoriser du code non concerné
- Une fois tous les correctifs appliqués : exécuter les vérifications du projet (voir
AGENTS.md/CLAUDE.mdpour les commandes exactes), typiquement :
pnpm typecheck
pnpm test
Corriger les échecs avant de commiter.
4. Commit et push
git add <fichiers modifiés> # staging par chemin — jamais `git add -p` (interactif) ou `git add -A`
git commit -m "fix(pr): corriger les commentaires de revue sur #<PR>"
git push origin <branche>
5. Répondre aux fils de discussion
Pour chaque fil de discussion traité, répondre :
gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="Corrigé dans <commit-sha> : <description en une ligne de ce qui a changé>."
6. Rapport
Lister chaque commentaire traité et ce qui a été fait. Signaler tout commentaire ignoré et pourquoi.
Règles
- Un seul commit pour tous les correctifs (pas un par commentaire)
- Répondre à chaque fil de discussion que vous traitez
- Si un commentaire est peu clair : faire l'interprétation la plus raisonnable, l'implémenter, et indiquer votre interprétation dans la réponse au fil (sans assistance — personne à qui demander). Si un commentaire est erroné, expliquer pourquoi dans la réponse au lieu de l'implémenter
- Si un correctif casserait les tests : le signaler, ne pas forcer le push avec du code cassé
- Ne pas résoudre les fils de discussion — GitHub les résout automatiquement lors du push