audit

Vue d'ensemble

Qu'est-ce que la compétence audit ?

La compétence audit est conçue pour les développeurs frontend et les équipes qui souhaitent évaluer systématiquement la qualité technique de leur base de code. Elle vérifie l'accessibilité (A11y), la performance, la cohérence du theming, le design responsive et les anti-patterns courants. La compétence génère un rapport noté avec des niveaux de gravité (P0-P3) et des plans d'action, vous aidant à prioriser les améliorations et à maintenir des standards élevés.

À qui s'adresse audit ?

• Ingénieurs frontend souhaitant valider la qualité du code
• Équipes QA centrées sur l'accessibilité et la performance
• Chefs de projet préparant la conformité ou le lancement
• Toute personne ayant besoin d'un audit structuré au niveau du code (et non d'une critique de design)

Problèmes résolus

• Identification des lacunes en accessibilité (contraste, ARIA, navigation clavier, HTML sémantique, texte alternatif, formulaires)
• Détection des goulets d'étranglement en performance
• Mise en évidence des problèmes de theming et de design responsive
• Repérage des anti-patterns et de la dette technique
• Fourniture de niveaux de gravité clairs et d'étapes à suivre

Comment utiliser

Étapes d'installation

1. Installez la compétence audit avec :

   npx skills add https://github.com/pbakaus/impeccable --skill audit
   

2. Consultez le fichier SKILL.md pour les instructions détaillées et les critères de notation.

Préparation

• Avant d'exécuter audit, lancez /frontend-design pour collecter le contexte design et les anti-patterns. Si aucun contexte design n'existe, lancez d'abord /teach-impeccable.
• La compétence audit se concentre sur des aspects techniques mesurables ; elle ne corrige pas les problèmes mais les documente pour un suivi.

Exécution de l'audit

• Utilisez la compétence pour analyser votre base de code frontend. Elle vérifie cinq dimensions clés :
  • Accessibilité (A11y)
  • Performance
  • Theming
  • Design responsive
  • Anti-patterns
• Chaque dimension est notée de 0 (problèmes critiques) à 4 (conformité excellente).
• Le résultat est un rapport complet avec des niveaux de gravité (P0-P3) et des recommandations exploitables.

Structure des fichiers et revue

• Commencez par SKILL.md pour le workflow et les détails de notation.
• Explorez les fichiers complémentaires tels que README.md, AGENTS.md, metadata.json, ainsi que les dossiers rules/, resources/, references/ ou scripts/ pour un contexte additionnel.

FAQ

Audit est-il adapté aux revues de design ?

Non. La compétence audit réalise des contrôles techniques au niveau du code. Pour des critiques de design, utilisez /frontend-design ou des compétences associées.

Que contient le rapport d'audit ?

Le rapport couvre l'accessibilité, la performance, le theming, le design responsive et les anti-patterns, chacun noté et priorisé selon la gravité.

Audit peut-il corriger automatiquement les problèmes ?

Non. Audit documente les problèmes et propose des plans d'action. Utilisez d'autres compétences ou corrections manuelles pour résoudre les problèmes détectés.

Où trouver les critères de notation ?

Les détails de notation et les checklists se trouvent dans SKILL.md. Ouvrez l'onglet Fichiers pour accéder à l'arborescence complète et aux scripts d'aide.

Quand utiliser audit ?

Utilisez audit avant les lancements, les contrôles de conformité ou dans le cadre de revues régulières de la qualité du code pour garantir que votre frontend respecte les standards techniques.