receiving-code-review

Présentation

Ce que fait la skill receiving-code-review

La skill receiving-code-review définit un schéma clair et reproductible pour la façon dont un agent doit répondre lorsqu’il reçoit des retours de revue de code, en particulier sur des pull requests GitHub. Elle met l’accent sur l’évaluation technique plutôt que la performance sociale.

Au lieu d’acquiescer aveuglément aux relecteurs ou d’implémenter immédiatement leurs suggestions, cette skill entraîne l’agent à :

• Lire l’ensemble des retours avant de réagir
• Reformuler ou clarifier le changement demandé
• Vérifier les retours par rapport au code réel
• Évaluer si la suggestion est techniquement correcte pour ce dépôt
• Répondre avec un raisonnement technique étayé, sans flatterie
• Implémenter les changements un par un, uniquement après compréhension et vérification

Pour qui est faite cette skill

Utilisez receiving-code-review si vous :

• Travaillez avec un assistant IA sur des PR GitHub ou des discussions de revue de code
• Souhaitez que l’assistant se comporte comme un relecteur (ou relu) réfléchi, et non comme quelqu’un qui dit oui à tout
• Avez besoin d’aide pour interpréter les commentaires de revue et décider de la suite à donner
• Accordez plus d’importance à la justesse et à la sécurité des changements qu’à un accord rapide mais superficiel

Elle est particulièrement utile pour :

• Les développeurs qui collaborent sur des feature branches et des pull requests
• Les tech leads qui veulent une gestion cohérente des retours de revue
• Les équipes qui expérimentent avec Claude ou d’autres LLM comme partenaires de revue de PR

Quand cette skill n’est pas adaptée

Cette skill n’est pas conçue pour :

• Générer de nouvelles fonctionnalités depuis zéro
• Piloter de grands refactorings sans contexte de revue
• Gérer les formules de politesse, les félicitations ou les mises à jour de statut

Si votre besoin principal est la génération de code, la rédaction de documentation ou l’aide à la conception de haut niveau, combinez cette skill avec d’autres. Utilisez receiving-code-review spécifiquement lorsque l’agent est dans la boucle de réception et de réponse à des retours de revue de code.

Principaux avantages

Avec receiving-code-review installée, votre agent va :

• Éviter les réponses de pure forme comme « You’re absolutely right! » ou « Great point! »
• Fonder ses réponses sur le code réel, pas sur des suppositions
• Demander des précisions plutôt que deviner lorsque le retour n’est pas clair
• Opposer une contradiction argumentée lorsque la suggestion est techniquement incorrecte
• Réduire le risque d’implémenter des changements mal compris ou dangereux

Cela facilite la confiance dans l’agent au sein de vos processus de code-review, git-workflows et pr-review.

Utilisation

1. Installation

Pour installer la skill receiving-code-review depuis le repository obra/superpowers, exécutez :

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Cette commande récupère la définition de la skill (y compris SKILL.md) dans l’environnement de skills de votre agent. L’installation suppose que l’outil npx skills est déjà disponible ; sinon, commencez par le configurer selon les instructions de votre plateforme ou de votre hébergeur d’agent.

2. Fichiers à examiner après l’installation

Après l’installation, examinez le fichier principal de cette skill :

• skills/receiving-code-review/SKILL.md – description canonique du schéma de comportement lors de la réception de retours de revue de code.

Dans le repo plus large obra/superpowers, vous pouvez voir des schémas partagés comme :

• README.md, AGENTS.md ou metadata.json à la racine – contexte général sur la structure et l’usage des skills

Ces fichiers aident à comprendre comment receiving-code-review s’intègre dans un ensemble de règles plus vaste pour Claude / vos agents, mais le cœur opérationnel de cette skill se trouve dans SKILL.md.

3. Workflow de réponse central

La skill définit un schéma de réponse spécifique chaque fois que l’agent reçoit des retours de revue de code (par exemple, dans un fil de commentaires sur une PR GitHub) :

1. READ:     Consume all feedback before reacting
2. UNDERSTAND: Restate the requirement in its own words, or ask
3. VERIFY:   Check the feedback against the real codebase
4. EVALUATE: Decide if it is technically sound for THIS repo
5. RESPOND:  Give a technical acknowledgment or reasoned pushback
6. IMPLEMENT: Change one item at a time and test each

En pratique, cela signifie :

• L’agent ne doit pas annoncer d’emblée qu’il va implémenter une suggestion.
• Il s’assure d’abord qu’il a bien compris ce que le relecteur demande.
• Il inspecte les fichiers/lignes pertinents ou l’état du dépôt.
• Ce n’est qu’ensuite qu’il décide d’appliquer, d’adapter ou de rejeter la suggestion.

Ce schéma est particulièrement utile dans les scénarios de revue de pull request GitHub, où le contexte et la justesse priment sur la vitesse.

4. Réponses interdites ou déconseillées

La skill interdit explicitement certains types de réponses, courants chez les LLM mais nuisibles dans une revue de code sérieuse :

Exemples interdits :

• "You're absolutely right!" (explicitement identifié comme une violation des règles CLAUDE plus générales)
• "Great point!" / "Excellent feedback!" et autres réponses purement laudatives
• "Let me implement that now" lorsque l’agent n’a pas encore vérifié la suggestion

À la place, avec receiving-code-review, l’agent doit :

• Reformuler l’exigence technique : par ex. « You are asking to extract this logic into a separate function to avoid duplication. »
• Poser des questions ciblées quand un point n’est pas clair
• Fournir un raisonnement technique lorsqu’il estime que la suggestion est incorrecte ou incomplète
• Avancer vers des changements concrets sans surenchère explicative ni flatterie

Ainsi, la conversation reste centrée sur la qualité du code, pas sur la politesse.

5. Gestion des retours flous ou partiels

La skill définit une règle stricte pour les retours ambigus :

IF any item in the feedback is unclear:
  STOP – do not implement anything yet
  ASK for clarification on the unclear items

La logique : les éléments individuels d’une revue peuvent être liés ; implémenter ceux que vous « pensez » comprendre alors que d’autres restent ambigus peut conduire à :

• Des changements contradictoires
• Des workflows cassés
• Un comportement non aligné avec l’intention du relecteur

Par exemple, si un relecteur écrit « Fix 1–6 » et que l’agent ne comprend clairement que les points 1, 2, 3 et 6, receiving-code-review l’oriente pour :

• Mettre en pause l’implémentation
• Poser des questions précises sur les points 4 et 5
• N’implémenter qu’une fois l’ensemble des exigences bien comprises

Ce comportement est crucial dans des workflows git automatisés ou semi-automatisés, où une compréhension partielle peut très vite aboutir à des branches cassées.

6. Intégration à votre workflow GitHub / PR

Pour tirer le meilleur parti de receiving-code-review dans un projet réel :

1. Attachez la skill à votre agent utilisé pour :

   • Relire des pull requests
   • Rédiger des réponses aux commentaires des relecteurs
   • Aider à trier ou résumer les retours de revue

2. Assurez l’accès au dépôt pour l’agent afin qu’il puisse réellement vérifier les suggestions par rapport :

   • Au code de la branche courante
   • Aux fichiers et modules pertinents

3. Combinez-la avec des skills complémentaires pour de meilleurs résultats, par exemple :

   • Une skill de coding ou de refactoring pour implémenter les changements validés
   • Des skills de navigation ou de recherche dans le repository pour localiser rapidement le code concerné

4. Informez votre équipe que l’agent va :

   • Poser des questions de clarification plutôt que deviner
   • Parfois contester des suggestions incorrectes ou risquées
   • Éviter les compliments génériques au profit de réponses techniques précises

Intégrée de cette façon, receiving-code-review devient un garde-fou qui maintient votre collaborateur IA discipliné et fiable dans les conversations de revue de code.

7. Quand activer cette skill

Utilisez receiving-code-review chaque fois que votre prompt ou votre workflow indique que l’agent est en train :

• De lire des retours (humains ou bots) sur une pull request
• De parcourir des commentaires inline dans les vues de diff GitHub
• De traiter des notes de revue dans un outil de code-review

Vous n’en avez généralement pas besoin lorsque :

• Vous générez le code initial ou le premier jet d’une fonctionnalité
• Vous rédigez des documents de conception ou des ADR
• Vous effectuez des tâches hors revue, comme des mises à jour de dépendances

N’activer la skill que dans des contextes de revue rend le comportement de votre agent plus prévisible et focalisé.

FAQ

Quel problème receiving-code-review résout-elle ?

La skill receiving-code-review traite le problème des réponses superficielles et performatives des IA aux retours de revue de code. Au lieu d’approuver systématiquement et de modifier immédiatement le code, l’agent :

• Lit l’ensemble des retours
• Les vérifie par rapport au code existant
• Clarifie les demandes ambiguës
• Oppose, si nécessaire, une réponse argumentée sur le plan technique

Cela réduit fortement les implémentations incorrectes et les incompréhensions dans les PR GitHub et autres outils de code-review.

Comment installer receiving-code-review ?

Installez la skill depuis le repository obra/superpowers avec :

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Après l’installation, consultez SKILL.md dans le répertoire de la skill receiving-code-review pour comprendre précisément les règles de comportement.

Est-ce que cette skill change la façon d’écrire le code ?

Indirectement. receiving-code-review ne génère pas de code en soi, mais influence fortement comment et quand les changements de code sont effectués, en imposant :

• La vérification avant l’implémentation
• Des changements et tests item par item
• L’évitement des correctifs partiels ou mal compris

Combinez-la avec des skills de coding pour gérer l’implémentation une fois les retours de revue validés.

receiving-code-review peut-elle contredire un relecteur humain ?

Oui. La skill autorise et encourage explicitement une contradiction technique argumentée lorsque les retours sont :

• Incorrects pour le code actuel
• Basés sur des hypothèses obsolètes
• Susceptibles d’introduire des bugs ou des régressions

La contestation doit s’appuyer sur des éléments concrets du repository, pas sur des opinions.

Cette skill est-elle réservée à GitHub ?

La skill est conçue pour des workflows de PR review à la GitHub, mais elle s’applique à tout environnement où un agent reçoit des retours structurés de revue de code, notamment :

• Des outils de revue de code basés sur git
• Des dashboards internes de revue
• Des sessions de revue en chat où les commentaires référencent des fichiers et lignes spécifiques

Si votre workflow ressemble à des commentaires de PR associés à un repository git, receiving-code-review est probablement adaptée.

Comment cela interagit-il avec CLAUDE ou d’autres règles d’agent ?

Dans l’écosystème obra/superpowers, les skills se superposent à des règles de plus haut niveau (souvent dans des fichiers comme CLAUDE.md). receiving-code-review se réfère à ces attentes en interdisant, par exemple, des réponses comme « You're absolutely right! » qui vont à l’encontre de l’esprit de ces règles.

Utilisez-la aux côtés de vos règles d’agent existantes pour :

• Renforcer la rigueur en revue
• Éviter la sur-optimisation sociale
• Maintenir une cohérence entre projets et repositories

Et si mon équipe préfère des réponses plus polies ?

Vous pouvez conserver un ton professionnel, mais cette skill privilégie une communication technique claire aux formules de politesse. Si vous avez besoin d’un ton plus « soft », vous pouvez :

• Ajouter des directives spécifiques sur le ton dans d’autres skills
• Garder receiving-code-review comme socle pour la vérification et la rigueur

Cette séparation vous permet d’ajuster le style sans affaiblir la discipline de revue au cœur de cette skill.

Comment savoir si cette skill fonctionne correctement ?

Des signes que receiving-code-review est active et efficace incluent :

• L’agent ne répond plus par des compliments génériques aux commentaires de revue
• Il reformule les exigences avant d’agir
• Il pose des questions lorsque les retours sont incomplets ou ambigus
• Il cite des fichiers, fonctions ou lignes précis lorsqu’il accepte ou conteste des suggestions

Si vous voyez encore des réponses du type « I’ll implement that » sans aucune vérification, revoyez la configuration de vos skills et assurez-vous que cette skill est bien activée dans les contextes de revue.