Überprüfung der statischen Website
Ziel
Validieren Sie ein statisches Website-Output, bevor der Benutzer es weiter bearbeitet, veröffentlicht oder als fertig betrachtet.
Dieser Skill ist ein Qualitätsgate für generierte HTML/CSS/JS-Websites. Er wählt kein Theme aus, erstellt keine Referenz neu, migriert keine Inhalte und stellt die Website nicht bereit. Er stellt sicher, dass der generierte Ordner sich wie eine echte statische Website verhält.
Kernprüfungen:
- Quelldateien sind gültiges UTF-8 und menschenlesbar.
- Lokale Links, Skripte, Stylesheets, Bilder und andere Assets sind auflösbar.
- Seitenlokale Links und Assets verwenden standardmäßig seitenrelative Pfade, keine root-absoluten Pfade wie
/assets/style.css. - Die Ausgabe kann direkt von
index.htmlaus zur manuellen Vorschau geöffnet werden, es sei denn, der Benutzer hat explizit Server-Only-Verhalten akzeptiert. - Die generierten Seiten decken die erwarteten Seitentypen ab.
- Die Website wird in einem echten Browser über lokales HTTP gerendert.
- Desktop- und Mobile-Layouts sind nutzbar.
- Konsolenfehler, defekte Interaktionen, zurückgebliebene Platzhalter und kopierte quellspezifische Texte werden gemeldet oder behoben.
Vertrag
Eingaben:
- Statisches Site-Root wie
site/,dist/,out/,public/,docs/oder Repository-Root. - Optionaler erwarteter Seitenumfang, lokale Vorschau-URL,
EDITING.md, Referenz-URL/Screenshot und verbotene quellspezifische Zeichenfolgen.
Ausgaben:
- Ergebnisse geordnet nach Schweregrad oder Korrekturen, wenn die Validierung Teil einer Build-/Fix-Aufgabe ist.
- Statische Audit-Ergebnisse, überprüfte Browser-Seiten/Viewports und geänderte Dateien (falls vorhanden).
- Klarer Bestanden/Nicht bestanden-Status für die Bereitschaft zur Veröffentlichung oder Übergabe.
Grenzen:
- Keine Auswahl von Themes, keine Neuerstellung von Websites, keine Migration von Inhalten, keine Personalisierung der Identität und keine Bereitstellung.
- Kein Redesign der Website während der Validierung, es sei denn, ein visuelles Problem blockiert die Nutzbarkeit und der Benutzer hat um Korrekturen gebeten.
- Keine Genehmigung von root-absoluten seitenlokalen Pfaden, es sei denn,
--allow-root-absolutewird absichtlich verwendet und die Einschränkung wird angegeben.
Erfolgsgate:
- Kein Blocker mehr vorhanden: defekte primäre Navigation, fehlender erforderlicher Seitentyp, unlesbare Quellkodierung, fehlgeschlagenes lokales Asset, Konsolenabsturz, nicht nutzbares Mobilgerät oder versehentliches Problem mit root-absolutem Pfad.
- Warnungen werden entweder behoben, dokumentiert oder vom Benutzer akzeptiert.
Wenn das Gate fehlschlägt:
- Beheben Sie einfache lokale Probleme, wenn die Validierung Teil des Builds ist.
- Leiten Sie größere Fehler an
make-personal-site,copy-website-style,personalize-site,add-blog-postsoderedit-site-partweiter, je nach fehlgeschlagenem Bereich. - Führen Sie das deterministische Audit und die betroffenen Browser-Prüfungen erneut durch.
Verwendung mit
Verwenden Sie diesen Skill nach:
make-personal-siteeine originelle statische persönliche Website erstellt oder neu gestaltet hat.copy-website-styleden Stil einer Zielwebsite als statische Dateien neu erstellt hat.- Ein Benutzer auf einen vorhandenen statischen Ausgabeordner verweist und fragt, ob dieser gut genug ist.
- Ein Benutzer bittet, eine statische Website vor der Veröffentlichung zu überprüfen, zu validieren, zu testen, zu auditieren oder zu inspizieren.
Wenn der Benutzer ein Framework-Quellprojekt angibt, validieren Sie nach Möglichkeit den bereits erstellten statischen Ausgabeordner. Führen Sie hier keinen Framework-Build-Workflow ein, es sei denn, der Benutzer bittet ausdrücklich darum.
Eingaben
Verwenden Sie alle verfügbaren Eingaben:
- Statischer Site-Root-Ordner, wie
site/,dist/,out/oderpublic/. - Lokale Vorschau-URL, falls bereits ein Server läuft.
- Erwarteter Seitenumfang: nur Startseite, vollständige persönliche Website, Blog, Portfolio, Notizen, Links, Stil-Neuerstellung usw.
EDITING.md, Seitenübersicht oder andere von einem anderen Skill erstellte Übergabehinweise.- Referenz-URL oder Screenshot bei der Validierung einer Stil-Neuerstellung.
- Bekannte Zeichenfolgen, die nicht verbleiben dürfen, wie ursprüngliche Autorennamen, Domains, E-Mails, Analyse-IDs oder alter Platzhaltertext.
Wenn das Site-Root unklar ist, überprüfen Sie nahegelegene Ordner und wählen Sie denjenigen, der index.html und statische Assets enthält.
Workflow
- Identifizieren Sie das statische Site-Root und den erwarteten Seitenumfang.
- Lesen Sie
EDITING.mdoder leiten Sie die Seitenübersicht aus HTML-Dateien und Navigationslinks ab. - Führen Sie das deterministische Datei-Audit-Skript aus.
- Starten oder verwenden Sie einen lokalen HTTP-Server für das statische Root.
- Validieren Sie die Website in einem echten Browser bei Desktop- und Mobilbreiten.
- Öffnen Sie mindestens eine repräsentative Seite für jeden generierten Seitentyp.
- Testen Sie Kerninteraktionen wie Navigation, Theme-Umschaltung, Suche/Filter, Kopier-Buttons, Mobilmenü und Paginierung.
- Überprüfen Sie Browser-Konsolenfehler und fehlende Netzwerkressourcen.
- Auditieren Sie relative Pfadkompatibilität, Platzhalter, UTF-8-Lesbarkeit und quellspezifische zurückgebliebene Texte.
- Beheben Sie einfache Defekte, wenn der Benutzer die Validierung als Teil eines Builds angefordert hat; melden Sie andernfalls zuerst die Ergebnisse.
Deterministisches Datei-Audit
Verwenden Sie das gebündelte Skript vor der Browser-Validierung:
python scripts/static_site_check.py <site-root>
Für Stil-Neuerstellungen oder Bereinigungen kopierter Websites übergeben Sie verbotene quellspezifische Zeichenfolgen:
python scripts/static_site_check.py <site-root> --forbid "original-author" --forbid "original-domain.com"
Das Skript überprüft:
- UTF-8-Dekodierung für HTML-, CSS-, JS-, JSON-, Markdown-, SVG-, XML- und Textdateien.
- Verdächtiges Mojibake und Ersatzzeichen.
- Fehlendes
<meta charset="utf-8">in HTML-Dateien. - Defekte lokale
href-,src-,srcset-,poster-,action- unddata-src-Referenzen. - Root-absolute seitenlokale Referenzen wie
/assets/...,/posts/...,/data/...oder/images/..., sofern nicht explizit erlaubt. - CSS
url(...)-Asset-Referenzen, einschließlich fehlender oder root-absoluter lokaler URLs. - Häufige root-absolute seitenlokale Zeichenfolgen in HTML, JavaScript und JSON-Daten.
- Links, die das Site-Root verlassen.
- Häufige Platzhalterzeichenfolgen.
- Mit
--forbidübergebene verbotene Zeichenfolgen. - Datenschutzsensitive Deploy-Root-Dateien wie
.env, private Schlüssel, Credential-Dateien und lokale Service-Account-Artefakte. - Secret-ähnliche Zuweisungen, bekannte Token-Muster, private Schlüsselblöcke und lokale absolute Dateisystempfade im Quelltext.
- Temporäre, Log-, Backup- und OS-Artefakte, die nicht veröffentlicht werden sollten.
- HTML-Seitenanzahl und abgeleitete Seitentypen.
- Ob
EDITING.mdexistiert.
Das Datei-Audit sollte dennoch die UTF-8-Lesbarkeit für Vendor-Dateien überprüfen, aber Platzhalter-ähnliche Wörter in minifizierten Drittanbieter-Vendor-Bundles nicht als Platzhalterinhalt der Website behandeln.
Behandeln Sie Skriptfehler als Blocker, es sei denn, der Benutzer wollte nur eine schnelle explorative Überprüfung. Behandeln Sie Warnungen als manuell zu inspizierende Elemente.
Wenn die Website absichtlich so gestaltet ist, dass sie root-relative Pfade unter einem benutzerdefinierten Domain-Root erfordert, führen Sie das Skript mit --allow-root-absolute aus und geben Sie an, dass das direkte Öffnen von file:// und die Bereitstellung unter einem GitHub-Projekt-Unterpfad nicht garantiert sind. Verwenden Sie diese Ausnahme nicht für generierte einfache statische persönliche Websites, es sei denn, der Benutzer akzeptiert diesen Kompromiss explizit.
Pfadkompatibilität
Generierte einfache statische Websites sollten in drei gängigen Kontexten funktionieren:
- Direktes Öffnen von
index.htmlaus dem Dateisystem für eine schnelle manuelle Vorschau. - Bereitstellung des Ordners über lokales HTTP für Browser-Automatisierung und Konsolen-/Netzwerkprüfungen.
- Bereitstellung auf einem statischen Host, der die Website von einem Domain-Root oder einem Unterpfad bereitstellen kann.
Standardregel:
- Verwenden Sie seitenrelative Pfade für seitenlokale Links und Assets.
- Verwenden Sie von Stammseiten aus
assets/style.css,posts/example.htmlundabout.html. - Verwenden Sie von verschachtelten Seiten aus
../assets/style.css,../blog.htmlund geschwister-relative Links nach Bedarf. - Verwenden Sie standardmäßig nicht
/assets/style.css,/posts/example.html,/data/posts.json,/images/foo.pngoder/für die interne Navigation.
Überprüfen Sie auch JavaScript-generierte Links, Suchergebnisse, Tag-Filter, Kopier-Buttons, dynamische Karten, RSS/Sitemap-Referenzen, Bild-Cover, CSS url(...)-Werte, Favicons, Schriftarten und KaTeX/Math-Vendor-Assets. Es reicht nicht, wenn statische HTML-Attribute relativ sind, wenn JavaScript später root-absolute Pfade einfügt.
Root-absolute Pfade sind nur akzeptabel, wenn der Benutzer explizit eine reine Server-Root-Bereitstellung wünscht, z. B. einen benutzerdefinierten Domain-Root, und versteht, dass das direkte Öffnen von Dateien und GitHub-Projekt-Seiten-Unterpfade möglicherweise brechen.
Browser-Validierung
Verwenden Sie einen echten Browser vor der endgültigen Auslieferung. Stellen Sie lokale Dateien über HTTP bereit, nicht über file://:
python -m http.server 8000
Öffnen Sie dann:
http://127.0.0.1:8000/
Verwenden Sie ein tatsächlich verfügbares interaktives Browser-Tool als erstes Validierungsmittel für lokale HTTP-Ziele. "Verfügbar" bedeutet, dass das Tool in der aktuellen Runde in der aufrufbaren Tool-Liste verfügbar ist, nicht nur in einem Skill, einer Plugin-Liste oder einer Systembeschreibung erwähnt wird. In Codex kann dies das Browser-/In-App-Browser-Plugin sein, wenn der Benutzer oder Client es in die Runde geleitet hat; in anderen Agenten kann es ein gleichwertiger sichtbarer Browser, ein Browser-Use-Tool oder ein Devtools-gestützter Browser sein. Es sollte die lokale URL öffnen, Desktop-/Mobil-Viewports inspizieren, Interaktionen ausführen und sichtbare Konsolen-/Netzwerkprobleme überprüfen.
Wenn in der aktuellen Runde kein interaktives Browser-Tool verfügbar ist, tun Sie nicht so, als ob der Browser-Test stattgefunden hätte. Wenn die Validierung davon abhängt, bitten Sie den Benutzer, das Browser-Tool mit der Routing-Methode seines Clients zu aktivieren oder aufzurufen; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Benutzer nicht umleitet oder der Client kein solches Tool hat, greifen Sie auf Playwright, Screenshots, statische Audits oder Shell-Prüfungen zurück und geben Sie an, dass dies ein Fallback war, keine vollständige interaktive Browser-Validierung.
Verwenden Sie nicht standardmäßig Playwright, Headless-Only-Screenshot-Skripte, Shell-geöffnete Browser-Fenster oder statische Screenshot-Generierung, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Screenshots sind nützliche Beweise, ersetzen aber keinen interaktiven Browser-Test. Verwenden Sie Playwright nur als Fallback, wenn kein interaktives Browser-Tool aufrufbar ist, wenn der Benutzer explizit nach Playwright fragt oder wenn eine wiederholbare, skriptgesteuerte Regression speziell benötigt wird.
Verwenden Sie Chrome-Automation nur, wenn die Aufgabe das Chrome-Profil des Benutzers, vorhandene Tabs, Erweiterungen, authentifizierte Remote-Seiten oder Chrome-spezifisches Verhalten benötigt. Verlassen Sie sich nicht auf Chrome-Erweiterungsautomation für file://-Seiten; verwenden Sie stattdessen lokales HTTP.
Auch wenn die Automation lokales HTTP verwenden sollte, sollte der generierte Quellcode dennoch direkt kompatibel sein, indem er relative Pfade verwendet und Server-Only-Annahmen für Kerninhalte vermeidet. Wenn die App/der Browser eine schnelle file://-Kontrollprüfung erlaubt, öffnen Sie das Root-index.html direkt und überprüfen Sie, ob CSS, Bilder, Navigation und repräsentative Unterseiten nicht defekt sind. Wenn Dateiautomation nicht verfügbar ist, verlassen Sie sich auf das deterministische Audit root-absoluter Pfade und erwähnen Sie, ob die Direktöffnung manuell oder automatisch überprüft wurde.
Browser-Prüfungen:
- Desktop-Startbildschirm: Zusammensetzung, Abstände, Typografie, sichtbare Navigation und offensichtlicher Überlauf.
- Mobil-Startbildschirm: Navigationsverhalten, Textumbruch, Inhaltspriorität und horizontaler Überlauf.
- Interne Navigation: Alle primären Navigationslinks rendern.
- Abdeckung der Seitentypen: Mindestens ein Browser-Test oder Screenshot für jeden generierten Seitentyp.
- Interaktionsabdeckung: Theme-Umschalter, Menüs, Filter, Suche, Kopier-Buttons, Paginierung, Akkordeons, Tabs, Hover-/Klick-Zustände oder andere sichtbare Steuerelemente.
- Konsolenstatus: Keine offensichtlichen JavaScript-Fehler.
- Netzwerkstatus: Keine fehlenden lokalen CSS-, JS-, Bild- oder Schriftarten-Assets.
- Barrierefreiheitsgrundlagen: Sichtbarer Fokus für interaktive Steuerelemente, lesbarer Kontrast, aussagekräftige Seitentitel und nach Möglichkeit nicht leere Bild-Alt-Texte.
Für kleine Websites klicken Sie jede generierte Seite an. Für größere Websites stichprobenartig jeden Seitentyp und jede in EDITING.md genannte Route überprüfen.
Abdeckung der Seitentypen
Leiten Sie Seitentypen aus Dateinamen, Routen, sichtbarer Navigation und EDITING.md ab.
Typische Seitentypen:
- Startseite.
- Über oder Profil.
- Blog, Archiv, Kategorie, Tag, Notizen oder Listenseite.
- Artikel oder Detailseite.
- Projekte, Portfolio, Publikationen oder Arbeitsseite.
- Links, Freunde, Ressourcen, Aktuell, Verwendet, Garten, Suche, Theme/Einstellungen oder andere spezielle Seite.
Wenn eine generierte Website vorgibt, ein Blog zu sein, aber keine Artikel-/Detailseite hat, melden Sie dies. Wenn sie Navigation zu Unterseiten enthält, die nicht existieren, melden Sie dies als Blocker.
Kodierung und Quelllesbarkeit
Browser-Screenshots reichen nicht aus. Quelldateien müssen für zukünftige Modelle und Menschen lesbar sein.
Anforderungen:
- HTML-Dateien enthalten
<meta charset="utf-8">. - Nicht-ASCII-Text wird als UTF-8 gespeichert.
- HTML, CSS-Kommentare, JavaScript-Zeichenfolgen, JSON-/Datendateien, SVG-Text und
EDITING.mdsind in Quellform lesbar. - Kein Mojibake, keine Ersatzzeichen und keine versehentliche Browser-Kodierungswiederherstellung.
Wenn ein Terminal Mojibake anzeigt, der Browser aber korrekt aussieht, bestätigen Sie mit einer UTF-8-fähigen Leseoperation, bevor Sie es als defekt bezeichnen. Wenn der Dateiinhalt selbst Mojibake enthält, schreiben Sie betroffene Zeichenfolgen aus sauberem Text um, anstatt eine weitere Kodierungskonvertierung zu schichten.
Platzhalter- und Rückstands-Audit
Überprüfen Sie, ob die generierte Website noch Folgendes enthält:
TODO,FIXME,lorem ipsum,placeholder,replace me,your name,example.comoder Beispiel-/Demo-Text.- Dummy-E-Mails, gefälschte Social-Links, leere Buttons oder tote Handlungsaufforderungen.
- Ursprüngliche Autorennamen, Domains, Artikel Titel, E-Mails, Analyse-IDs, Social-Links, Freundeslinks oder private URLs in Stil-Neuerstellungen.
Entfernen Sie Platzhalter nicht blind, wenn der Benutzer sie noch als beabsichtigte editierbare Markierungen benötigt. Melden Sie sie klar oder ersetzen Sie sie nur, wenn der Benutzer echte Inhalte bereitgestellt hat.
Datenschutz und lokale Rückstände
Behandeln Sie diese als Blocker vor der Veröffentlichung:
.env,.npmrc,.pypirc, private Schlüsseldateien, Credential-JSON-Dateien, Service-Account-Dateien oder Passwort-Vault-/Exportdateien im bereitstellbaren Root.- Secret-ähnliche Zuweisungen, Zugriffstoken, private Schlüsselblöcke oder API-Schlüssel in HTML-, CSS-, JavaScript-, JSON-, Markdown-, SVG- oder Textdateien.
- Lokale absolute Dateisystempfade wie Windows-Laufwerkspfade,
file:///...,/Users/...,/home/...oder/mnt/...im generierten Quellcode.
Behandeln Sie Logs, Backups, temporäre Dateien und OS-Metadaten als Warnungen, es sei denn, sie legen private Inhalte offen. Entfernen Sie sie aus der bereitstellbaren Ausgabe vor dem Paketieren oder Veröffentlichen.
Korrekturrichtlinie
Wenn der Benutzer um "Überprüfung", "Bewertung" oder "Sagen Sie mir, was falsch ist" bittet, melden Sie zuerst die Ergebnisse und vermeiden Sie breite Änderungen.
Wenn die Validierung Teil eines Builds ist, beheben Sie einfache Probleme automatisch, wie das Hinzufügen eines fehlenden <meta charset="utf-8">, das Korrigieren relativer Pfade, das Umbenennen von root-absoluten Pfaden in seitenrelative, das Entfernen von Platzhaltertexten (falls nicht als beabsichtigte editierbare Markierungen markiert) und das Löschen von Datenschutz-/Sicherheitsdateien aus dem Site-Root.
Größere visuelle Defekte, die die Nutzbarkeit blockieren, sollten behoben werden, wenn der Benutzer dies im Kontext von "Überprüfung als Teil des Builds" angefordert hat; andernfalls melden Sie sie zuerst.
Verwendung der Skills nach einem fehlgeschlagenen Gate
- Wenn die Website ein anderes Theme oder eine andere Struktur benötigt: Rufen Sie
make-personal-siteauf. - Wenn das visuelle Styling nicht zur Referenz passt: Rufen Sie
copy-website-styleauf. - Wenn der Benutzer persönliche Informationen wie keinen Namen, keinen Titel, keine Biografie, keine Social-Links oder keine persönliche Domain bereitgestellt hat: Rufen Sie
personalize-siteauf. - Wenn es keine Blog-Beiträge gibt: Rufen Sie
add-blog-postsauf. - Wenn eine einzelne Seite oder eine kleine Komponente korrigiert werden muss: Rufen Sie
edit-site-partauf.