Web-Audit (Opquast + Barrierefreiheit)
Dieses Skill auditiert ein Client-Produkt anhand der 245 Opquast V5-Regeln (plus 3 in V5 entfernte V4-Regeln) aus zwei Quellen: der Live-Website und dem Quellcode des aktuellen Repositorys. Es veröffentlicht den Bericht als Artifact und aktualisiert ihn bei jedem neuen Durchlauf. Das Design des Berichts ist festgelegt: Niemals umgestalten, nur die Daten befüllen.
Skill-Dateien (relativ zu dieser SKILL.md):
references/rules-v5.json: Katalog der Regeln (ID, Thema, deutsche und englische Umformulierung, Prüfquelle, RGAA/WCAG-Korrespondenzen, indikativ).references/methode.md: Wie jedes Thema zu prüfen ist, und bekannte Fallstricke. Vor der Bewertung lesen.references/accessibilite.md: Wie barrierefreiheitsbezogene Regeln behandelt werden, was aus der RGAA-Auditmethode übernommen wird, und Grenzen.references/schema.md: Format vonconfig.jsonundaudit.json.references/jira.md: Optionale Übermittlung des Aktionsplans an Jira (Tickettypen, Vorlagen, Qualitätskontrolle, Erstellung via MCP).assets/template.html: Die Berichtsseite. Nicht für einen Client ändern.scripts/build.py: Validierung, Aufzeichnung von Durchläufen, Vergleich, Generierung. Mitpython3ausführen.viewer/: Animierte Ansicht der Unteragenten während der Bewertung (siehe „Live-Ansicht der Unteragenten" undviewer/README.md).
Die Client-Daten befinden sich im Repository im Ordner .audit-web/: config.json (Identität, Logo, URL, Umfang, Artifact-URL), audit.json (Ergebnisse und Verlauf), report.html (generierte Ausgabe, kann von git ignoriert werden).
B=<Skill-Ordner>/scripts/build.py; Alle Befehle vom Stammverzeichnis des Client-Repositorys ausführen.
Modus auswählen
.audit-web/audit.jsonexistiert nicht → Erstaudit.- Es existiert, oder der Benutzer spricht von erneuter Durchführung / Aktualisierung, oder fügt
/shikigami-audit-web refreshein → Wiederholung.
Erstaudit
- Konfigurieren. Ableiten, was aus dem Repository erschlossen werden kann (Produktname aus package.json oder README, Produktions-URL aus Konfiguration oder Dokumentation, Routen aus dem Router, Vorhandensein eines Shops, Konten, Newsletters, PDFs…). Mit
AskUserQuestionnur das erfragen, was sich nicht ableiten lässt: Name des Client-Unternehmens, Produktname falls mehrdeutig, URL der Website, Logo (optional, mit einer Variante für den Dark Mode), Anzeige des Prüfers in der Fußzeile. Im selben Aufruf die Live-Ansicht anbieten (siehe „Live-Ansicht der Unteragenten") und diese sofort nach der Antwort starten, vor jedem anderen Schritt..audit-web/config.jsonschreiben (siehe Schema). Die Logos in.audit-web/kopieren, um relative Pfade zu erhalten. Berichtssprache:frstandardmäßig,enfalls der Client englischsprachig ist. - Stichprobe. Die zu auditierten Seiten auswählen: Startseite, repräsentative Seiten jeder Vorlage, Schlüsselflüsse (Kontaktformular, Checkout, persönlicher Bereich) und Pflichtseiten (Impressum, Datenschutz, Sitemap, Hilfe, Suche, falls vorhanden). Den Benutzer auf fehlende Pflichtseiten hinweisen.
python3 $B init-auditerstelltaudit.jsonmit allen Regeln im Statustodo.- Jede Regel bewerten gemäß
references/methode.md. Die Prüfungen der Live-Website (curl, dig, Browser) nur einmal durchführen und die Ergebnisse wiederverwenden. Für ein vollständiges Audit die Themen auf 3 oder 4 Unteragenten verteilen (z. B.: 1–2 + 5 + 10; 3–4 + 6–7; 8–9 + 11; 12–14) und ihnen die Methode,accessibilite.md, die Konfiguration, die Regelliste und die gemeinsamen Testergebnisse der Live-Website geben. Falls die Live-Ansicht läuft, deren Namenskonventionen anwenden (siehe „Live-Ansicht der Unteragenten"). Jeder gibt JSON-Einträge zurück:{id, status, finding, fix, impact?, evidence}. Inaudit.jsonzusammenführen, dann selbst die Nichtkonformitäten und Teilkonformitäten durchlesen: Sie tragen den Bericht. - Barrierefreiheitsbezogene Regeln (diejenigen mit einem Feld
a11yim Katalog):references/accessibilite.mdfolgen.impact(Behinderungsprofil und Blockierungssituation) für jede Nichtkonformität oder Teilkonformität angeben. Falls ein RGAA-Referenzskill installiert ist, diesen verwenden, um die Bezeichnung und Tests eines RGAA-Kriteriums zu überprüfen, bevor es in einem Befund zitiert wird. meta.ledeverfassen (was auditiert wurde: Referenz, Seiten, Repository),meta.verdict(4 bis 6 einfache Sätze, auch für Laien verständlich: Stand der Website, Abweichungen, Grund für viele N/A, was „zu prüfen" hier bedeutet, „Wählen Sie eine Kachel, um das Register zu filtern.") undmeta.method(wie geprüft wurde, was nur stichprobenartig geprüft wurde).- Den Aktionsplan verfassen: Die Nichtkonformitäten und Teilkonformitäten in 8 bis 14 Arbeitspakete gruppieren, jeweils mit einer Kritikalität (
critical= Blockierend: Sicherheit, rechtliche Offenlegung oder Zugangsbehinderung für ein Benutzerprofil;high= Hoch: defektes Verhalten oder gesetzliche Verpflichtung;medium= Mittel: sichtbarer Qualitätsmangel;low= Niedrig: Nacharbeit), einem Aufwand (simple,moderate,complex), einem als Aktion formulierten Titel, den abgedeckten Regeln und 1 bis 3 Sätzen zur Umsetzung. python3 $B validate, dannpython3 $B snapshot --commit $(git rev-parse HEAD) --branch $(git branch --show-current), dannpython3 $B render..audit-web/report.htmlmit dem Artifact-Tool veröffentlichen (neues Artifact, Iconchecklist, Beschreibung mit Client-Namen). Die zurückgegebene URL inconfig.jsonspeichern (artifactUrl).- Jira anbieten (optional). Mit
AskUserQuestionden Benutzer fragen, ob die Arbeitspakete des Aktionsplans zum Jira-Board hinzugefügt werden sollen. Falls ja,references/jira.mdfolgen: MCP-Verbindung, Konfiguration, Typauswahl, Verfassen, Qualitätskontrolle, Vorschau, ausdrückliche Zustimmung, Erstellung, dannrenderund erneute Veröffentlichung, um die Jira-Schlüssel im Bericht anzuzeigen. Falls nein, hier enden.
Wiederholung
-
Die Live-Ansicht gleich zu Beginn anbieten (siehe „Live-Ansicht der Unteragenten") und vor jedem anderen Schritt starten.
config.jsonundaudit.jsonladen. Anzeigen, was sich seit dem letzten auditierten Commit im Code geändert hat:git log --oneline <letzter Commit>..HEADundgit diff --stat <letzter Commit>..HEAD. Falls dieser Commit unbekannt oder nicht erreichbar ist, dies mitteilen und annehmen, dass der gesamte Code geändert wurde. -
Neu bewerten, mit aktuellen Nachweisen (gleiche Methode wie beim Erstaudit):
- alle Regeln mit
fail,partialundcheck; - Regeln mit
pass, deren Nachweisdateien sich geändert haben, und alle, derenhowliveoderdnsist (Header, Weiterleitungen und DNS ändern sich ohne Commit); - eine Stichprobe von etwa fünfzehn anderen
pass-Regeln, verteilt auf die Themen; na-Regeln nur, wenn sich der Umfang geändert hat (das Produkt hat nun Konten, einen Shop, einen Newsletter, PDFs…).config.scopegegebenenfalls aktualisieren.
Falls die Neubewertung auf mehrere Unteragenten verteilt wird, wie beim Erstaudit vorgehen, einschließlich der Namenskonventionen.
- alle Regeln mit
-
Niemals einen Status ohne neuen Nachweis ändern.
findingneu schreiben, um den aktuellen Produktzustand zu beschreiben,fixundimpactleeren, wenn die Regel konform wird,evidenceersetzen. Falls ein vorheriger Status schlicht falsch war (und nicht auf eine Produktänderung zurückgeht), dies zucorrectionshinzufügen, anstatt es als Fortschritt darzustellen. -
Den Plan aktualisieren: Arbeitspakete für neue Nichtkonformitäten hinzufügen, Text derjenigen anpassen, deren verbleibende Arbeit sich geändert hat. Kein Arbeitspaket löschen:
snapshotsetzt ein Arbeitspaket auf „erledigt", wenn alle seine Regeln konform oder N/A sind, und öffnet es bei Regressionen wieder. -
meta.verdictaktualisieren, sodass es den aktuellen Stand beschreibt. -
python3 $B snapshot --commit … --branch …, dannpython3 $B render. Der Snapshot zeigt den Vergleich (korrigiert, verbessert, Regressionen). -
Das Artifact unter
artifactUrllesen (Artifactaction: "read"), dann.audit-web/report.htmlunter derselben Adresse veröffentlichen. FallsartifactUrlfehlt, ein neues Artifact veröffentlichen und dessen URL speichern. -
Dem Benutzer in wenigen Zeilen zusammenfassen: was korrigiert wurde, was regrediert, was noch offen ist, und der Link.
-
Jira (optional). Falls
config.jiraexistiert oder Arbeitspakete ein Ticket haben, das inreferences/jira.md§ 8 beschriebene Jira-Update vorschlagen (neue Tickets, Kommentare zu erledigten Arbeitspaketen, verknüpfter Bug bei Regression). Sonst die Übermittlung wie beim Erstaudit anbieten. Ohne ausdrückliche Zustimmung geht nichts an Jira.
Live-Ansicht der Unteragenten
Eine lokale Seite zeigt jeden Unteragenten als Figur an seinem Schreibtisch: was er tut, wohin er geht (Regal für Referenzen, Fenster für die Live-Website, Drucker für seine Ergebnisse), seinen Fortschritt, seine Fehler und das von ihm gelieferte Ergebnis, auf dem Whiteboard festgehalten. Die Hauptsitzung erscheint ebenfalls unter dem Namen Kantoku, der koordiniert und dann die Kopien zusammenführt. Ein Klick auf eine Figur oder auf ihre Zeile öffnet deren Detail. Sie liest die Transkripte, die Claude Code bereits auf die Festplatte schreibt: Sie kostet keine Tokens und ändert nichts am Audit.
- Wann: ganz zu Beginn des Audits oder der Wiederholung, im ersten Aufruf von
AskUserQuestion(zusammen mit den Konfigurationsfragen, falls vorhanden). Die Seite öffnet sich sofort auf dem leeren Schreibtisch, Kantoku am Whiteboard; jeder Unteragent erscheint an seinem Schreibtisch, wenn das Audit ihn startet. Nicht in der Cloud-Sitzung (claude.ai/code): Der Benutzer kannlocalhostnicht öffnen. In diesem Fall nichts anbieten. - Einmal vorschlagen: „Live-Ansicht der Agenten öffnen?". Bei Ablehnung ohne fortsetzen.
- Starten sofort nach der Antwort, vom Stammverzeichnis des Client-Repositorys, im Hintergrund:
node <Skill-Ordner>/viewer/server.mjs. Die Adresse aus der ZeileVIEWER_URL=…der Ausgabe lesen (sie erscheint in unter einer Sekunde). Im integrierten Browser der Anwendung öffnen (preview_startmiturl) oder in der Befehlszeile mitopen <url>. Dann das Audit ohne Warten fortsetzen. - Unteragenten benennen und einweisen, damit die Ansicht lesbar ist:
descriptiondes Agent-Tools im FormatOpquast · <Thema>, mit einem Themenschlüsselwort, das die Ansicht erkennt: Jedes Themenpaar hat seine Figur, die von Durchlauf zu Durchlauf gleich bleibt. Inhalte / Formulare → Fumi Kaku, Links / Medien → Tsuna Hikari, Navigation / Präsentation → Michi Iro, Sicherheit / Server / Struktur → Mamo Kumo. Die vier Unteragenten benennen:Opquast · Inhalte & Formulare,Opquast · Links & Medien,Opquast · Navigation & PräsentationundOpquast · Sicherheit & Server, gefolgt von der Anzahl der Regeln des Pakets in Klammern (Opquast · Navigation & Präsentation (14)): Die Ansicht leitet daraus den Fortschrittsbalken ab. Ein unbekanntes Thema oder ein fünfter Agent erhält eine Reservefigur.- Von ihnen eine
descriptionauf Deutsch mit höchstens 6 Wörtern bei jedem Bash-Aufruf verlangen, vorangestellt mit der Nummer der geprüften Regel, wenn der Aufruf eine betrifft (R228 · Prüft den Zeichensatz,RV4-25 · Prüft den externen Link): Dies ist der Text, der während ihrer Arbeit angezeigt wird, und die Ansicht zählt die bereits geprüften Regeln. Sie auch bitten, mit einer Aufschlüsselung nach Status in der Formpass N, partial N, fail N, check N, na Nzu enden: Sie füllt das Whiteboard. - Sich selbst eine
descriptionauf Deutsch für die Bash-Aufrufe der Hauptsitzung während des Audits geben: Kantoku zeigt sie an. - Sie bitten, temporäre Dateien (heruntergeladene Seiten, Ausgaben) ausschließlich im temporären Arbeitsverzeichnis zu speichern, niemals im Client-Repository.
- Beenden: Der Server beendet sich von selbst 90 s nach dem Ende des letzten Unteragenten. Wird das Audit unterbrochen oder endet es, ohne dass ein Unteragent gestartet wurde, den Server-Task beenden.
- Durchlauf speichern (optional): Falls der Benutzer den Durchlauf erneut ansehen oder zeigen möchte, speichert
node <Skill-Ordner>/viewer/export-replay.mjs --out <Datei>.htmleine eigenständige HTML-Datei mit Wiedergabe, Pause, Geschwindigkeit und Zeitleiste.
Befunde verfassen
- Sachlich beschreiben, was das Produkt heute tut, dann die Korrektur. Kurze Sätze. Dateiname, URL, Header oder Befehl nennen, der den Nachweis erbringt.
- Code, Header, Pfade und Selektoren in Backticks setzen: Die Seite zeigt sie als Code an. URLs und gängige Dateinamen werden automatisch erkannt.
- Ein N/A hat immer einen Grund in einem Satz („Kein Benutzerkonto.", „Es wird nichts verkauft: kein Warenkorb, keine Bestellung, keine Zahlung."). Denselben Satz für den E-Commerce-Block wiederverwenden.
check(„Zu prüfen") = Der Nachweis liegt außerhalb des Repositorys und der Website (automatische Antwort eines E-Mail-Postfachs, Versandtool, juristische Person) oder erfordert einen menschlichen Test (Screenreader). Genau angeben, was zu prüfen ist.partial= Die Regel wird an manchen Stellen eingehalten, an anderen nicht; angeben, wo sie nicht eingehalten wird.- Bei einer barrierefreiheitsbezogenen Regel
impacthinzufügen: Wer blockiert wird und wie („Blinde, die einen Screenreader verwenden, …").