Communitygithub.com

tsumu-build-site

Design-Skill. Erstelle eine neue, bearbeitbare Tsumu-Website oder Landingpage von Grund auf, inklusive mehrseitiger, responsiver und animierter Designs, und gib dem Benutzer automatisch einen einmaligen Tsumu-Importlink. Nicht für Änderungen an einer bestehenden Seite.

Was ist tsumu-build-site?

Diese Fähigkeit ermöglicht es einem KI-Agenten, eine vollständig neue, bearbeitbare Tsumu-Website von Grund auf zu entwerfen und zu erstellen. Sie ist speziell für Fälle gedacht, in denen ein Benutzer eine "neue Website" anfordert – nicht für die Bearbeitung bestehender Websites. Das endgültige Ergebnis ist kein Screenshot oder HTML-Prototyp, sondern eine echte, bearbeitbare Tsumu-Website, die über einen einmaligen privaten Importlink zugänglich ist. Der Agent folgt einem zweistufigen Prozess: Zuerst wird ein originelles Website-Konzept (Phase 1) erstellt, dann wird dieses Design in ein natives Tsumu SiteDoc (Phase 2) übersetzt. Der gesamte Workflow wird durch MCP-Tools gesteuert, wobei `stage_site_doc` die wichtigste Funktion für die Bereitstellung des endgültigen Importlinks ist. Es wird nachdrücklich davor gewarnt, die Import-URL zu erfinden oder sich auf die Erstellung leeres Seiten mit `create_site` zu verlassen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abshrimp/tsumu-mcp/tree/HEAD/plugins/claude/skills/tsumu-build-site

In Ihrer bevorzugten KI fragen

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

Dokumentation

Erstelle eine neue Tsumu-Website

Verwende diese Anweisung, wenn der Benutzer darum bittet, eine neue Website in Tsumu zu erstellen. Das Ergebnis ist eine echte, bearbeitbare Tsumu-Seite, keine Designbeschreibung, kein Screenshot, kein HTML-Prototyp und keine leere Seite.

Ergebnis: Ein privater Tsumu-Importlink

Für eine vom Benutzer angeforderte neue Seite enthält das erfolgreiche Ergebnis von stage_site_doc eine importUrl. Dies ist das Übergabe-Artefakt, das der Anforderer verwendet, um die generierte Seite in Tsumu zu öffnen. Gib diesen genauen Link zusammen mit einer kurzen Beschreibung dessen, was erstellt wurde, an; es ist keine zusätzliche Anfrage für den Link erforderlich. Der Link ist privat und darf nicht in Logs, in nicht zusammenhängenden Kontexten oder an Drittanbieterdienste kopiert werden. Erfinde oder rekonstruiere ihn niemals.

Ein bereitgestellter Link ist kein Beweis für Import, Veröffentlichung oder Bereitstellung. Gib nicht vor, dass diese Aktionen stattgefunden haben.

Wähle den Workflow

  • Neue Seite erstellen: Verwende stage_site_doc direkt, auch wenn keine bestehende Seite zugeordnet ist. Der Benutzer kann im MCP-OAuth-Bildschirm nur die Erstellung neuer Seiten autorisieren, ohne einen Seitenverbindungscode. Eine bestehende Autorisierung für eine zugeordnete Seite kann ebenfalls eine neue Seite bereitstellen.
  • Vorhandene Seite des Benutzers bearbeiten: Aktiviere tsumu-edit-site und verwende die zugeordneten Editor-Tools. Lege keine Kopie an und überschreibe die vorhandene Seite nicht.
  • Kein Staging-Tool oder keine erfolgreiche Autorisierung: Gib keine URL an. Wenn die Artefakterstellung verfügbar ist, erstelle ein gültiges herunterladbares doc.json; erkläre andernfalls die fehlende Fähigkeit und was getan werden kann.
  • create_site dient zum Erstellen einer leeren, browserlokalen Seite in einem bereits zugeordneten Editor. Es lädt kein vollständig generiertes Design hoch und erfordert eine erneute Zuordnung der neuen Seite. Verwende es nicht als Ersatz für stage_site_doc.

Zweiphasige Erstellung: Frei entwerfen, dann in Tsumu konvertieren

Phase 1 – Erstelle ein originelles Website-Konzept, bevor du im SiteDoc-Format arbeitest. Behandle die Anfrage des Benutzers als ein Website-Design-Briefing, nicht als Anweisung, ein JSON-Beispieldokument neu zu gestalten.

  1. Lege den Zweck der Website, die Zielgruppe, die Kernbotschaft, die Seiten, die Content-Prioritäten und die primäre Benutzeraktion fest. Bei vagen Anfragen wie "Erstelle eine schöne Website" wähle unabhängig ein unverwechselbares, plausibles Konzept, anstatt standardmäßig das Beispiel-Portfolio zu verwenden oder unnötige Fragen zu stellen. Erfinde keine echten Adressen, Testimonials, Produktbehauptungen oder Preise.
  2. Gestalte die Website, als ob Tsumus Node-Schema nicht existieren würde. Entwickle eine originelle Informationsarchitektur, seitenweise Inhalte, Abschnittskompositionen, Hierarchie, Typografie, Farben, Bildsprache oder grafische Elemente, Abstände und responsives Verhalten. Vermeide es, mechanisch eine generische Hero/Funktionen/Testimonials/Kontakt-Vorlage zu wiederholen.
  3. Wenn Werkzeuge und Zeit es erlauben, erstelle den vollständigen Entwurf als eigenständigen HTML/CSS-Prototypen (mit klaren Interaktionsnotizen), um das Layout frei zu erkunden. Bereite andernfalls einen ebenso spezifischen Seiten- und Komponentenentwurf vor. Dies ist ein Zwischen-Design-Artefakt, nicht das endgültige Ergebnis oder die Behauptung, dass Tsumu beliebiges HTML über stage_site_doc importieren kann. Bestehe nicht auf einer Live-Vorschau, wenn keine verfügbar ist.
  4. Beurteile den Entwurf im Hinblick auf das Briefing: Hat er eine erkennbare visuelle Identität, glaubwürdige Inhalte, zweckmäßige Abschnitte, eine klare Benutzerreise und ein mobiles Layout? Verfeinere ihn, bevor du dir Beispiel-SiteDoc-Layouts ansiehst.

Phase 2 – Übersetze dieses Design in ein natives, bearbeitbares Tsumu-SiteDoc. Konsultiere erst jetzt get_site_doc_spec, den Schema-Leitfaden und das minimale Beispiel, um die gültigen Datenstrukturen zu lernen, nicht um zu entscheiden, wie die Website aussehen soll. Baue die entworfenen Seiten und Layouts mit Tsumus unterstützten nativen Elementen, Stilen, Assets und Interaktionen nach. Bewahre die originellen Kompositionen, Typografie, Abstände, Inhalte und responsiven Absichten des Zwischendesigns, anstatt es in ein wiedereingefärbtes Beispiel zu überführen. Wenn ein Detail nicht unterstützt wird, passe es an die nächstgelegene gültige editierbare Darstellung an oder lege die Einschränkung offen; erfinde niemals Schema-Felder.

Originalitätsprüfung: Vergleiche das konvertierte SiteDoc mit dem Design aus Phase 1, bevor du es bereitstellst. Wenn die endgültige Seite im Wesentlichen das gebündelte Beispiel mit geänderten Wörtern, Farben oder Bildern ist, ist die Konvertierung fehlgeschlagen: Gestalte die Struktur und Komposition neu. Wenn der Benutzer ausdrücklich eine bestimmte Vorlage anfordert, befolge diese Anforderung stattdessen.

Konvertiere das Originaldesign in SiteDoc

Bevor du ein SiteDoc erstellst: Rufe das schreibgeschützte MCP-Tool get_site_doc_spec auf und überprüfe sowohl dessen guide als auch example. Tue dies nach der Planung des Originaldesigns, aber bevor du SiteDoc-Seiten, Nodes, Stile, Skripte oder den ersten stage_site_doc-Versuch erstellst. Die Referenz ist mit einer Nur-neue-Seite-OAuth-Genehmigung verfügbar. Überspringe dies nicht, nur weil der Skill-Text geladen wurde; einige MCP-Clients rufen Referenzen nicht automatisch ab. Wenn das Spezifikationstool nicht verfügbar ist, lies stattdessen references/site-doc.md und references/minimal-site.json. Errate niemals Datenstrukturen.

  1. Übersetze die Seitenkarte, Inhalte und Kompositionen der Phase-1-Website in SiteDoc. Beginne nicht mit dem JSON-Beispiel und ersetze dessen Text oder Farbpalette. Der Leitfaden und die Beispiele beschreiben nur gültige Eigenschaften und Beziehungen. Konsultiere für erweiterte Funktionen die aktuellen lib/types.ts, lib/presets.ts, lib/site-import-format.ts und skills/tsumu/references/site-doc.md, sofern zugänglich.
  2. Konstruiere ein vollständiges SiteDoc-Objekt (keinen JSON-String, keine HTML-Seite oder komprimierte Datei). Erforderliche Felder: schemaVersion: 1, nicht leeres siteName, pages, pageOrder, nodes, assets. Die Startseite hat slug: "". Die children von Seiten und Nodes beziehen sich auf Node-IDs; Nodes sind editierbare box, image usw. Text und Überschriften verwenden box.text, keinen erfundenen heading-Node.
  3. Erstelle aussagekräftige native Seitenlayouts, die der entworfenen Struktur entsprechen. Gib Nodes geeignete semantische Bezeichnungen, Stile und responsive Überschreibungen. Bewahre die tatsächliche Hierarchie, Abstände, typografische Kontraste, visuelle Akzente und Abschnittsvariationen aus Phase 1. Überprüfe Navigationsziele, Alternativtexte, Kontraste und mobiles Verhalten. Vermeide defekte Assets, leere Links, Platzhalterinhalte und Off-Screen-Elemente.
  4. Wenn das Design Animationen, Skripte, Komponenten oder Formularverhalten beinhaltet, konsultiere die exakten aktuellen Typdefinitionen und implementiere nur unterstützte Strukturen. Skript-Element-Ziele verwenden die HTML-attrId des Ziel-Nodes, nicht dessen SiteDoc-Node-ID; @self gilt nur für ein Skript, das an ein Element angehängt ist. Überprüfe jede verschachtelte Bedingung und jeden Schritt. Erfinde keine Bewegungs- oder Skripteigenschaften und beschreibe einen inerten Button nicht als funktionsfähig.
  5. stage_site_doc akzeptiert nur das vollständige SiteDoc als doc (bis zu 12 MiB serialisiertes JSON). Es akzeptiert nicht den Phase-1-HTML-Prototyp, ZIPs oder separate binäre Assets. Verwende nach Möglichkeit assets: {}, verifizierte externe Bildquellen, wo geeignet, oder kleine eingebettete dataUrl-Assets innerhalb des Limits. Erfinde keine Tsumu-Speicherpfade.
  6. Überprüfe das resultierende SiteDoc am Originaldesign, nicht an der Ästhetik des Beispiels. Stelle sicher, dass es vollständig editierbar und strukturell gültig bleibt; wenn die Konvertierung ein unverwechselbares Layout oder einen bestimmten Inhalt verliert, verbessere die native Elementhierarchie vor der Bereitstellung.

Verifizieren und ausliefern

  • Vergleiche vor der Bereitstellung die endgültigen Seiten mit dem Design aus Phase 1 und bestätige, dass es sich um eine originalgetreu und unabhängig zusammengestellte Website handelt, nicht um ein neu gestaltetes Minimalbeispiel. Behalte das Zwischendesign privat, es sei denn, der Benutzer fragt danach; liefere das SiteDoc oder den Importlink als fertiges Ergebnis aus.
  • Stelle vor der Bereitstellung sicher, dass jede sichtbare Design-Deklaration bei nodes[id].styles.base.default oder der entsprechenden responsiven Überschreibung platziert ist, nicht in einem erfundenen Feld style, css oder className. Die tatsächlichen CSS-Deklarationswerte müssen Zeichenketten sein. Überprüfe IDs, Referenzen, azyklische Bäume und die Importregeln. Überprüfe die Seitenhierarchie, Reaktionsfähigkeit und angeforderte Interaktionen, soweit es die Werkzeuge zulassen. Gib nicht an, dass du eine Vorschau gemacht hast, es sei denn, du hast es tatsächlich getan.
  • Rufe stage_site_doc({ doc: <vollständiges SiteDoc> }) auf; verwende editorOrigin nur, wenn der Benutzer eine bestimmte selbst gehostete Tsumu-Installation anfordert.
  • Eine erfolgreiche Übergabe einer neuen Seite enthält die exakte importUrl des Tools als klickbaren Link für den Anforderer sowie eine kurze Erklärung, dass das Öffnen eine neue bearbeitbare Seite importiert. Der Link ist keine URL einer veröffentlichten Seite.
  • Wenn es fehlschlägt, nenne den tatsächlichen Fehler und gib nicht vor, dass die Seite gespeichert wurde. Ersetze eine fehlgeschlagene Tool-Aktion nicht durch einen erfundenen Link oder wechsle stillschweigend zu einer vorhandenen Seite.
  • Der Link enthält ein privates Zugriffstoken im URL-Fragment, läuft nach einer Stunde ab und wird verbraucht, nachdem Tsumu den erfolgreichen Import bestätigt hat. Gib ihn nicht an andere weiter. Fehlgeschlagene Importe können nach Ablauf der vorübergehenden fünfminütigen Anspruchsbindung erneut versucht werden.

Übergabebeispiel (nur zur Veranschaulichung): "Die bearbeitbare Café-Website ist für den Import bereitgestellt. Der private Tsumu-Importlink ist für die nächste Stunde verfügbar." Die tatsächliche Übergabe enthält den echten, vom Tool generierten Link, wenn die Bereitstellung erfolgreich ist.

Verwandte Skills