sgomez/developer-skills

Livraison automatique de PRD pour Claude Code

Qu'est-ce que developer-skills ?

Cette compétence permet à Claude Code de traiter automatiquement les commentaires de revue de code sur GitHub. Elle lit tous les retours (commentaires en ligne, résumés de revue, commentaires généraux) sur une Pull Request, implémente des correctifs minimaux, exécute les vérifications du projet (typecheck, tests), puis pousse et répond aux threads. Elle prend en charge Claude Code et utilise l'API GitHub (`gh`). L'utilisateur gagne du temps en automatisant le cycle retour-implémentation, idéal pour les pipelines CI ou les revues asynchrones. Le processus refuse les PR fermées/fusionnées, ne force pas le push si les tests échouent, et conserve un historique propre avec un seul commit par lot de correctifs.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add sgomez/developer-skills

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.md pour 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

Skills associés