audit

Überblick

Was ist die audit Skill?

Die audit Skill wurde entwickelt, um Frontend-Entwicklern und Teams dabei zu helfen, die technische Qualität ihres Codebestands systematisch zu bewerten. Sie führt umfassende Prüfungen in fünf Schlüsselbereichen durch: Barrierefreiheit (A11y), Leistung, Theming, responsives Design und Erkennung von Anti-Pattern. Nach dem Scan erstellt sie einen bewerteten Bericht (Schweregrad P0–P3) mit umsetzbaren Empfehlungen, die es erleichtern, Verbesserungen zu priorisieren und zu planen.

Für wen ist audit geeignet?

Diese Skill ist ideal für Frontend-Ingenieure, QA-Spezialisten und Produktteams, die:

• Sicherstellen möchten, dass ihr Code Barrierefreiheits- und Leistungsstandards erfüllt
• Technische Schulden und Anti-Pattern identifizieren wollen
• Sich auf Compliance-Überprüfungen oder technische Audits vorbereiten
• Umsetzbares, priorisiertes Feedback ohne manuelle Code-Reviews erhalten möchten

Probleme, die audit löst

• Erkennt häufige Barrierefreiheitsprobleme (Kontrast, ARIA, Tastaturnavigation, semantisches HTML, Alt-Text, Formularbeschriftung)
• Markiert Leistungsengpässe und ineffiziente Muster
• Hebt Lücken im Theming und responsiven Design hervor
• Deckt Anti-Pattern auf, die Wartbarkeit und Nutzererfahrung beeinträchtigen können

Verwendung

Installationsschritte

1. Fügen Sie die audit Skill zu Ihrem Projekt hinzu:

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

2. Überprüfen Sie die Kerndokumentation:

   • Beginnen Sie mit SKILL.md für einen vollständigen Überblick über den Workflow und die Anforderungen von audit.
   • Sehen Sie sich README.md, AGENTS.md und metadata.json für zusätzlichen Kontext an.
   • Erkunden Sie die Ordner rules/, resources/, references/ und scripts/ für unterstützende Dateien und benutzerdefinierte Prüfungen.

Vorbereitung vor dem Ausführen von audit

• Rufen Sie $frontend-design auf: Dies stellt sicher, dass Designprinzipien und Anti-Pattern berücksichtigt werden. Folgen Sie dem im Handbuch beschriebenen Context Gathering Protocol.
• Falls kein Designkontext vorhanden ist: Führen Sie zuerst $teach-impeccable aus, um eine Basislinie zu erstellen.

Durchführung eines Audits

• Die audit Skill führt einen Code-Level-Scan durch, keine Designkritik. Es wird nur geprüft, was in Ihrer Implementierung messbar und überprüfbar ist.
• Nach dem Lauf erhalten Sie einen detaillierten Bericht mit Schweregraden (P0–P3) und einem priorisierten Maßnahmenplan. Die Skill dokumentiert Probleme, behebt sie aber nicht automatisch.

Wann sollte audit verwendet werden

• Während Code-Reviews oder vor größeren Releases
• Als Teil von CI/CD-Pipelines zur kontinuierlichen Qualitätssicherung
• Bei der Vorbereitung auf Barrierefreiheits- oder Leistungs-Compliance-Prüfungen

FAQ

Was prüft die audit Skill?

Die audit Skill prüft auf Barrierefreiheitsprobleme (wie Kontrast, ARIA, Tastaturnavigation), Leistungsengpässe, Konsistenz im Theming, Fehler im responsiven Design und Code-Anti-Pattern.

Behebt audit Probleme automatisch?

Nein, audit identifiziert und dokumentiert Probleme, liefert einen bewerteten Bericht und umsetzbare Empfehlungen. Korrekturen müssen manuell oder mit anderen Tools vorgenommen werden.

Ist audit für Backend- oder Nicht-Frontend-Projekte geeignet?

Nein, audit konzentriert sich auf Frontend-Codebasen und ist nicht für Backend- oder rein serverseitige Projekte gedacht.

Wo finde ich weitere Details zu den Prüfungen von audit?

Öffnen Sie den Reiter "Files" im Repository, um SKILL.md und unterstützende Ordner mit detaillierten Kriterien, Bewertungsrichtlinien und Referenzen zu erkunden.