Statische Site veröffentlichen
Ziel
Eine fertige statische Website veröffentlichen oder für das Deployment vorbereiten.
Dieser Skill ist für einsetzbare HTML/CSS/JS-Ausgaben wie site/, dist/, out/, public/ oder docs/. Er kann auch Framework-Projekte veröffentlichen, nachdem diese einen statischen Ausgabeordner erzeugt haben, soll aber eine reine statische Site nicht in ein Framework-Projekt umwandeln, nur um sie zu deployen.
Standardhaltung:
- Einfaches statisches Hosting gegenüber frameworkspezifischem Deployment bevorzugen.
- Git-basiertes Deployment für Websites bevorzugen, die der Nutzer weiter bearbeiten wird.
- Direkten Upload nur für schnelle einmalige Veröffentlichungen bevorzugen.
- Keine Remote-Repositories erstellen, Code pushen, DNS ändern, Domains hinzufügen oder in einen kostenpflichtigen Account deployen, es sei denn, der Nutzer fordert dies ausdrücklich.
Vertrag
Eingaben:
- Statisches Deploy-Root wie
site/,dist/,out/,public/,docs/oder Repository-Root. - Bevorzugte Plattform oder Ziel: GitHub Pages, Cloudflare Pages, Netlify, Vercel, benutzerdefinierte Domain, nur Beratung oder Live-Deployment.
- Aktueller Git-/Repository-Status, Plattformzugriff, CLI-/Browser-Login und etwaige Deployment-Einschränkungen.
Ausgaben:
- Konkrete Deployment-Einstellungen: Plattform, Branch, Build-Befehl, Basisverzeichnis, Publikations-/Ausgabeverzeichnis und ggf. Konfigurationsdateien.
- Optionale plattformspezifische Konfiguration wie GitHub Pages-Workflow,
netlify.toml,vercel.json,.nojekylloderCNAME. - Live-URL und Überprüfung nach dem Deployment, wenn das Deployment tatsächlich durchgeführt wird.
- Manuelle Dashboard-Schritte, wenn Anmeldeinformationen oder Accountzugriff nicht verfügbar sind.
Grenzen:
- Die Site nicht erstellen oder umgestalten; Fehler an den entsprechenden Unter-Skill weiterleiten.
- Nicht pushen, Repos/Projekte erstellen, hochladen, Domains binden, DNS ändern oder kostenpflichtige Ressourcen nutzen, es sei denn, dies wurde ausdrücklich autorisiert.
- Deployment nicht als Workaround für defekte lokale/statische Pfadkompatibilität verwenden, es sei denn, der Nutzer akzeptiert explizit ein Server-Root-only-Verhalten.
Erfolgskriterium:
review-static-sitewurde bestanden oder ungelöste Risiken sind explizit.- Das Deploy-Root enthält
index.htmlund die Plattform wird den korrekten Ordner veröffentlichen. - Online-URL lädt die Startseite, Assets, Navigation und repräsentative Unterseiten nach dem Deployment.
Bei Fehlschlag des Kriteriums:
- Pfad-, Asset-, Kodierungs- oder Seitentyp-Blocker vor dem Deployment beheben.
- Inhalt-/Design-/Import-Probleme an
personalize-site,edit-site-part,add-blog-posts,make-personal-siteodercopy-website-styleweiterleiten. review-static-siteerneut ausführen und dann Deployment-Einstellungen erneut versuchen oder aktualisieren.
Referenzen
Nur die für die gewählte Plattform oder das Problem benötigte Referenz laden:
- Pfadstrategie und Direkt-Öffnen-Kompatibilität:
references/path-strategy.md. - Cloudflare Pages Git-Integration und Direkt-Upload:
references/cloudflare-pages.md. - GitHub Pages Branch-Quelle und Actions-Workflows:
references/github-pages.md. - Netlify-Dashboard und
netlify.toml:references/netlify.md. - Vercel-Dashboard und
vercel.json:references/vercel.md.
Offizielle Dokumentation:
- GitHub Pages Publikationsquelle: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
- GitHub Pages benutzerdefinierte Workflows: https://docs.github.com/en/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages
- Cloudflare Pages Static HTML: https://developers.cloudflare.com/pages/framework-guides/deploy-anything/
- Cloudflare Pages Git-Integration: https://developers.cloudflare.com/pages/get-started/git-integration/
- Cloudflare Pages Direkt-Upload: https://developers.cloudflare.com/pages/get-started/direct-upload/
- Netlify Deployments erstellen: https://docs.netlify.com/deploy/create-deploys/
- Netlify Build-Konfiguration: https://docs.netlify.com/build/configure-builds/overview/
- Vercel Deployments: https://vercel.com/docs/deployments
- Vercel Projektkonfiguration: https://vercel.com/docs/project-configuration
Deployment-Modi
Zunächst ermitteln, was der Nutzer tatsächlich möchte:
- Nur Beratung: Plattformwahl und genaue Einstellungen erklären. Dateien nur bearbeiten, wenn es sinnvoll ist.
- Repo vorbereiten: Die benötigten Konfigurationsdateien hinzufügen und dem Nutzer mitteilen, worauf er im Hosting-Dashboard klicken muss.
- Jetzt deployen: Remote-Aktionen nur durchführen, wenn der Nutzer dies ausdrücklich verlangt hat und die erforderliche CLI/Auth/Session vorhanden ist.
- Live-URL überprüfen: Die bereitgestellte URL in einem Browser öffnen und mit der lokalen Site vergleichen.
Wenn Anmeldeinformationen, Accountzugriff, Browser-Login oder CLI-Authentifizierung fehlen, genaue Dashboard-Schritte angeben, anstatt einen Workaround zu erfinden.
Arbeitsablauf
- Den statischen Ausgabeordner und die bevorzugte Plattform des Nutzers identifizieren, falls vorhanden.
review-static-sitevor der Veröffentlichung aufrufen oder vorschlagen.- Bestätigen, dass das Deploy-Root
index.htmlenthält. - Asset-Pfade inspizieren und versehentliche root-absolute site-lokale Pfade vor der Veröffentlichung konvertieren.
references/path-strategy.mdladen, wenn das Pfadverhalten unklar ist. - Die einfachste passende Plattform und den einfachsten Deployment-Modus wählen.
- Die gewählte Plattformreferenz laden und nur die von dieser Plattform benötigten Konfigurationsdateien hinzufügen.
- Bei Deployment über Git den Git-Status prüfen und vermeiden, nicht zusammenhängende oder private Dateien einzuschließen.
- Wenn der Nutzer Remote-Aktionen autorisiert hat, genau das pushen oder deployen, was vereinbart wurde.
- Nach der Veröffentlichung die Live-URL öffnen und die bereitgestellte Site in einem Browser überprüfen.
Preflight-Checkliste
Diese Prüfungen durchführen, bevor Deployment-Konfigurationen geschrieben oder dem Nutzer Einstellungen mitgeteilt werden:
- Deploy-Root: Den Ordner wählen, der direkt
index.htmlenthält. - Einstiegsseite:
index.htmlmuss auf der obersten Ebene des Deploy-Root existieren. - Direkt-Öffnen-Vorschau: Das Root-
index.htmlsollte CSS, JS, Bilder und Navigation behalten, wenn es direkt aus dem Dateisystem geöffnet wird, es sei denn, der Nutzer hat explizit ein Server-Only-Verhalten akzeptiert. - Lokaler HTTP: Das Deploy-Root mit
python -m http.serverbereitstellen und bestätigen, dass es überhttp://127.0.0.1:<port>/funktioniert. - Statisches Audit:
review-static-sitefür Links, UTF-8-Lesbarkeit, Platzhalterreste, Browser-Rendering, Datenschutzreste und mobiles Layout ausführen oder empfehlen. - Asset-Pfade:
href,src,srcset, CSSurl(...), Schriftarten, Favicons, Coverbilder, RSS, Sitemap und Manifest-Links inspizieren. - Private Daten: Sicherstellen, dass Tokens, lokale Dateisystempfade, Entwurfsnotizen, Quell-Site-Identitäten und persönliche Geheimnisse nicht veröffentlicht werden.
- Ausgabe-Vollständigkeit: Bestätigen, dass Unterseiten, Beiträge, Bilder, Herstellerschriftarten, KaTeX/Mathe-Assets und kopierte Medien innerhalb des Deploy-Root liegen.
Diese als Blockade behandeln:
- Kein
index.htmlim Deploy-Root. - Defekte lokale CSS-, JS-, Bild-, Schriftart-, RSS-, Sitemap- oder Hersteller-Asset-Pfade.
- Quelldateien enthalten Mojibake oder unlesbare Kodierung.
- Die generierte persönliche Site enthält noch kopierte Quell-Identität, die hätte ersetzt werden sollen.
- Versehentliche root-absolute site-lokale Pfade wie
/assets/...,/posts/...,/data/...oder/images/...sind noch in einer generierten rein statischen Site vorhanden. - Die Site funktioniert nur über lokales HTTP, weil root-absolute Pfade von
127.0.0.1bereitgestellt werden, aber direktes Dateiöffnen oder Subpfad-Deployment würde CSS/JS/Bilder verlieren. - Datenschutzsensible Dateien oder Geheimnisse würden deployed.
- Die Plattform würde den falschen Ordner deployen.
Plattformwahl
Diese Standard-Reihenfolge für einfache statische persönliche Websites verwenden:
- Cloudflare Pages Git-Integration: Bester Standard für einen generierten
site/-Ordner und zukünftige Updates. - GitHub Pages mit GitHub Actions: Am besten, wenn der Nutzer alles innerhalb von GitHub haben möchte.
- Netlify: Einfaches statisches Hosting mit benutzerfreundlichen Vorschauen und Dashboard-Einstellungen.
- Vercel: Gut, wenn der Nutzer bereits Vercel verwendet oder später zu Next.js wechseln möchte, aber nicht der Standard für reines HTML.
Entscheidungsregeln:
- Wenn der Nutzer die geringste Reibung möchte und ein GitHub-Repo hat: Cloudflare Pages Git-Integration.
references/cloudflare-pages.mdladen. - Wenn der Nutzer reines GitHub-Hosting möchte: GitHub Pages.
references/github-pages.mdladen. - Wenn Deploy-Dateien im Repository-Root oder unter
/docsleben: GitHub Pages Branch-Quelle ist akzeptabel. - Wenn Deploy-Dateien in
site/,dist/,out/oder einem anderen benutzerdefinierten Ordner leben: GitHub Actions für GitHub Pages bevorzugen. - Wenn der Nutzer heute manuell hochladen möchte: Cloudflare Direct Upload oder Netlify manuelles Deployment.
- Wenn der Nutzer bereits einen Vercel-Account/ein Vercel-Projekt hat: Vercel mit expliziten Ausgabeverzeichniseinstellungen verwenden.
Framework-Statische Ausgabe
Wenn die Site nicht reines HTML/CSS/JS ist:
package.json, Framework-Konfiguration und vorhandene Skripte inspizieren.- Den vorhandenen Build-Befehl des Projekts verwenden; keine npm-Workflows erfinden.
- Den endgültigen statischen Ausgabeordner veröffentlichen, nicht den Quellordner.
- Häufige Ausgaben umfassen
dist,out,build,.output/publicundpublic, je nach Framework. - Für Next.js Static Export sicherstellen, dass das Projekt tatsächlich für Static Export konfiguriert ist, bevor
out/als endgültige Ausgabe behandelt wird. - Für Vue/Vite/Astro-Projekte das konfigurierte Ausgabeverzeichnis nach einem erfolgreichen Build veröffentlichen.
Wenn der Nutzer reines statisches Publishing angefordert hat und keine Framework-Dateien vorhanden sind, kein npm einführen.
Konfigurationsdatei-Richtlinie
Nur Konfigurationsdateien hinzufügen, die zur gewählten Plattform passen:
- GitHub Pages Actions:
.github/workflows/pages.yml. - GitHub Pages benutzerdefinierte Domain:
CNAMEim Deploy-Root, nur wenn der Nutzer die Domain angegeben hat. - GitHub Pages Jekyll-Umgehung:
.nojekyllim Deploy-Root, wenn nützlich. - Netlify:
netlify.tomlnur, wenn Dashboard-Einstellungen nicht ausreichen oder der Nutzer die Konfiguration in Git haben möchte. - Vercel:
vercel.jsonnur, wenn Vercel explizite Ausgabeeinstellungen benötigt. - Cloudflare Pages: Dashboard-Einstellungen reichen normalerweise für reine statische Websites aus.
Keine Deployment-Konfigurationen für jede Plattform auf einmal hinzufügen.
Git- und Remote-Sicherheit
Vor jeder Remote-Aktion angeben, was passieren wird, und bestätigen, dass der Nutzer dies angefordert hat:
- Ein GitHub-Repository erstellen.
- Ein Remote hinzufügen.
- Dateien stagen oder committen.
- Commits in einen Remote-Branch pushen.
- GitHub Pages aktivieren.
- Cloudflare-, Netlify- oder Vercel-Projekte erstellen.
- Dateien zu einem Hosting-Anbieter hochladen.
- Umgebungsvariablen hinzufügen.
- Benutzerdefinierte Domains hinzufügen oder DNS-Einträge ändern.
Vor dem Stagen oder Pushen:
git status --shortausführen.- Generierte Site-Dateien von nicht zusammenhängenden Benutzeränderungen unterscheiden.
- Nicht zusammenhängende Änderungen nicht stagen.
- Keine privaten Notizen, Anmeldeinformationen, lokalen Pfade, Screenshots mit Geheimnissen oder temporären Dateien veröffentlichen.
Niemals Geheimnisse, Tokens, private Notizen oder lokale Dateisystempfade in die statische Site oder Deployment-Konfiguration einfügen.
Post-Deployment-Überprüfung
Nachdem die Plattform eine Live-URL gemeldet hat:
- Die bereitgestellte URL mit einem tatsächlich verfügbaren interaktiven Browser-Tool öffnen. „Verfügbar“ bedeutet, dass es in der aktuellen Runde in der aufrufbaren Werkzeugliste verfügbar ist. In Codex kann dies das Browser-/In-App-Browser-Plugin sein, wenn es in die Runde geroutet wurde.
- Überprüfen, dass die Startseite kein 404, eine leere Seite oder eine Verzeichnisliste ist.
- Überprüfen, dass CSS, JavaScript, Bilder, Schriftarten, Favicon, RSS, Sitemap und Hersteller-Assets von der bereitgestellten Domain geladen werden.
- Die primäre Navigation und mindestens eine repräsentative Unterseite pro Seitentyp anklicken.
- Desktop- und Mobilbreiten testen.
- Die Browser-Konsole auf fehlende Assets oder JavaScript-Fehler prüfen.
- Metadaten, Titel, Beschreibung, Open-Graph-Bild, kanonische URL, RSS, Sitemap und Robots-Dateien überprüfen, wenn vorhanden.
- Bei Verwendung von GitHub Project Pages speziell Unterseiten und Asset-URLs unter dem Repository-Subpfad überprüfen.
- Bei Verwendung einer benutzerdefinierten Domain HTTPS und Weiterleitungen zwischen Apex und
wwwüberprüfen, falls konfiguriert.
Wenn kein interaktives Browser-Tool aufrufbar ist, nicht vorgeben, dass eine Live-Browser-Überprüfung stattgefunden hat. Den Nutzer bitten, das Browser-Tool zu aktivieren oder aufzurufen, wenn eine visuelle Live-Überprüfung wichtig ist; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Nutzer nicht umleitet oder der Client kein solches Tool hat, auf Playwright, Screenshots, HTTP-Prüfungen oder statische Prüfungen zurückfallen und die Einschränkung angeben.
Nicht standardmäßig nur Playwright oder Screenshots für die Live-Überprüfung verwenden, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Playwright nur als Fallback verwenden, oder wenn der Nutzer ausdrücklich skriptgesteuerte Deployment-Prüfungen anfordert.
Wenn die bereitgestellte Site von der lokalen Vorschau abweicht, das Deployment-Log, das Ausgabeverzeichnis und die Asset-Pfadstrategie inspizieren, bevor der Design-Code geändert wird.
Ausgabe
Die abschließende benutzerorientierte Zusammenfassung präzise halten:
- Gewählte Plattform und warum.
- Veröffentlichter oder vorbereiteter statischer Ordner.
- Deployment-Modus: Beratung, vorbereitete Konfiguration, Git-Integration, Direkt-Upload oder Live-Deployment.
- Verwendete Einstellungen: Branch, Build-Befehl, Basisverzeichnis, Publikations-/Ausgabeverzeichnis.
- Geänderte Konfigurationsdateien, falls vorhanden.
- Offizielle Anleitungs-URL für die gewählte Plattform.
- Live-URL, falls ein Deployment stattfand.
- Durchgeführte Überprüfung und verbleibende manuelle Schritte.
Wenn nur eine Beratung angefordert wurde, nicht vorgeben, dass die Site deployed wurde. Konkrete Plattformeinstellungen und Links zu offiziellen Anleitungen angeben.