name: shikigami-audit-web
description: Audit qualité web d'un site client et de son code source selon le référentiel Opquast V5 (245 règles), avec correspondances accessibilité RGAA 4.1.2 / WCAG 2.2, publié en rapport interactif (Artifact) puis relancé pendant la mission pour suivre les corrections ; peut envoyer le plan d'action dans Jira (via MCP) sous forme de tickets prêts pour le sprint. Déclencher pour : "audit Opquast", "audit qualité web", "audit du site et du code", "audit de début de mission", "état des lieux qualité d'un site client", "relancer / mettre à jour l'audit", "envoyer le plan d'action de l'audit dans Jira", ou quand l'utilisateur colle la commande /shikigami-audit-web refresh copiée depuis le rapport. Pour un audit de conformité RGAA à proprement parler (taux de conformité, déclaration d'accessibilité), utiliser un audit RGAA dédié.
Audit web (Opquast + accessibilité)
Ce skill audite un produit client sur les 245 règles Opquast V5 (plus 3 règles V4 retirées en V5), à partir de deux sources : le site en ligne et le code source du dépôt courant. Il publie un rapport sous forme d'Artifact, puis le met à jour à chaque nouveau passage. Le design du rapport est figé : ne jamais le restyler, seulement remplir ses données.
Fichiers du skill (chemins relatifs à ce SKILL.md) :
references/rules-v5.json: catalogue des règles (id, thème, reformulation FR et EN, où chercher la preuve, correspondances RGAA/WCAG indicatives).references/methode.md: comment vérifier chaque thème, et les pièges connus. À lire avant d'évaluer.references/accessibilite.md: comment traiter les règles liées à l'accessibilité, ce qu'on reprend de la méthode d'audit RGAA, et les limites.references/schema.md: format deconfig.jsonetaudit.json.references/jira.md: envoi facultatif du plan d'action dans Jira (types de tickets, gabarits, contrôle qualité, création via MCP).assets/template.html: la page du rapport. Ne pas la modifier pour un client.scripts/build.py: validation, enregistrement des passages, comparaison, génération. À lancer avecpython3.viewer/: vue animée des sous-agents pendant l'évaluation (voir « Vue en direct des sous-agents » etviewer/README.md).
Les données du client vivent dans son dépôt, dossier .audit-web/ : config.json (identité, logo, URL, périmètre, adresse de l'artifact), audit.json (résultats et historique), report.html (sortie générée, peut être ignorée par git).
B=<dossier de ce skill>/scripts/build.py ; lancer toutes les commandes depuis la racine du dépôt client.
Choisir le mode
.audit-web/audit.jsonn'existe pas → premier audit.- Il existe, ou l'utilisateur parle de relancer / mettre à jour, ou colle
/shikigami-audit-web refresh→ relance.
Premier audit
- Configurer. Déduire ce qui peut l'être du dépôt (nom du produit dans package.json ou le README, URL de production dans la config ou la doc, routes dans le routeur, présence d'une boutique, de comptes, d'une lettre d'information, de PDF…). Poser avec
AskUserQuestionuniquement ce qui ne se déduit pas : nom de la société cliente, nom du produit s'il est ambigu, URL du site, logo (facultatif, avec une variante pour le mode sombre), affichage de l'auditeur en pied de page. Dans le même appel, proposer la vue en direct (voir « Vue en direct des sous-agents ») et la lancer dès la réponse, avant toute autre étape. Écrire.audit-web/config.json(voir le schéma). Copier les logos dans.audit-web/pour garder des chemins relatifs. Langue du rapport :frpar défaut,ensi le client est anglophone. - Échantillon. Choisir les pages auditées : accueil, pages représentatives de chaque gabarit, les parcours clés (formulaire de contact, tunnel, espace personnel), et les pages obligatoires (mentions légales, confidentialité, plan du site, aide, recherche s'ils existent). Signaler à l'utilisateur les pages obligatoires absentes.
python3 $B init-auditcréeaudit.jsonavec toutes les règles en statuttodo.- Évaluer chaque règle selon
references/methode.md. Faire les vérifications du site en ligne (curl, dig, navigateur) une seule fois et réutiliser les résultats. Pour un audit complet, répartir les thèmes entre 3 ou 4 sous-agents (par exemple : 1–2 + 5 + 10 ; 3–4 + 6–7 ; 8–9 + 11 ; 12–14), en leur donnant la méthode,accessibilite.md, la config, la liste des règles et les résultats partagés des tests en ligne. Si la vue en direct tourne, appliquer ses consignes de nommage (voir « Vue en direct des sous-agents »). Chacun renvoie des entrées JSON{id, status, finding, fix, impact?, evidence}. Fusionner dansaudit.json, puis relire soi-même les non-conformités et les partielles : ce sont elles qui portent le rapport. - Règles liées à l'accessibilité (celles qui ont un champ
a11ydans le catalogue) : suivrereferences/accessibilite.md. Renseignerimpact(profil de handicap et situation de blocage) pour chaque non-conformité ou partielle. Si un skill de référence RGAA est installé, s'en servir pour vérifier l'intitulé et les tests d'un critère RGAA avant de le citer dans un constat. - Rédiger
meta.lede(ce qui a été audité : référentiel, pages, dépôt),meta.verdict(4 à 6 phrases simples, lisibles par un non-spécialiste : où en est le site, où sont les écarts, pourquoi tant de N/A, ce que signifie « à vérifier » ici, « Sélectionnez une tuile pour filtrer le registre. ») etmeta.method(comment on a vérifié, ce qui n'a été qu'échantillonné). - Rédiger le plan d'action : regrouper les non-conformités et partielles en 8 à 14 chantiers, chacun avec une criticité (
critical= Bloquant : sécurité, exposition légale ou blocage d'accès pour un profil d'utilisateur ;high= Élevé : comportement cassé ou obligation légale ;medium= Moyen : écart de qualité visible ;low= Faible : finition), un effort (simple,moderate,complex), un titre formulé comme une action, les règles couvertes et 1 à 3 phrases sur quoi faire. python3 $B validate, puispython3 $B snapshot --commit $(git rev-parse HEAD) --branch $(git branch --show-current), puispython3 $B render.- Publier
.audit-web/report.htmlavec l'outil Artifact (nouvel artifact, icônechecklist, description qui nomme le client). Enregistrer l'URL renvoyée dansconfig.json(artifactUrl). - Proposer Jira (facultatif). Demander avec
AskUserQuestionsi l'utilisateur veut ajouter les chantiers du plan d'action à son tableau Jira. Si oui, suivrereferences/jira.md: connexion MCP, configuration, choix du type, rédaction, contrôle qualité, aperçu, accord explicite, création, puisrenderet republication pour afficher les clés Jira dans le rapport. Si non, s'arrêter là.
Relance
-
Proposer la vue en direct dès le début (voir « Vue en direct des sous-agents ») et la lancer avant toute autre étape. Charger
config.jsonetaudit.json. Montrer ce qui a changé dans le code depuis le dernier commit audité :git log --oneline <dernier commit>..HEADetgit diff --stat <dernier commit>..HEAD. Si ce commit est inconnu ou inaccessible, le dire et considérer que tout le code a changé. -
Réévaluer, avec des preuves fraîches (même méthode qu'au premier audit) :
- toutes les règles
fail,partialetcheck; - les règles
passdont les fichiers de preuve ont changé, et toutes celles donthowvautliveoudns(en-têtes, redirections et DNS changent sans commit) ; - un échantillon d'une quinzaine d'autres règles
pass, réparties sur les thèmes ; - les règles
naseulement si le périmètre a changé (le produit a désormais des comptes, une boutique, une lettre d'information, des PDF…). Mettreconfig.scopeà jour le cas échéant.
Si la réévaluation est répartie entre plusieurs sous-agents, procéder comme au premier audit, consignes de nommage comprises.
- toutes les règles
-
Ne jamais changer un statut sans nouvelle preuve. Réécrire
findingpour décrire ce que fait le produit maintenant, viderfixetimpactquand la règle devient conforme, remplacerevidence. Si un statut précédent était simplement faux (et non une évolution du produit), l'ajouter àcorrectionsplutôt que de le présenter comme un progrès. -
Mettre à jour le plan : ajouter des chantiers pour les nouvelles non-conformités, ajuster le texte de ceux dont le reste à faire a changé. Ne pas supprimer de chantier :
snapshotpasse un chantier en « terminé » quand toutes ses règles sont conformes ou N/A, et le rouvre en cas de régression. -
Mettre à jour
meta.verdictpour qu'il décrive l'état actuel. -
python3 $B snapshot --commit … --branch …, puispython3 $B render. Le snapshot affiche la comparaison (corrigées, améliorées, régressions). -
Lire l'artifact à
artifactUrl(Artifactaction: "read"), puis publier.audit-web/report.htmlà cette même adresse. SiartifactUrlmanque, publier un nouvel artifact et enregistrer son URL. -
Résumer à l'utilisateur en quelques lignes : ce qui est corrigé, ce qui régresse, ce qui reste, et le lien.
-
Jira (facultatif). Si
config.jiraexiste ou si des chantiers ont un ticket, proposer la mise à jour Jira décrite dansreferences/jira.md§ 8 (nouveaux tickets, commentaires sur les chantiers terminés, Bug lié en cas de régression). Sinon, proposer l'envoi comme au premier audit. Rien ne part dans Jira sans accord explicite.
Vue en direct des sous-agents
Une page locale montre chaque sous-agent comme un personnage à son bureau : ce qu'il fait, où il va (étagère pour les références, fenêtre pour le site en ligne, imprimante pour ses résultats), sa progression, ses erreurs, et le résultat qu'il rend, reporté sur le tableau blanc. La session principale y apparaît aussi, sous le nom de Kantoku, qui coordonne puis fusionne les copies. Un clic sur un personnage ou sur sa ligne ouvre son détail. Elle lit les transcriptions que Claude Code écrit déjà sur le disque : elle ne coûte aucun jeton et ne change rien à l'audit.
- Quand : au tout début de l'audit ou de la relance, dans le premier appel à
AskUserQuestion(avec les questions de configuration s'il y en a). La page s'ouvre aussitôt sur le bureau vide, Kantoku au tableau blanc ; chaque sous-agent arrive à son bureau quand l'audit le lance. Pas en session cloud (claude.ai/code) : l'utilisateur ne peut pas ouvrirlocalhost. Dans ce cas, ne rien proposer. - Proposer une fois : « Ouvrir la vue en direct des agents ? ». Si non, continuer sans.
- Lancer dès la réponse, depuis la racine du dépôt client, en tâche de fond :
node <dossier de ce skill>/viewer/server.mjs. Lire l'adresse dans la ligneVIEWER_URL=…de sa sortie (elle sort en moins d'une seconde). L'ouvrir dans le navigateur intégré de l'application (preview_startavecurl) ou, en ligne de commande, avecopen <url>. Puis reprendre l'audit sans attendre. - Nommer et briefer les sous-agents pour que la vue soit lisible :
descriptionde l'outil Agent au formatOpquast · <thème>, avec un mot de thème que la vue reconnaît : chaque paire de thèmes a son personnage, toujours le même d'un passage à l'autre. Contenus / Formulaires → Fumi Kaku, Liens / Médias → Tsuna Hikari, Navigation / Présentation → Michi Iro, Sécurité / Serveur / Structure → Mamo Kumo. Nommer les quatre sous-agentsOpquast · Contenus & formulaires,Opquast · Liens & médias,Opquast · Navigation & présentationetOpquast · Sécurité & serveur, suivis du nombre de règles du lot entre parenthèses (Opquast · Navigation & présentation (14)) : la vue en tire la barre de progression. Un thème inconnu ou un cinquième agent reçoit un personnage de réserve.- Leur demander une
descriptionen français de 6 mots au plus sur chaque appel Bash, précédée du numéro de la règle examinée quand l'appel en concerne une (R228 · Vérifie le charset,RV4-25 · Vérifie le lien externe) : c'est le texte affiché pendant qu'ils travaillent, et la vue compte les règles déjà examinées. Leur demander aussi de terminer en donnant le décompte par statut sous la formepass N, partial N, fail N, check N, na N: il remplit le tableau blanc. - Donner soi-même une
descriptionen français aux appels Bash de la session principale pendant l'audit : Kantoku les affiche. - Leur demander d'écrire les fichiers temporaires (pages téléchargées, sorties) uniquement dans le dossier de travail temporaire, jamais dans le dépôt client.
- Arrêt : le serveur s'arrête seul 90 s après la fin du dernier sous-agent. Si l'audit est interrompu, ou s'il se termine sans avoir lancé de sous-agent, arrêter la tâche du serveur.
- Garder le passage (facultatif) : si l'utilisateur veut revoir ou montrer le passage,
node <dossier de ce skill>/viewer/export-replay.mjs --out <fichier>.htmlenregistre un fichier HTML autonome, avec lecture, pause, vitesse et barre de temps.
Rédiger les constats
- Dire ce que fait le produit aujourd'hui, factuellement, puis le correctif. Phrases courtes. Nommer le fichier, l'URL, l'en-tête ou la commande qui le prouve.
- Mettre le code, les en-têtes, les chemins et les sélecteurs entre accents graves : la page les affiche comme du code. Les URL et noms de fichiers courants sont détectés automatiquement.
- Un N/A a toujours une raison en une ligne (« Aucun compte utilisateur. », « Rien n'est vendu : ni panier, ni commande, ni paiement. »). Réutiliser la même phrase pour le bloc e-commerce.
check(« À vérifier ») = la preuve est hors du dépôt et du site (réponse automatique d'une boîte mail, outil d'envoi, entité juridique) ou demande un test humain (lecteur d'écran). Dire précisément quoi vérifier.partial= la règle est respectée à certains endroits et pas à d'autres ; dire où elle ne l'est pas.- Pour une règle liée à l'accessibilité, ajouter
impact: qui est bloqué et comment (« Les personnes aveugles qui utilisent un lecteur d'écran ne savent pas quel champ est en erreur. »). - Parler d'Opquast pour la qualité web en général ; parler de RGAA et de WCAG uniquement pour les règles liées à l'accessibilité, et toujours comme correspondance, jamais comme verdict de conformité RGAA.
- Pas de ton marketing, pas de félicitations. Les reformulations des règles dans le catalogue sont fixes : ne pas les réécrire pour un client.
- Rédiger les constats dans la langue du rapport (
config.lang).
Ce que montre le rapport
Verdict (tuiles qui filtrent le registre, barre de répartition, pourcentage de règles conformes parmi les règles évaluées), un encadré Accessibilité (RGAA / WCAG) (résultat des règles Opquast qui recoupent le RGAA, avec l'avertissement « ce n'est pas un audit RGAA »), Depuis le dernier passage à partir du deuxième passage (corrigées, améliorées, en régression, restent à corriger, avec chaque règle modifiée), le plan d'action avec criticité et effort et une liste « Terminé » repliée, le registre filtrable (thème, filtre accessibilité, statut, « modifiées depuis le dernier passage », références RGAA/WCAG sous chaque règle concernée, mention « avant : … »), le pied de page (référentiel, méthode, avertissement, corrections, historique des passages, auditeur), et un bouton Relancer l'audit qui affiche le dernier passage et la commande /shikigami-audit-web refresh à copier. La page ne peut pas lancer l'audit elle-même : les relances se font toujours ici, dans Claude Code.
Limites à rappeler à l'utilisateur
Ce skill est un assistant IA. Il analyse du code et teste un site, mais ne teste pas avec des technologies d'assistance et ne certifie aucune conformité. Les contrastes et le clavier sont échantillonnés. Pour une conformité RGAA (taux, déclaration d'accessibilité), il faut un audit RGAA complet sur un échantillon de pages, vérifié par un auditeur humain.