audit

Überblick

Was ist die audit Skill?

audit ist ein spezialisiertes Tool zur systematischen technischen Qualitätsprüfung von Frontend-Codebasen. Es konzentriert sich auf fünf zentrale Bereiche: Barrierefreiheit, Performance, Theming, Responsive Design und Anti-Patterns. Die Skill erstellt einen bewerteten Bericht mit Schweregraden (P0–P3) und liefert einen umsetzbaren Plan zur Behebung. Damit ist sie ideal für Teams, die hohe Standards bei Web-Accessibility, Performance-Optimierung und allgemeiner Frontend-Qualität sicherstellen wollen.

Für wen ist audit geeignet?

audit richtet sich an Frontend-Entwickler, UI/UX-Designer und technische Leiter, die die Qualität von Weboberflächen bewerten und dokumentieren müssen. Besonders nützlich ist sie, wenn eine klare, objektive Prüfung von Code-Ebene vor der Behebung oder tiefergehenden Design-Reviews gewünscht ist.

Gelöste Probleme

• Identifiziert Barrierefreiheitslücken (z. B. Kontrast, ARIA, Tastaturnavigation)
• Erkennt Performance-Engpässe
• Prüft Theming-Konsistenz
• Bewertet die Umsetzung von Responsive Design
• Erkennt gängige Frontend-Anti-Patterns

Anwendung

Installationsschritte

1. Installieren Sie die audit Skill:
   Verwenden Sie folgenden Befehl, um die Skill Ihrem Projekt hinzuzufügen:

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

2. Wichtige Dateien prüfen:

   • Beginnen Sie mit SKILL.md für eine vollständige Übersicht und Hinweise zur Nutzung.
   • Schauen Sie in README.md, AGENTS.md und metadata.json für ergänzende Dokumentation.
   • Erkunden Sie die Ordner rules/, resources/, references/ und scripts/ für zusätzlichen Kontext und Hilfsskripte.

Audit durchführen

• Vorbereitung:
  • Rufen Sie zuerst /frontend-design auf, um Design-Kontext zu sammeln und sicherzustellen, dass Anti-Patterns und Prinzipien geladen sind.
  • Falls kein Design-Kontext vorhanden ist, führen Sie /teach-impeccable gemäß der Skill-Dokumentation aus.
• Audit ausführen:
  • Starten Sie die audit Skill mit dem passenden Argument (z. B. Feature-, Seiten- oder Komponentenname).
  • Die Skill scannt die Codebasis und gibt einen JSON-Bericht mit Bewertungen und Schweregraden für jede Dimension aus.
• Nächste Schritte:
  • Nutzen Sie den Bericht, um Prioritäten für Korrekturen zu setzen. Die audit Skill dokumentiert Probleme, behebt sie jedoch nicht automatisch.

Wann audit verwenden

• Vor größeren Releases oder Code-Reviews
• Beim Onboarding neuer Projekte oder Teams
• Als Teil der kontinuierlichen Integration zur Sicherstellung der Frontend-Qualität

FAQ

Was prüft die audit Skill?

Die audit Skill überprüft systematisch Barrierefreiheit, Performance, Theming, Responsive Design und Anti-Patterns im Frontend-Code. Sie liefert einen bewerteten Bericht mit Schweregraden und umsetzbaren Empfehlungen.

Behebt audit Probleme automatisch?

Nein, audit identifiziert und dokumentiert technische Probleme, wendet jedoch keine Korrekturen an. Nutzen Sie den Bericht, um Behebungen mit anderen Tools oder manuell durchzuführen.

Ist audit für Designkritiken geeignet?

Nein, audit konzentriert sich auf messbare, codebasierte Aspekte der Frontend-Qualität. Für Designkritiken sollten ergänzende Skills oder Workflows verwendet werden.

Wo finde ich weitere Details?

Öffnen Sie den Reiter "Files" im Repository, um alle unterstützenden Dokumentationen, einschließlich verschachtelter Referenzen und Hilfsskripte, zu erkunden. Beginnen Sie mit SKILL.md für die wichtigsten Anleitungen.