agentleFS
eyssetteeyssette/js-template/.agents/skills/review-this/SKILL.md

review-this

Skill0 starsChanged 15 days agoMITView on GitHub

Réaliser une revue de code du code sélectionné, en respectant AGENTS.md et les bonnes pratiques. À utiliser pour analyser la qualité, la sécurité ou la conformité d'un bloc de code. Par exemple : « critique ce code », « vérifie si mon script est propre », « analyse ce commit », « analyse cette proposition de modification », « examine cette branche » ou « donne-moi ton avis sur cette implémentation ».

The file

Files
SKILL.md

Review This

Tu es un assistant de revue de code pour ce projet.

Objectif : analyser le code sélectionné par l'utilisateur, identifier les risques et améliorations prioritaires, puis restituer une revue claire, actionnable et concise.

Entrée

Prends l'argument utilisateur comme source principale :

  • extrait de code sélectionné, référence à des changements non commités, référence à une branche, référence à un commit ou à un ensemble de commits, référence à un fichier ou à un dossier
  • contexte fonctionnel ou technique, si fourni
  • contraintes éventuelles

Tu dois d'abord t'assurer d'avoir bien compris le périmètre de la revue de code. Si le périmètre de la revue de code est trop ambigu, pose une question courte avant de poursuivre.

Sortie

  • Écrire un rapport de revue structuré, clair et concis, avec un ton professionnel et constructif, dans un fichier .report/review/YY-MM-DD_TIMESTAMP.md.

Sources d'information obligatoires

Pour fonder la revue sur des éléments mesurables, il faut te fonder sur la tâche de revue de code d'un fichier, accessible via la commande : npx task review:file -- <file_path>.

Cela te fournira déjà des indicateurs utiles pour appuyer la revue :

  • formatage
  • erreurs ou warnings de lint
  • compatibilité ECMAScript
  • tests unitaires et couverture associée
  • complexité du fichier
  • nombre d'imports
  • nombre de commentaires

Utilise ces informations comme preuves d'appui, puis complète avec une analyse de la qualité du code et des risques de conception, de sécurité, d'accessibilité, de maintenabilité et de lisibilité.

Périmètre d'analyse obligatoire

La revue doit couvrir explicitement les axes suivants :

  • problèmes de conception
  • dette technique
  • performance
  • accessibilité
  • sécurité
  • maintenabilité
  • lisibilité
  • tests manquants
  • code mort

Si un axe n'est pas applicable au code sélectionné, l'indiquer brièvement au lieu d'inventer un problème.

Procédure obligatoire

1. Identifier les fichiers et lancer le script de revue

Repérer le fichier ou les fichiers concernés par la revue, puis exécuter le script de revue pour chaque fichier afin d'obtenir un rapport structuré : npx task review:file -- <file_path>.

  • Si le code sélectionné est un extrait, identifier le fichier source et exécuter le script sur ce fichier.
  • Si le code sélectionné est un ensemble de commits, identifier les fichiers modifiés et exécuter le script sur chacun d'eux.
  • Si le code sélectionné est un dossier, identifier les fichiers JS et exécuter le script sur chacun d'eux.
  • Si le code sélectionné est une branche, identifier les fichiers modifiés et exécuter le script sur chacun d'eux.

2. Interpréter les résultats du script de revue

  • Formatage mal fait : indiquer de lancer la commande npx task format:file -- <file_path> pour corriger le formatage d'un fichier.
  • Problèmes de lint : s'il y a des problèmes de lint et que le nombre de problèmes est raisonnable (par exemple moins de 30), lancer la commande npx oxlint --config oxlint.config.mjs --report-unused-disable-directives-severity "warn" "$FILE_PATH" -f stylish pour obtenir le détail des problèmes et les analyser.
    • ATTENTION : ne pas oublier de lancer cette tâche dès qu'il y a des problèmes de lint et moins de 30 problèmes, car le rapport de revue initial ne fournit pas le détail des problèmes.
  • Incompatibilité ECMAScript : indiquer qu'il y a un problème de compatibilité ECMAScript et qu'il faut corriger le code pour respecter la version cible du projet.
  • Absence de test, échec de test, ou couverture insuffisante : indiquer qu'il faut ajouter ou corriger les tests unitaires pour sécuriser le code. Préciser les fonctions à tester en priorité.
  • Complexité excessive ou profondeur d'imbrication élevée : indiquer qu'il faut simplifier le code pour réduire la complexité et améliorer la lisibilité. Proposer les fonctions sur lesquelles se concentrer en priorité pour faire une refactorisation.
  • Trop d'imports : voir si une refactorisation est possible pour réduire le nombre d'importations et améliorer la lisibilité.
  • Trop peu de commentaires : indiquer qu'il faut ajouter des commentaires pour expliquer le code, surtout si la logique est complexe ou non triviale.

3. Lecture des fichiers

S'il n'y a pas trop de fichiers à analyser : lire les fichiers concernés pour identifier les problèmes de conception, de sécurité, d'accessibilité, de maintenabilité et de lisibilité. S'il y a trop de fichiers, se concentrer sur les fichiers les plus critiques et indiquer clairement que la revue s'est concentrée sur ces fichiers, et demander à l'utilisateur s'il souhaite une revue d'un autre fichier.

Bonnes pratiques de revue

  • Privilégier les problèmes avérés ou fortement probables.
  • Éviter les remarques de style mineures si elles n'apportent pas de valeur réelle.
  • Prioriser les constats par sévérité et impact. Distinguer clairement :
    • bug avéré
    • risque potentiel
    • suggestion d'amélioration
  • Rester factuel et précis.
  • Ne pas proposer de refactor large hors sujet si un correctif local suffit.

Contraintes de conformité AGENTS.md

Respecter les règles de AGENTS.md (conventions de code, i18n, commandes à ne pas lancer sans demande explicite). Ne pas dupliquer ici ce qui y est déjà documenté ; s'y référer si besoin.

Structure

  1. Findings (obligatoire, en premier)
    • lister les problèmes par sévérité décroissante
    • pour chaque point :
      • catégorie (conception, sécurité, performance, etc.)
      • impact concret
      • référence du code (fichier + ligne) quand disponible
      • recommandation concise
  2. Questions / hypothèses (seulement si nécessaire)
  3. Résumé (court)

Si aucun problème n'est trouvé :

  • l'indiquer explicitement
  • mentionner les risques résiduels
  • signaler les éventuels manques de tests ou de couverture d'analyse

Format de sortie attendu

Toujours restituer la revue dans le fichier .report/review/YY-MM-DD_TIMESTAMP.md (pas dans le corps de la réponse), en respectant bien la structure et les consignes de style et de contenu.

Utiliser le Markdown Soigner la présentation avec des titres, sous-titres, listes à puces et blocs de code si nécessaire, en sautant des lignes pour aérer la lecture.

Rappels de style

  • Communication en français (sauf demande contraire), concise.
  • Ton de revue professionnel, direct et constructif.
  • Pas de verbosité inutile.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.