Communitygithub.com

build-site

Führt die gesamte Client-Website-Pipeline aus: Briefing und Design-Erfassung, Sitemap und Texterstellung, Bau, Checks, Review, SEO und Launch-Vorbereitung, mit zwei Genehmigungstoren und einer begrenzten Fehlerbehebungsschleife. Verwende diesen Skill, wenn eine neue Client-Website erstellt oder neu aufgebaut wird, oder wenn der Benutzer „Website bauen“ sagt oder /build-site ausführt.

Was ist build-site?

Dieser Skill automates the gesamte Erstellung einer Client-Website in einer strukturierten Pipeline mit acht Phasen und zwei Benutzergenehmigungspunkten. Er ist als Skill (nicht als Orchestrator-Agent) konzipiert, sodass er direkt in der Hauptsitzung läuft und Unteragenten delegieren kann, die selbst keine weiteren Unteragenten starten können. Die Pipeline beginnt mit der Erfassung der Projektinformationen (Brief, Design, Referenzen), erstellt einen Plan mit Sitemap und Texten, lässt diesen vom Benutzer genehmigen, baut die Seiten mit einem Design-Geschmacksskill, implementiert SEO mit einem spezialisierten Agenten, führt automatisierte Tests durch, durchläuft eine begrenzte Fehlerbehebungsschleife (maximal 2 Runden) und endet mit Launch-Vorbereitung und Lessons Learned. Der Skill speichert seinen Fortschritt in einer Statusdatei (.claude/pipeline/pipeline-state.md), sodass die Arbeit über mehrere Sitzungen hinweg fortgesetzt werden kann. Er unterstützt Astro-Projekte und ist besonders nützlich für Agenturen oder Entwickler, die wiederholt professionelle Websites für lokale Unternehmen oder Dienstleister erstellen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Client-Website erstellen

Die Hauptsitzung führt diese Pipeline aus und delegiert an Unteragenten. (Unteragenten können keine anderen Unteragenten starten, weshalb dies ein Skill und kein Orchestrator-Agent ist.)

[0 Erfassungstor]  Brief + DESIGN.md + Referenzen
      ↓
[1 Plan]  Sitemap, Seitenabschnitte, Texte → plan.md, src/data/*
      ↓
[BENUTZERTOR 1]  Plan und Texte genehmigen
      ↓
[2 Bau]  Seiten und visuelles System
      ↓
[3 SEO]     SEO-Agent → seo-report.md
      ↓
[4 Verifizieren]  npm run verify (hartes Tor)
      ↓
[5 Review]  Site-Reviewer-Agent → review-report.md
      ↓
[6 Fehlerbehebung]  P0/P1 → beheben → verifizieren → erneut reviewen (max. 2 Runden)
      ↓
[BENUTZERTOR 2]  Website genehmigen
      ↓
[7 Launch-Vorbereitung]  Launch-Checkliste + Übergabedokument
      ↓
[8 Lessons Learned]  An docs/lessons.md anhängen

Artefakte

Alles wird in .claude/pipeline/ abgelegt:

pipeline-state.md   Phase, Fehlerbehebungsrunde, letzte Aktualisierung
plan.md             Sitemap, Abschnitte pro Seite, Hauptaktion pro Seite
review-report.md    Vom Site-Reviewer
seo-report.md       Vom SEO-Agenten
screenshots/        Von npm run verify

Lies zu Beginn jeder Phase pipeline-state.md und setze ab dem dort angegebenen Punkt fort. Aktualisiere die Datei am Ende jeder Phase. Dadurch kann der Bau über mehrere Sitzungen hinweg erfolgen.

Phase 0: Erfassungstor

Prüfe jedes Element. Wenn etwas fehlt, stoppe und hilf dem Benutzer, es zu ergänzen, bevor du fortfährst.

ElementBereit, wenn
.agents/product-marketing.mdGeschäftsfakten-Abschnitt vollständig, Hauptaktion benannt, Zielgruppe und Tonfall ausgefüllt. Verwende den product-marketing-Skill, um es aus den Angaben des Benutzers zu entwerfen.
src/data/business.jsonName, Telefon, Adresse, Öffnungszeiten, Maps-Link stimmen mit dem Brief überein. Kopiere sie aus dem Brief.
DESIGN.mdJeder Abschnitt ausgefüllt. Wenn der Benutzer nur Referenzen hat, entwerfe es aus references/ und bitte um Bestätigung.
references/Mindestens zwei Screenshots oder URLs mit einem Hinweis, was daraus übernommen werden soll.
Client-AssetsLogo und Fotos, oder ein expliziter Hinweis, dass Platzhalter vorerst in Ordnung sind.
BearbeitungWird der Kunde die Website selbst bearbeiten? (Beeinflusst Phase 7.)

Fülle dann src/styles/tokens.css aus DESIGN.md.

Phase 1: Plan

  1. Schreibe plan.md: die Seiten (die meisten Kunden benötigen Startseite, eine Seite pro Hauptangebot oder eine Menü-/Dienstleistungsseite, Über uns, Kontakt), die eine Hauptaktion pro Seite und die Abschnitte auf jeder Seite in Reihenfolge. Verwende den Brief und site-essentials.
  2. Schreibe die Texte mit dem copywriting-Skill und führe dann copy-editing darauf aus. Beginne mit der Kundensprache des Briefs und den eigenen Worten des Kunden und verwende einige dieser Phrasen nahezu wörtlich. Befolge Hausregel 9 in CLAUDE.md (keine generische KI-Formulierung). Lege sie in src/data/ ab (home.json, services, FAQs), nicht in Komponenten.
  3. Markiere alles, was du nicht weißt, als [NEED: ...]. Fülle nie eine Lücke mit einer erfundenen Tatsache.

Benutzertor 1

Stoppe. Zeige dem Benutzer: die Sitemap, die Abschnitte und Hauptaktionen jeder Seite, den vollständigen Text und jedes [NEED: ...]-Element. Warte auf Genehmigung oder Änderungen. Texte sind jetzt günstiger zu ändern als nach dem Bau.

Phase 2: Bau

Baue mit dem design-taste-frontend-Skill (Geschmacksskill) innerhalb dieses Astro-Projekts. Sage ihm vor dem Start:

  • Die Art ist place (Menschen kommen zu ihm) oder service (Menschen werden eingestellt), niemals eine technische Art.
  • DESIGN.md und references/ legen Palette, Typografie und Stil fest. Die eigene Standardpalette und Schriftarten werden überschrieben.
  • Geschäftsfakten stammen aus src/data/business.json. Die Platzhalter-Kontaktregeln gelten nicht.
  • Bewegung folgt den Hausregeln in CLAUDE.md.

Baue Seite für Seite, zuerst die Startseite. Führe nach der Startseite npm run verify aus, sieh dir die drei Screenshots an und behebe, was du siehst, bevor du die nächste Seite baust. Das Abschlusstor des Geschmacksskills wird automatisch ausgeführt, wenn er stoppt; behandle seine Ergebnisse als Eingabe, aber CLAUDE.md hat bei Konflikten Vorrang.

Phase 3: SEO

Der SEO-Agent bearbeitet Head-Tags, JSON-LD und Robots, daher wird er vor Verifizierung und Review ausgeführt. So beurteilt das Review die fertige Website.

seo: "Auditiere und implementiere SEO für diese Website, einschließlich des lokalen Business-Schritts. Brief: .agents/product-marketing.md. Schreibe deinen Bericht nach .claude/pipeline/seo-report.md."

Phase 4: Verifizieren (hartes Tor)

npm run verify

Alle check-site-Fehlschläge und Screenshot-Probleme (seitliches Scrollen, Konsolenfehler) müssen vor dem Review behoben werden. [NEED: ...]-Fehlschläge sind nur für Fakten erlaubt, nach denen der Benutzer bereits gefragt wurde; liste sie auf. Schreibe jeden Text um, den check-site als generisch markiert, es sei denn, der Kunde verwendet dieses Wort tatsächlich.

Phase 5: Review

Der Reviewer ist schreibgeschützt und gibt seinen Bericht als letzte Nachricht zurück. Speichere diese Nachricht wörtlich in .claude/pipeline/review-report.md.

site-reviewer: "Überprüfe die gebaute Website. Plan: .claude/pipeline/plan.md. Brief: .agents/product-marketing.md. Design: DESIGN.md. Screenshots: .claude/pipeline/screenshots/. Bereits vorgenommene SEO-Änderungen: .claude/pipeline/seo-report.md. Gib den vollständigen Bericht als deine letzte Nachricht zurück."

Phase 6: Fehlerbehebung

Site-Reviewer-BefundAktion
BereitGehe zu Tor 2
Nachbesserung erforderlich, nur P2sGehe zu Tor 2, liste die P2s auf
Nachbesserung erforderlich (P1s) oder blockiert (P0s)Runde < 2: Behebe sie, führe Phase 4 (Verifizieren) erneut aus, führe Site-Reviewer erneut auf den geänderten Seiten aus und speichere seinen Bericht. Runde = 2: Stoppe und zeige dem Benutzer.

Verwende den bug-fixer-Agenten für alles, was defekt ist und nicht nur vom Brief abweicht. Erhöhe die Runde in pipeline-state.md jedes Mal.

Benutzertor 2

Stoppe. Zeige dem Benutzer: Startseiten-Screenshots bei 390 und 1440, den Befund, verbleibende P2s, erforderliche SEO-Entscheidungen, verbleibende [NEED: ...]-Elemente und Platzhalterfotos, die ersetzt werden müssen. Warte auf Genehmigung.

Phase 7: Launch-Vorbereitung

  1. Führe npm run check:launch aus und behebe jeden Fehlschlag. Fülle dann docs/launch-checklist.md, markiere jedes Element als erledigt, nicht zutreffend oder wartend auf jemanden (nenne wen).
  2. Fülle docs/handoff.md für den Kunden.
  3. Wenn der Kunde die Website bearbeiten wird, folge docs/client-editing.md.
  4. Nachdem die Website auf ihrer echten Domain live ist, erinnere den Benutzer daran, claude-seo darauf auszuführen: /seo local <url> und /seo audit <url>.

Phase 8: Lessons Learned

Durchsuche die Berichte und die Fehlerbehebungsrunden nach allem, was zweimal schiefgelaufen ist oder echte Zeit gekostet hat. Hänge eine datierte Zeile pro Erkenntnis an docs/lessons.md an. Sage dem Benutzer, welche Erkenntnisse es wert sind, zurück in site-starter kopiert zu werden, damit jede zukünftige Website davon profitiert.

Verwandte Skills