finding-duplicate-functions

Présentation de la skill finding-duplicate-functions

La skill finding-duplicate-functions vous aide à repérer des fonctions qui font la même chose, mais dont le nom ou l’implémentation diffère. Elle est particulièrement utile pour relire du code généré par des LLM ou des codebases qui grossissent vite, où les duplications sémantiques s’accumulent plus vite que les copier-coller à l’identique. Si vous cherchez finding-duplicate-functions for Code Review, cette skill vise les décisions de consolidation, pas les pinaillages de style.

À quoi sert cette skill finding-duplicate-functions

Cette skill finding-duplicate-functions est conçue pour identifier les cas de type « même intention, code différent » : des helpers qui se recoupent, des utilitaires recréés, ou une logique quasi équivalente dispersée dans plusieurs fichiers. Elle est particulièrement pertinente avant une refactorisation, pendant une passe de nettoyage, ou après qu’un outil de doublons syntaxiques comme jscpd a déjà traité les copies exactes.

Qui devrait l’installer

Installez la skill finding-duplicate-functions si vous relisez des dépôts JavaScript ou TypeScript avec beaucoup de petits utilitaires, des fichiers générés ou plusieurs contributeurs. C’est un très bon choix si vous voulez une méthode reproductible pour décider si des fonctions doivent être fusionnées, gardées séparément ou examinées de plus près.

En quoi elle se distingue

Son principal atout, c’est son workflow en deux phases : extraire d’abord les fonctions, puis les regrouper par intention grâce à une analyse LLM. Autrement dit, la skill est pensée pour réduire l’incertitude sur les doublons sémantiques, pas seulement pour détecter des lignes identiques. L’intérêt pratique, c’est de passer plus vite du sentiment que « ce code fait doublon » à un plan de consolidation exploitable en revue.

Comment utiliser la skill finding-duplicate-functions

Installer la skill et trouver le workflow

Utilisez le chemin d’installation du dépôt depuis le répertoire des skills : npx skills add obra/superpowers-lab --skill finding-duplicate-functions. Après l’installation, commencez par skills/finding-duplicate-functions/SKILL.md, puis lisez les scripts d’aide dans skills/finding-duplicate-functions/scripts/, car c’est eux qui définissent la vraie séquence d’analyse. Pour un guide finding-duplicate-functions, ces scripts comptent plus que le texte d’introduction.

Quel input la skill attend

La skill fonctionne au mieux si vous fournissez un répertoire source et un objectif de revue concret. De bons inputs mentionnent la zone de code, la raison de l’analyse et les exclusions éventuelles. Par exemple : « Parcourir packages/api/src à la recherche de helpers de validation en double avant de fusionner les flux d’authentification ; ignorer les fichiers de test et ne remonter que les candidats à forte confiance. » C’est mieux que « trouver des doublons », parce que cela donne le périmètre, l’intention et le format de sortie attendu.

Lisez d’abord ces fichiers

Priorisez scripts/extract-functions.sh, scripts/categorize-prompt.md, scripts/find-duplicates-prompt.md, scripts/prepare-category-analysis.sh et scripts/generate-report.sh. Ces fichiers montrent le schéma exact d’utilisation de finding-duplicate-functions : extraire un catalogue, catégoriser les fonctions, les séparer par catégorie, lancer une comparaison sémantique, puis générer un rapport. Si vous ne lisez qu’un seul fichier, commencez par SKILL.md puis scripts/extract-functions.sh pour comprendre la forme des entrées et les exclusions.

Conseils de workflow qui changent les résultats

Considérez l’étape de catégorisation comme un filtre, pas comme un détail secondaire. La skill est plus précise quand les catégories sont cohérentes et contiennent suffisamment de fonctions à comparer, car la détection de doublons s’exécute catégorie par catégorie. Exclure les tests par défaut est généralement le bon choix pour du nettoyage de production, mais il faut les inclure si votre objectif est d’identifier des utilitaires de test partagés ou des helpers de fixtures. Utilisez le rapport généré comme une shortlist pour revue humaine, pas comme un plan de refactorisation automatique.

FAQ de la skill finding-duplicate-functions

Est-ce mieux qu’un prompt classique ?

Oui, quand vous voulez un workflow reproductible pour trouver l’intention de fonctions dupliquées plutôt qu’une réponse de brainstorming ponctuelle. Un prompt classique peut passer à côté du contrôle du périmètre, de la sélection des fichiers et des seuils de confiance. La skill finding-duplicate-functions vous donne un workflow et une structure de sortie plus faciles à réutiliser en code review.

Est-ce que ça remplace les outils de doublons syntaxiques ?

Non. Cela les complète. Les outils syntaxiques détectent le code copié ; cette skill repère des fonctions sémantiquement proches même quand l’implémentation change. Si votre codebase a déjà des problèmes de copies exactes, traitez-les d’abord pour que la passe sémantique reste bien ciblée.

Est-ce adapté aux débutants ?

Oui, si vous pouvez la pointer vers un arbre source et décrire ce qui doit être relu. L’essentiel à comprendre au départ, c’est que la détection de doublons se fait par catégorie et dépend de frontières d’entrée bien définies. En cas de doute, commencez par un package ou une zone fonctionnelle précise plutôt que par tout le dépôt.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas cette skill si vous avez besoin de conseils d’architecture généraux, d’une correction ponctuelle de bug ou d’un résumé global de la codebase. Elle convient aussi mal si votre dépôt contient surtout du code non JS/TS, car le script d’extraction est orienté vers les patterns de fonctions JavaScript et TypeScript. Si votre seul objectif est de trouver des copies exactes, un détecteur copier-coller plus simple suffit.

Comment améliorer la skill finding-duplicate-functions

Définir un périmètre plus serré et un objectif de décision plus clair

Le plus grand gain de qualité vient du rétrécissement du périmètre de revue et de l’indication de l’action attendue. Au lieu de demander tous les doublons, demandez par exemple des « points potentiels de consolidation dans src/utils avec une préférence pour les fusions à forte confiance ». Cela améliore l’usage de finding-duplicate-functions, car le modèle peut comparer des fonctions qui sont réellement en concurrence.

Fournir les bons cas de contraste

Si vous soupçonnez déjà certaines paires, incluez-les dans le prompt comme candidats probables et précisez pourquoi elles peuvent différer. Exemple : « Comparer parseUserInput, normalizeInput et sanitizeInput ; elles peuvent se recouper, mais l’une gère l’échappement HTML. » Cela aide la skill à distinguer les vrais doublons des helpers voisins qui partagent seulement du vocabulaire.

Surveiller les modes d’échec courants

Le principal mode d’échec, c’est le sur-regroupement : des fonctions aux noms proches mais aux règles métier différentes sont fusionnées trop agressivement. Le second, c’est le sous-regroupement : de petits wrappers sont traités comme distincts alors qu’ils ne diffèrent que par la forme des paramètres ou par le nommage. Dans les deux cas, ajoutez du contexte sur les entrées, les sorties et le comportement attendu afin que la revue juge l’intention, pas seulement la ressemblance de surface.

Passer du rapport à la refactorisation par itérations

Après le premier passage, utilisez le rapport pour choisir une catégorie et vérifier manuellement les groupes les plus fiables dans le code source. Si un groupe est borderline, resserrez la catégorie ou relancez avec de meilleures lignes de contexte et un seuil de recommandation plus clair. Le meilleur guide finding-duplicate-functions est itératif : servez-vous de la première sortie pour affiner le périmètre, puis relancez sur la tranche suivante de la codebase.