Communitygithub.com

FlineDev/SiteKit

Erstellen, anpassen und bereitstellen von Websites mit SiteKit – einem KI-zentrierten statischen Seitengenerator in Swift. Verwendung beim Erstellen einer neuen Website, Aufsetzen eines SiteKit-Projekts, Schreiben von Inhalten, Bereitstellen, Anpassen des Themes oder Erweitern einer bestehenden SiteKit-Seite mit einer benutzerdefinierten Page oder einem Renderer.

Was ist SiteKit?

SiteKit ist ein KI-zentrierter, statischer Seitengenerator in Swift, der auf einer phasenorientierten Pipeline aufbaut: Discovery → Loading → Enrichment → Page Rendering → System Rendering → Output Processing, ergänzt durch inhaltsunabhängiges Asset Teleporting. Jede Phase ist als Swift-Protokoll implementiert; Websites werden mit den Factory-Methoden von `SiteBuilder` (`.blog()`, `.podcast()`, `.newsletter()`, `.portfolio()`, `.docs()`, `.docc()`) zusammengestellt und durch das Austauschen oder Hinzufügen von Plugins flexibel angepasst. Die detaillierte Referenzdokumentation (z. B. für Bootstrap, Blueprints, Inhalte erstellen, Deployment, Themes, benutzerdefinierte Pages) wird über eine klar strukturierte Matrix referenziert, die die Absicht des Benutzers zur richtigen Datei leitet. Das Deployment erfolgt über den Orchestrator `references/deployment/SKILL.md`, der die CI-Variante erkennt und den Setup-Modus sowie die CLI-Authentifizierung koordiniert, bevor er zu einem CI- und einem Hosting-Anbieter (Cloudflare Pages, GitHub Pages, Netlify, Vercel) weiterleitet. Die Pipeline unterstützt Erweiterungspunkte auf jeder Ebene (Loader, Enricher, Renderer, OutputProcessor, Teleporter), und der `BuildContext` stellt den Plugins den gesamten readonly-Zustand zur Verfügung. Build-Befehle wie `swift run Site build`, `serve` und `validate` sowie die `--base-url`-Option für Staging-Deployments runden das Angebot ab.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FlineDev/SiteKit/tree/HEAD/Plugin/skills/sitekit

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht SiteKit?

SiteKit ist ein KI-zentrierter, statischer Seitengenerator in Swift, der auf einer phasenorientierten Pipeline basiert: Discovery → Loading → Enrichment → Page Rendering → System Rendering → Output Processing, ergänzt durch inhaltsunabhängiges Asset Teleporting. Jede Phase ist als Swift-Protokoll implementiert; Websites werden mit den Factory-Methoden von SiteBuilder (.blog(), .podcast(), .newsletter(), .portfolio(), .docs(), .docc()) zusammengestellt und durch das Austauschen oder Hinzufügen von Plugins flexibel angepasst.

Vorgehen

Leiten Sie die Absicht des Benutzers zur richtigen Referenz weiter. Lesen Sie nur die Referenzen, die Sie für die aktuelle Aufgabe benötigen.

Wenn der Benutzer fragt nach…Dann lesen Sie…
Installation von SiteKit + Aufsetzen der ersten Website (die sitekit-CLI)references/bootstrap.md
Einrichten einer neuen Website von Grund aufreferences/onboarding.md
Auswahl einer Blaupause (Blog, Newsletter, Podcast, Portfolio, AppLanding, Snippets, IndieDev, DocC, Plain)references/blueprints.md
Schreiben von Inhalten (Blogbeiträge, Newsletter-Ausgaben, statische Seiten)references/content-writing.md
Impressum / Datenschutz / Rechtliche Seiten (länderabhängig, DSGVO, Cookies)references/legal-pages.md
DocC / Markdown-Direktivenerweiterungen (@Metadata, @Row, @TabNavigator, @Video, @Image, @Links, …) + der Graceful-Degradation-Vertragreferences/markdown-extensions.md
Mehrsprachige Websites (Übersetzungen, Gebietsschema-Suffixe, Validierung)references/localization.md
Barrierefreiheits-Audit (WCAG AA Kontrast, Alt-Texte, Tastaturnavigation)references/accessibility.md
SEO + ASO + KI-Auffindbarkeit (kanonische URLs, OG, JSON-LD, llms.txt)references/seo-aso.md
Leistung / PageSpeed-Ergebnisse (LCP, CLS, render-blocking)references/performance.md
Bereitstellen der Website (Host- + CI-Anbieter-Matrix) – hier beginnenreferences/deployment/SKILL.md
Theme-Anpassung (Voreinstellungen, Farbschemata, Schriftkombinationen, Tokens)references/themes.md
Hinzufügen einer benutzerdefinierten Page für einen neuen HTML-Seitentypreferences/custom-pages.md
Erweitern der Pipeline (Loader, Enricher, Renderer, OutputProcessor, Teleporter)references/architecture.md
Fehlerbehebung bei Build / Laufzeitreferences/troubleshooting.md
Selbst gehostetes Newsletter-Setup (Keila + SMTP)references/newsletter-setup.md
Auswahl externer Dienste (E-Mail-Versand, Integrationen)references/external-services.md
SiteConfig.yaml Feldreferenzreferences/siteconfig-reference.md

Deployment – direkt zu einem Anbieter springen

references/deployment/SKILL.md ist der Orchestrator: Er erkennt die Package.swift-Variante, fragt nach dem Setup-Modus und führt die CLI-Authentifizierung durch, bevor er zu einer CI- und einer Hosting-Datei weiterleitet. Beginnen Sie hier für ein frisches Deployment. Wenn Sie das Ziel bereits kennen (z. B. Neukonfiguration eines bestehenden Deployments), können Sie direkt springen:

Wenn der Benutzer fragt nach…Dann lesen Sie…
CI auf GitHub Actionsreferences/deployment/ci/github-actions.md
CI auf GitLab CIreferences/deployment/ci/gitlab-ci.md (Community; Platzhalter)
CI auf Xcode Cloudreferences/deployment/ci/xcode-cloud.md (Community; Platzhalter)
CI auf Bitrisereferences/deployment/ci/bitrise.md (Community; Platzhalter)
Hosting auf Cloudflare Pagesreferences/deployment/hosts/cloudflare-pages.md
Hosting auf GitHub Pagesreferences/deployment/hosts/github-pages.md
Hosting auf Netlifyreferences/deployment/hosts/netlify.md
Hosting auf Vercelreferences/deployment/hosts/vercel.md
Welche CI-Anbieter unterstützt werden / Hinzufügen eines neuen CI-Anbietersreferences/deployment/ci/README.md
Welche Hosts unterstützt werden / Hinzufügen eines neuen Hosting-Anbietersreferences/deployment/hosts/README.md

Ein direkter Sprung überspringt den Setup-Modus des Orchestrators und die Package.swift-Erkennung – tun Sie dies nur, wenn diese bereits geklärt sind.

Kernvokabular (immer verfügbar)

  • Blueprint – ein Rezept für einen Website-Typ. SiteBuilder stellt Factory-Methoden bereit (.blog(), .podcast(), .newsletter(), .portfolio(), .docs(), .docc()), die die Standard-Plugin-Liste für jeden Website-Typ vorab zusammenstellen. Blaupausen auf der Festplatte unter Plugin/blueprints/ sind Starter-Seiten, die das Plugin klonen kann.
  • Page – das benutzerorientierte Protokoll für die HTML-Seitenwiedergabe. Es ist ein Unterprotokoll von Renderer. Konforme Implementierungen implementieren pages(in:) und renderHTML(_:context:); PageShell.wrap(content:page:context:) wendet automatisch das standardmäßige <head> / <header> / <footer>-Chrome an.
  • Renderer – System-Ausgabeprotokoll. Deklariert scope: .perLocale (Standard – läuft einmal pro Gebietsschema) oder .global (läuft genau einmal pro Build, verwendet für Sitemap, robots, llms.txt, Cloudflare _headers). Die Pipeline verteilt nach scope.
  • SiteBuilder – immutable, flüssiger Builder. Jede Konfigurationsmethode (.renderer, .enricher, .processor, .teleporter, …) gibt einen neuen SiteBuilder zurück. .run() liest CLI-Verben (build, serve, validate) und führt die Pipeline aus.
  • BuildContext – Read-Only-Zustand, der an alle Plugins der Stufen 3–6 übergeben wird. Enthält config, themeConfig, sections, staticPages, tags, homeContent, router, uiStrings, outputDirectory, projectDirectory.
  • Build-Befehle – swift run Site build schreibt die Website nach _Site/. swift run Site serve startet den Entwicklungsserver (Standard :8080). swift run Site validate prüft die Übersetzungsvollständigkeit bei mehrsprachigen Websites (einsprachige Websites bestehen trivial). --base-url <url> bei build/serve überschreibt SiteConfig.baseURL für diesen Durchlauf (Staging-Deployments).

Stilhinweis

Verwenden Sie bei der Generierung von Website-Inhalten durch dieses Skill eine authentische Indie-Stimme. Kurze Absätze. Persönliche Pronomen. Kein korporatives Herumeiern. Die vollständige Autorenstimmen-Anleitung und die Lernschleifen-Anweisungen befinden sich in references/content-writing.md.

Pipeline auf einen Blick

PhaseProtokollWo erweitern
0. Asset-Teleport (inhaltsunabhängig)Teleporter.teleporter(_:)
1. DiscoveryContentDiscovery.contentDiscovery(_:)
2. LoadingLoader<Source, Output>.articleLoader(_:), .staticPageLoader(_:)
3. EnrichmentEnricher.enricher(_:)
4. Pro-Gebietsschema-HTML-SeitenPage (Unterprotokoll von Renderer).renderer(_:)
5. System-RenderingRenderer + RenderScope.renderer(_:)
6. AusgabeverarbeitungOutputProcessor.processor(_:)

Die vollständige Architektur-Begründung und ausgearbeitete Beispiele für jeden Erweiterungspunkt finden Sie in references/architecture.md und references/custom-pages.md.

Siehe auch

Wenn eine Aufgabe von keiner der obigen Referenzen abgedeckt wird – Sie also SiteKits eigene Swift-Bibliothek modifizieren, anstatt eine Website damit zu bauen – eskalieren Sie zur Mitwirkungsreferenz im Repository-Stamm: AGENTS.md (Pipeline-Interna, Phasenprotokolle, SiteBuilder-Austauschpunkte, Build- und Test-Befehle).

Für einen Aufgaben → Dokumentations-Index, der sowohl die menschenlesbaren Dokumentationen als auch diese Referenzen umfasst, siehe ../../../USE-CASES.md im Repository-Stamm.

Verwandte Skills