Rapport de Qualité du Code

Objectif

Ce skill exécute une suite complète de vérifications de qualité du code et génère un rapport structuré en JSON et Markdown. Il est conçu pour :

• Vérifier la conformité TypeScript (typecheck)
• Valider le linting et le formatage avec Biome
• Exécuter les tests unitaires
• Analyser la couverture de code
• Fournir un rapport détaillé et actionnable

Processus d'exécution

1. Demander confirmation à l'utilisateur (optionnel) :

   • Demander si l'utilisateur souhaite un rapport complet ou ciblé (uniquement certaines vérifications)
   • Demander le niveau de détail souhaité

2. Exécuter le script de rapport :

   • Utiliser le script .claude/skills/quality-report/scripts/generate-quality-report.sh qui orchestrera toutes les vérifications
   • Le script génère automatiquement un fichier JSON avec les résultats détaillés dans .claude/quality-system/reports/

3. Analyser les résultats :

   • Lire le fichier JSON généré
   • Identifier les problèmes critiques et non-critiques
   • Calculer un score de qualité global

4. Présenter le rapport :

   • Utiliser le template .claude/skills/quality-report/resources/report-template.md pour formater la sortie
   • Inclure des recommandations basées sur les erreurs détectées
   • Proposer des actions correctives si nécessaire

Variables d'environnement utilisées

• CLAUDE_PROJECT_DIR : Répertoire racine du projet
• QUALITY_REPORT_FORMAT : Format du rapport (json, markdown, both) - défaut: both
• QUALITY_REPORT_DETAILED : Niveau de détail (true/false) - défaut: true

Exemples d'utilisation

Exemple 1 : Rapport complet demandé par l'utilisateur

Entrée utilisateur : "Peux-tu me générer un rapport de qualité du code ?"

Actions du skill :

1. Exécuter .claude/skills/quality-report/scripts/generate-quality-report.sh
2. Lire le JSON de résultats dans .claude/quality-system/reports/
3. Formater selon le template Markdown
4. Présenter le rapport avec recommandations

Sortie attendue :

# 📊 Rapport de Qualité du Code

**Date :** 2025-10-29 14:30:00
**Projet :** sebc.dev

## Résumé Exécutif

✅ Score global : 85/100

## Détails des Vérifications

### ✓ TypeScript Type Check

- Status: ✅ Passed
- Durée: 2.3s
- Aucune erreur de type détectée

### ⚠ Biome Linting

- Status: ⚠️ Warning
- Durée: 1.1s
- 3 warnings détectés dans apps/web/src/components/Button.tsx

### ✓ Tests Unitaires

- Status: ✅ Passed
- Tests: 42 passed, 0 failed
- Durée: 5.7s

### ✓ Couverture de Code

- Status: ✅ Passed
- Coverage: 87.5% (seuil: 80%)
- Fichiers non couverts: 2

## Recommandations

1. Corriger les 3 warnings Biome dans Button.tsx
2. Améliorer la couverture pour les fichiers: utils/api.ts, hooks/useAuth.ts

Exemple 2 : Rapport ciblé après modification

Entrée utilisateur : "J'ai modifié le composant Login, vérifie que tout est OK"

Actions du skill :

1. Identifier les fichiers modifiés (Login.tsx, Login.test.tsx)
2. Exécuter les vérifications ciblées
3. Générer un rapport focalisé

Sortie attendue :

# 📊 Rapport de Qualité - Composant Login

## Vérifications Ciblées

- Fichiers analysés: Login.tsx, Login.test.tsx

### ✓ TypeScript : OK

### ✓ Linting : OK

### ✓ Format : OK

### ✓ Tests : 8/8 passed

✅ Tous les contrôles sont passés pour le composant Login

Gestion des erreurs

Si une vérification échoue de manière critique (typecheck failed, tests failed) :

1. NE PAS bloquer l'affichage du rapport
2. Mettre en évidence les erreurs critiques
3. Proposer des solutions basées sur le type d'erreur :
   • Type errors → Vérifier les interfaces et types
   • Lint errors → Lancer pnpm --filter web format
   • Test failures → Analyser les logs de test et proposer des corrections

Notes importantes

• Ce skill utilise les mêmes vérifications que le hook PostToolUse automatique (.claude/quality-system/hooks/quality-check.sh)
• Il peut être invoqué manuellement à tout moment
• Les rapports sont sauvegardés dans .claude/quality-system/reports/quality-{timestamp}.md
• Le script est non-bloquant : il rapporte les erreurs mais ne stoppe pas l'exécution