Communitygithub.com

mike1026915/performance-audit-skill

Skill d'audit de performance statique pour Claude Code & Cursor — détecte les requêtes N+1, les index manquants et le code O(n²) dans les applications NestJS/Next.js/Prisma/Postgres.

Qu'est-ce que performance-audit-skill ?

Ce skill permet de réaliser un audit statique des performances d’une application full-stack utilisant NestJS, Next.js, Prisma et PostgreSQL, sans nécessiter de serveur en cours d’exécution. Il analyse le code source via des patterns de recherche (grep) et produit un rapport hiérarchisé par sévérité (Haute, Moyenne, Basse). Il couvre 35 règles réparties sur 5 couches : accès aux données (Prisma), API NestJS, composants React/Next.js, schéma PostgreSQL, et complexité algorithmique O(n²). Chaque règle est vérifiée en contexte pour filtrer les faux positifs (ex : requêtes bornées, collections de taille fixe, attentes séquentielles avec dépendance réelle). Le skill s’intègre facilement dans Claude Code ou Cursor, s’adapte automatiquement à la stack détectée, et ne modifie jamais le code. Il est idéal pour les développeurs qui souhaitent identifier rapidement les goulots d’étranglement avant de passer en production.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mike1026915/performance-audit-skill/tree/main

Demander à votre IA préférée

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

Documentation

performance-audit

Un Claude Code skill (et une Cursor règle correspondante) qui audite statiquement une base de code NestJS + Next.js + Prisma + PostgreSQL pour détecter les anti-patterns de performance et produit un rapport classé par sévérité.

Aucun serveur n'a besoin d'être en cours d'exécution — il fonctionne en analysant le code source, pas en profilant une application en direct.

Ce qu'il trouve

35 règles réparties sur 5 couches :

CoucheCouvre
D — Prisma / accès aux donnéesRequêtes N+1, findMany sans limite, sur-récupération, SQL brut sans limite, travail lent dans les transactions, E/S parallèles sans limite
A — API NestJSAppels synchrones bloquants dans le chemin de requête, points d'accès de liste sans pagination, appels externes séquentiels, caches en mémoire sans limite
F — Next.js / ReactBundles clients lourds non fractionnés, 'use client' inutile, récupération de données initiale côté client, absence de debounce sur les champs de recherche
S — Schéma PostgreSQLIndex manquants sur les clés étrangères / champs de requête chauds, recherche ILIKE non ancrée, colonnes vectorielles non indexables
G — Complexité algorithmiquePatterns O(n²) : recherches linéaires répétées dans des boucles, comparaisons par paires imbriquées, tris dans des boucles, copies par accumulateur-étalement, clones JSON.parse(JSON.stringify())

Chaque règle correspond à un motif grep, mais chaque occurrence est vérifiée en contexte avant d'être signalée — les faux positifs connus (requêtes limitées, collections de taille fixe, attentes séquentielles avec une vraie dépendance de données, etc.) sont filtrés. Il ne modifie jamais le code — il produit uniquement un rapport.

Installation

Copiez ce dossier dans votre projet :

# Claude Code
cp -r performance-audit /chemin/vers/votre-projet/.claude/skills/

# Cursor 
cp performance-audit.mdc /chemin/vers/votre-projet/.cursor/rules/

C'est tout — aucune dépendance, aucune étape de build.

Utilisation

Il suffit de demander, dans l'un ou l'autre outil :

vérifie les performances trouve les requêtes lentes pourquoi l'application est lente audite les performances du module candidat

Vous pouvez limiter la portée ("vérifie les performances dans packages/api uniquement") ou demander un passage rapide ("vérification rapide des performances" exécute seulement les règles de sévérité Haute).

Prérequis

  • Détecte automatiquement votre stack et ignore les couches qui ne s'appliquent pas (ex : pas de fichiers *.prisma → les couches D et S sont ignorées). La couche G (complexité algorithmique) s'exécute toujours car elle utilise du TS/JS pur, non spécifique à un framework.
  • Construit et réglé sur un monorepo NestJS + Next.js + Prisma + PostgreSQL, mais les couches D/A/F/S se dégradent gracieusement sur des piles partielles (ex : NestJS sans Next.js), et G fonctionne sur tout projet TS/JS.

Sortie

Un rapport markdown classé Haute → Moyenne → Basse, chaque résultat avec fichier:ligne, pourquoi c'est lent, et un correctif concret :

# Audit de performance — 2026-07-09
Couches analysées : D, A, F, S, G (ignorées : aucune)

## Haute
1. `src/foo.service.ts:123` — [D1] N+1 : une requête par candidat dans `.map(async)`
   Pourquoi c'est lent : N candidats → N+1 allers-retours ; croît linéairement avec les données.
   Correctif : un seul `findMany` avec `where: { id: { in: ids } }`, ou `include` la relation.

Les rapports de plus de 20 résultats sont également sauvegardés dans performance-audit-report.md à la racine du dépôt.

Licence

MIT — utilisez-le, forkez-le, adaptez les règles à votre propre stack.

Skills associés