Prompt to Canvas
Eine Design-System-Fertigkeit zum Erstellen polierter, bearbeitbarer Excalidraw-Zeichenflächen aus benutzerbereitgestellten Inhalten. Der Agent erstellt das Layout, verwendet den integrierten Stilkatalog für die visuelle Ausrichtung, erzeugt eine SVG-Quelle, konvertiert sie in bearbeitbares Excalidraw-Szenen-JSON und öffnet sie im lokalen Editor.
Dies ist kein automatischer Diagramm-Generator oder Vorlagenfüller. Der Stil gibt die Palette und Stimmung vor; der Agent entscheidet über These, Struktur, Gruppierung, Hierarchie, Beschriftungen und Verbindungen.
Verwenden Sie die Hauptinteraktionssprache des Benutzers für sichtbare Prosa auf der Zeichenfläche, Überschriften, Abschnittsbeschriftungen, Anmerkungen und Bildunterschriften, es sei denn, der Benutzer bittet explizit um eine andere Sprache. Behalten Sie technische Begriffe, Produktnamen, API-Namen, Akronyme, Code-Identifikatoren, Metriken und zitierte Quellenausdrücke in ihrer Originalsprache bei, wenn dies klarer ist.
Wann verwenden
- Der Benutzer möchte eine bearbeitbare Zeichenfläche, Infografik, ein Diagramm, eine Architekturgrafik, eine Zeitleiste, einen Vergleich, ein Dashboard, eine Concept Map oder eine präsentationsreife Visualisierung.
- Der Benutzer gibt Inhalte und bittet um "Zeichnen", "Visualisieren", "Mach daraus eine Zeichenfläche", "Erstelle ein Portfolio-Board" oder nennt diese Fertigkeit namentlich.
- Das Ergebnis soll poliert, bearbeitbar, exportierbar und visuell gestaltet sein.
Schritt 0: Voraussetzungen
Führen Sie scripts/preflight.sh aus oder überprüfen Sie manuell:
- Node 20 oder neuer.
assets/editor/index.htmlexistiert.scripts/svg-to-scene.mjs,scripts/validate-scene.mjsundscripts/open-editor.mjsexistieren.CATALOG.md,RULES.md,templates/undassets/styles/existieren.
Wenn etwas fehlt, teilen Sie dem Benutzer mit, was fehlt, und brechen Sie ab.
So führen Sie das Gespräch
- Verstehen Sie die Zeichenfläche. Identifizieren Sie Inhalt, Zweck und Zielgruppe. Wenn dies unklar genug ist, um die Tafel zu ändern, stellen Sie eine kurze Frage, bevor Sie mit dem Bau beginnen.
- Wenn der Host strukturierte oder auswählbare Optionen unterstützt, verwenden Sie diese. Andernfalls stellen Sie eine kompakte Textfrage.
- Bieten Sie 2-3 abgeleitete Optionen an, setzen Sie die empfohlene Option an die erste Stelle und fügen Sie eine Option "Agent wählt" in der Sprache des Benutzers hinzu, wenn der Prompt bereits genügend Kontext bietet.
- Fragen Sie nach der Stimmung. Fragen Sie nach dem visuellen Stil: ruhig, professionell, verspielt, kühn, markenkonform, Farbvorliebe oder Stimmung. Bieten Sie an, auszuwählen, wenn der Benutzer keine Präferenz hat. Überspringen Sie dies, wenn der Benutzer bereits einen Stil oder eine klare Stimmung genannt hat.
- Verwenden Sie auswählbare Optionen, wenn der Host sie unterstützt.
- Ordnen Sie die Optionen den Katalogstufen zu: Zurückhaltend, Ausgewogen oder Kühn.
- Wählen Sie einen Stil. Verwenden Sie
CATALOG.md, um einen Stil auszuwählen. Wählen Sie allein aus der Katalogtabelle; vergleichen Sie nicht mehreredesign.mdDateien. Teilen Sie dem Benutzer den gewählten Stil und den Grund in einem Satz mit. - Bauen Sie es. Lesen Sie
RULES.md,rules/canvas-rules.md,rules/visualization-strategy.mdund nur das ausgewähltetemplates/<slug>/design.md, dann:- Verwenden Sie
rules/analysis-prompt.mdals private redaktionelle Checkliste: Entscheiden Sie über Zielgruppe, Aufgabe des Artefakts, Kernthese, Schlüsselentitäten, Beziehungen, Kompromisse und 3-6 Aussagen, die auf der Zeichenfläche Platz verdienen. - Passen Sie die sichtbare Prosa auf der Zeichenfläche, Überschriften, Abschnittsbeschriftungen, Anmerkungen und Bildunterschriften an die Hauptinteraktionssprache des Benutzers an, es sei denn, der Benutzer wünscht etwas anderes. Technische Begriffe, Produktnamen, API-Namen, Akronyme, Code-Identifikatoren, Metriken und zitierte Quellenausdrücke dürfen in ihrer Originalsprache bleiben, wenn dies klarer ist.
- Erstellen Sie zuerst
diagram.svgin einem logischen Raum von etwa 1600-1700 Pixeln Breite. Verwenden Sie native SVG-Formen:rect,circle,ellipse,line,polylineundtext. Halten Sie jedes sichtbare Label als Text. - Lassen Sie den unendlichen Excalidraw-Zeichenflächenhintergrund weiß. Wenn der gewählte Stil ein farbiges Papier/einen farbigen Hintergrund hat, zeichnen Sie ihn als bearbeitbares Rechteck innerhalb der Szene; setzen Sie diese Farbe niemals in
appState.viewBackgroundColor. - Halten Sie die Stilauswahl unabhängig vom Excalidraw-Zeichenflächenhintergrund. Wählen Sie nach Inhalt, Zielgruppe, Formalität und Stimmung; die Papier-/Hintergrundfarbe der Vorlage bleibt als bearbeitbares Rechteck innerhalb der Szene Teil des visuellen Artefakts.
- Platzieren Sie nur den fertigen Artefaktinhalt auf der Zeichenfläche. Kontext zu Prompts, Quellen, Dateipfaden, gewähltem Stil oder Prozess gehört in die Chat-Antwort.
- Wenden Sie den gewählten Stil als visuelles System an: Palette, Dichte, Strich, Eckbehandlung, Hierarchie, Akzentdisziplin und Layout-Stimmung.
- Konvertieren Sie das SVG in bearbeitbares Excalidraw-Szenen-JSON:
- Verwenden Sie
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- Validieren Sie die Szene:
node scripts/validate-scene.mjs --scene scene.json
Wenn eine eindeutige Sprach-/Schrifterwartung besteht, validieren Sie auch diese:
node scripts/validate-scene.mjs --scene scene.json --expected-language <language-code>
- Überprüfen Sie den geöffneten Editor oder den gerenderten Export. Beheben Sie Textabschneidung, zu enge Abstände, schwache Hierarchie, versehentliche Überlappungen, veraltete Beispieltexte und Stilabweichungen. Bevorzugen Sie die Korrektur von
diagram.svgund die erneute Konvertierung; verwenden Sie Szenen-JSON-Bearbeitungen nur für Excalidraw-spezifische Bereinigungen.
- Öffnen Sie den Editor. Verwenden Sie:
node scripts/open-editor.mjs --scene scene.json
Jeder Aufruf startet eine unabhängige lokale Editor-URL. Tun Sie dies für jede neue Zeichenfläche, alternative Vorlage oder neu generierte Version, anstatt eine alte URL wiederzuverwenden. Standardmäßig wechselt das Skript zu einem neuen verfügbaren Port und stellt die Szene von einer eindeutigen Cache-freien URL bereit. Ein Port wird freigegeben, wenn dieser open-editor.mjs-Prozess gestoppt wird oder die Host-Sitzung endet.
- Übergeben. Geben Sie dem Benutzer die gedruckte lokale URL. Erwähnen Sie, dass der Editor die Umschaltung der Benutzeroberfläche zwischen Chinesisch und Englisch, den aktualisierungssicheren lokalen Autosave und den Export als PNG/SVG unterstützt. Bieten Sie an, denselben Inhalt in einem anderen Stil neu zu rendern.
Dateien
CATALOG.md: 35 Stile mit Stimmung, Formalität und Palettensignatur.RULES.md: SVG-Medienregeln, die vom Stilsystem gemeinsam genutzt werden.templates/<slug>/design.md: eine Palette und Stimmungsanleitung pro Stil.assets/styles/: Stilvorschaubilder.rules/analysis-prompt.md: private Checkliste zur Inhaltsformung.rules/canvas-rules.md: Excalidraw-Szenen- und Verifikationsregeln.rules/visualization-strategy.md: Layout- und Stiltreue-Richtlinien.scripts/preflight.sh: Abhängigkeits- und Ressourcenprüfung.scripts/svg-to-scene.mjs: SVG-zu-bearbeitbarem-Excalidraw-Konverter.scripts/validate-scene.mjs: Szenen-Schema-Validator.scripts/open-editor.mjs: Lokaler Editorserver und Szenenlader. Er weist standardmäßig einen neuen Port für separate Generierungen zu.
Smoke-Test
scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open