audit

Überblick

Was ist die Audit-Skill?

Die Audit-Skill richtet sich an Frontend-Entwickler und Teams, die die technische Qualität ihres Codebestands systematisch bewerten möchten. Sie prüft Barrierefreiheit (A11y), Performance, Konsistenz im Theming, responsives Design und häufige Anti-Pattern. Die Skill erstellt einen bewerteten Bericht mit Schweregraden (P0-P3) und umsetzbaren Maßnahmen, die Ihnen helfen, Verbesserungen zu priorisieren und hohe Standards einzuhalten.

Für wen ist Audit geeignet?

• Frontend-Entwickler, die die Codequalität validieren möchten
• QA-Teams mit Fokus auf Barrierefreiheit und Performance
• Projektleiter, die sich auf Compliance oder Launch vorbereiten
• Alle, die ein strukturiertes Code-Level-Audit (kein Design-Review) benötigen

Welche Probleme werden gelöst?

• Erkennung von Barrierefreiheitslücken (Kontrast, ARIA, Tastaturnavigation, semantisches HTML, Alt-Texte, Formulare)
• Aufdeckung von Performance-Engpässen
• Hervorhebung von Theming- und Responsive-Design-Problemen
• Erkennung von Anti-Pattern und technischem Schuldenstand
• Klare Schweregrade und nächste Schritte

Anwendung

Installationsschritte

1. Installieren Sie die Audit-Skill mit:

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

2. Lesen Sie die Datei SKILL.md für detaillierte Anweisungen und Bewertungskriterien.

Vorbereitung

• Vor dem Ausführen von Audit rufen Sie /frontend-design auf, um Designkontext und Anti-Pattern zu erfassen. Falls kein Designkontext vorhanden ist, führen Sie zuerst /teach-impeccable aus.
• Die Audit-Skill konzentriert sich auf messbare technische Aspekte; sie behebt keine Probleme, sondern dokumentiert diese zur Nachverfolgung.

Audit ausführen

• Verwenden Sie die Skill, um Ihren Frontend-Code zu scannen. Sie prüft fünf zentrale Bereiche:
  • Barrierefreiheit (A11y)
  • Performance
  • Theming
  • Responsives Design
  • Anti-Pattern
• Jeder Bereich wird von 0 (kritische Probleme) bis 4 (hervorragende Einhaltung) bewertet.
• Das Ergebnis ist ein umfassender Bericht mit Schweregraden (P0-P3) und umsetzbaren Empfehlungen.

Dateistruktur und Review

• Beginnen Sie mit SKILL.md für Workflow- und Bewertungsdetails.
• Erkunden Sie unterstützende Dateien wie README.md, AGENTS.md, metadata.json sowie Ordner wie rules/, resources/, references/ oder scripts/ für zusätzlichen Kontext.

FAQ

Ist Audit für Design-Reviews geeignet?

Nein. Die Audit-Skill führt technische Prüfungen auf Code-Ebene durch. Für Designkritiken nutzen Sie /frontend-design oder verwandte Skills.

Was beinhaltet der Audit-Bericht?

Der Bericht umfasst Barrierefreiheit, Performance, Theming, responsives Design und Anti-Pattern, jeweils bewertet und nach Schweregrad priorisiert.

Kann Audit Probleme automatisch beheben?

Nein. Audit dokumentiert Probleme und liefert umsetzbare Pläne. Zur Behebung nutzen Sie andere Skills oder manuelle Korrekturen.

Wo finde ich die Bewertungskriterien?

Bewertungsdetails und Checklisten sind in SKILL.md zu finden. Öffnen Sie den Dateien-Tab für die vollständige Dateistruktur und Hilfsskripte.

Wann sollte ich Audit einsetzen?

Nutzen Sie Audit vor Launches, Compliance-Prüfungen oder als Teil regelmäßiger Codequalitäts-Reviews, um sicherzustellen, dass Ihr Frontend technische Standards erfüllt.