Eine Sammlung von KI-Agenten-Kompetenzen bauen, die die Qualität von Websites prüfen

## Das Repository in je eine Kompetenz pro Thema der Web-Qualität aufteilen Behandle die Projektablage als Sammlung eigenständiger Agentenfähigkeiten und nicht als eine einzige, monolithische Anweisungsdatei. Trenne umfassende Prüfungen von gezielten Kompetenzen für Leistung, Barrierefreiheit, Auffindbarkeit, allgemeine Qualität und Kennzahlen des Nutzungserlebnisses, damit ein Agent nur die für seine Aufgabe benötigte Fähigkeit lädt. Bewahre übergreifende Dokumentation, Beitragsregeln, Lizenzangaben und Agentenleitlinien im Wurzelverzeichnis auf. Jedes Kompetenzverzeichnis verwaltet seine Hauptanweisungsdatei, Automatisierungsskripte und ausführlichen Referenzdokumente. Verstecke benutzerbezogene Leitlinien, ausführbare Hilfsprogramme oder Ausgangsmaterial nicht in sachfremden Verzeichnissen. Ermittle vor jeder Änderung einer Kompetenz ihren Aktivierungsvertrag, die ihr zugeordneten Dateien, Abhängigkeiten, den Prüfweg und ihre Beziehung zu anderen Kompetenzen. ## Ordner und Dateien benennen und den Kopfbereich von SKILL.md ausfüllen Statte jede Kompetenz mit einer Datei `SKILL.md` aus, deren gültige YAML-Kopfmetadaten Folgendes enthalten: - einen in kebab-case geschriebenen `name`; - eine einzeilige `description`, die den Einsatzzeitpunkt nennt und realistische Auslöseformulierungen enthält; - erforderliche Lizenzmetadaten; - beständige Angaben zu Urheber und Version, wenn die Projektablage diese nachverfolgt. Wende die genauen Benennungsregeln einheitlich an: - Kompetenzverzeichnisse verwenden kebab-case; - die Hauptanweisungsdatei heißt genau `SKILL.md`; - Skriptdateien verwenden kebab-case und eine passende ausführbare Dateiendung; - Referenzdateien folgen der dokumentierten Großschreibungsregel der Projektablage. Halte das Paket in sich geschlossen und stelle sicher, dass jeder in der Kompetenz genannte Pfad innerhalb der unterstützten Ablagestruktur aufgelöst werden kann. ## SKILL.md unter 500 Zeilen halten und Details in Referenzdateien verschieben Halte die Hauptkompetenz unter 500 Zeilen. Lege Aktivierung, zentralen Arbeitsablauf, wichtige Einschränkungen und Orientierung in `SKILL.md` ab; verschiebe ausführliche Erläuterungen, große Beispiele und Fachmaterial in Referenzdokumente. Schreibe konkrete, ausführbare Leitlinien. Jede Leitlinie soll eine kurze Überschrift, eine direkte Anweisung sowie alle für ihre Anwendung erforderlichen Werte oder Grenzwerte enthalten. Bevorzuge Anweisungen, die erklären, was zu prüfen ist, welche Entscheidung zu treffen ist und welcher Nachweis den Abschluss belegt. Nutze Skripte für determinierte oder wiederkehrende Arbeiten, wenn deren Ausgabe andernfalls den verfügbaren Verarbeitungskontext beanspruchen würde. Wiederhole dasselbe Verfahren nicht in der Hauptkompetenz und mehreren Referenzdokumenten. ## Code vorher und nachher sowie Tabellen mit guten und schlechten Grenzwerten zeigen Zeige immer das fehlerhafte und das korrigierte Muster, wenn eine Leitlinie ausführbares Verhalten regelt. Halte Beispiele klein genug, damit sie für sich verständlich sind, und überprüfe, dass sie tatsächlich funktionieren. Eine Leitlinie zur Bildstabilität sollte beispielsweise ein unzureichend beschriebenes Bild einem Bild gegenüberstellen, das Abmessungen und nützliche Lademetadaten festlegt: Problem: ein Bildelement nur mit `src="hero.jpg"`. Verbesserung: dasselbe Element mit `width="1200"`, `height="600"`, `alt="Hero image"` und `loading="lazy"`. Stelle vergleichbare Qualitätsgrenzwerte in einer Tabelle mit ausdrücklich benannten guten, mittleren und schlechten Bereichen dar. Nenne Einheit und Grenzoperatoren, damit Lesende nicht erschließen müssen, ob ein Grenzwert eingeschlossen ist. ## Shell-Skripte schreiben, die bei Fehlern stoppen und JSON ausgeben Hilfsprogramme für die Befehlszeile müssen beim ersten Fehler abbrechen, maschinenlesbar sein und sich sicher aufräumen lassen: - gib mit einer Interpreterzeile die vorgesehene Befehlsumgebung an; - aktiviere ein Abbrechen beim ersten Fehler, etwa mit `set -e`; - sende Fortschritts- und Zustandsmeldungen an die Standardfehlerausgabe; - sende maschinenlesbare Ergebnisse wie JSON an die Standardausgabe; - erstelle temporäre Dateien sicher und registriere Aufräumbehandlungen; - halte sie in sich geschlossen oder dokumentiere jede externe Abhängigkeit und Voraussetzung. Halte menschenlesbare Diagnosemeldungen vom maschinenlesbaren Datenstrom getrennt. Prüfe Erfolg, Fehler, fehlerhafte Eingaben und Aufräumverhalten, bevor du ein Hilfsprogramm als wiederverwendbare Automatisierung behandelst. ## Jede Referenzdatei auf ein Thema begrenzen und aus der Kompetenz verlinken Beschränke jedes Referenzdokument auf ein Thema, ergänze praxisnahe Beispiele und verweise auf maßgebliches Material. Halte einzelne Referenzdokumente nach Möglichkeit unter 200 Zeilen, damit ein Agent sie unabhängig laden kann, ohne sachfremden Kontext einzubeziehen. Verknüpfe jedes Referenzdokument aus der Hauptkompetenz oder einem gepflegten Verzeichnis. Entferne veraltete Verweise und doppelte Leitlinien, und überlasse die Pflege veränderlicher Fakten der nächstgelegenen maßgeblichen Quelle. Nutze Referenzdokumente zur Vertiefung und nicht als unsortierte Ablage. Ein Referenzdokument soll dem Agenten helfen, eine klar abgegrenzte Entscheidung zu treffen oder umzusetzen. ## Vor der Veröffentlichung Kopfbereich, Beispiele, Links und Skripte prüfen Führe vor dem Einreichen oder Veröffentlichen einer Kompetenz Folgendes aus: 1. Parse und validiere die YAML-Kopfmetadaten. 2. Bestätige, dass die Beschreibung brauchbare Auslöseformulierungen enthält. 3. Führe jedes ausführbare Beispiel aus oder überprüfe es auf andere Weise. 4. Bestätige, dass jede referenzierte Datei vorhanden ist und jeder interne Verweis aufgelöst wird. 5. Führe Skripte über ihre dokumentierte Schnittstelle aus und prüfe das Verhalten der Ausgabekanäle. 6. Prüfe das Paket anhand der maßgeblichen Spezifikation für Agentenkompetenzen. Eine erfolgreiche Syntaxprüfung ist notwendig, aber nicht hinreichend. Aktivierungsbeschreibung, Beispiele, Referenzdokumente und Skripte müssen mit dem von der Kompetenz zugesagten Verhalten übereinstimmen. ## Probleme von kritisch bis niedrig ordnen und Ratschläge unabhängig von Frameworks halten Ordne Feststellungen einheitlich: 1. **Kritisch:** Sicherheitslücken oder vollständiger Funktionsausfall. 2. **Hoch:** schwere Leistungsfehler oder erhebliche Barrieren bei der Zugänglichkeit. 3. **Mittel:** bedeutsame Verbesserungsmöglichkeiten bei Leistung, Auffindbarkeit oder Suchqualität. 4. **Niedrig:** Programmierstil und kleinere Verbesserungsmöglichkeiten. Halte Leitlinien für Internetanwendungen unabhängig von bestimmten Programmiergerüsten. Zeige zuerst standardkonformes HTML, CSS und JavaScript, führe Hinweise zu einzelnen Programmiergerüsten in getrennten Abschnitten auf und bevorzuge die Standardschnittstellen der Plattform, sofern eine Abhängigkeit von einem Programmiergerüst für die Aufgabe nicht unerlässlich ist. Prüfe die folgenschwersten Korrektheitsprobleme und Zugangsbarrieren, bevor du Aufwand in stilistische Verbesserungen investierst. ## Eine Kompetenz aktualisieren, ohne ihre Auslösephrasen unwirksam zu machen Bewahre beim Aktualisieren von Kompetenzbeschreibungen die Abwärtskompatibilität und halte bestehende Auslöseformulierungen funktionsfähig. Aktualisiere die Versionsmetadaten zusammen mit der Umsetzung und dokumentiere inkompatible Änderungen im vorgeschriebenen Änderungsnachweis oder in der Änderungsbeschreibung. Wenn sich die Struktur ändert, aktualisiere Hauptkompetenz, betroffene Referenzdokumente, Skripte, Beispiele und Verweise gemeinsam. Prüfe den abschließenden Änderungsvergleich auf unbeabsichtigte Ausweitung des Umfangs, veraltetes erzeugtes Material und doppelte Anweisungen. Führe die gezielte Prüfliste nach jeder Verhaltensänderung erneut aus. Behaupte nicht, eine aktualisierte Kompetenz sei einsatzbereit, solange ihr Aktivierungsweg, ihre Beispiele oder referenzierten Materialien ungeprüft sind.