Prompt to Canvas
一個設計系統技能,用於將使用者提供的內容建立成精美且可編輯的 Excalidraw 畫布。代理會編排版面,使用內建的樣式目錄作為視覺方向,建立 SVG 原始檔,將其轉換為可編輯的 Excalidraw 場景 JSON,然後在本地編輯器中打開。
這不是自動圖表產生器或樣板填充工具。樣式提供了色調和氛圍;代理則決定主題、結構、分組、層級、標籤和連接線。
除非使用者明確要求其他語言,否則請使用使用者的主要互動語言來處理畫布上的可見文字,包含標題、章節標籤、註解和說明文字。若原文較清晰,則保留技術詞彙、產品名稱、API 名稱、縮寫、程式碼識別符、度量單位及引用來源詞句的原文。
使用時機
- 使用者想要一個可編輯的畫布、資訊圖表、圖表、架構圖、時間軸、比較圖、儀表板、概念圖或適合簡報的視覺內容。
- 使用者提供內容並要求「畫出來」、「視覺化」、「把這個變成畫布」、「做一個作品集看板」,或指名使用此技能。
- 結果應為精美、可編輯、可匯出且具備視覺風格。
步驟 0:前置條件
執行 scripts/preflight.sh,或手動檢查:
- Node 20 或更新版本。
assets/editor/index.html存在。scripts/svg-to-scene.mjs、scripts/validate-scene.mjs和scripts/open-editor.mjs存在。CATALOG.md、RULES.md、templates/和assets/styles/存在。
如果缺少任何項目,請告知使用者缺少什麼並停止。
如何進行對話
- 理解畫布。 識別內容、目的和受眾。如果這些資訊模糊到足以改變看板,請在開始建構前先問一個簡短的問題。
- 當主機支援結構化或可選的選項時,請使用它們。否則請提出一個簡潔的文字問題。
- 提供 2-3 個推測選項,將推薦選項放在第一位,並在使用者語言中包含一個「代理自行選擇」的選項,前提是提示已包含足夠的上下文。
- 詢問視覺風格。 詢問視覺風格:安靜、專業、活潑、大膽、品牌風格、顏色偏好或氛圍。如果使用者沒有偏好,提供代理代為選擇。如果使用者已指定風格或明確氛圍,則跳過此步驟。
- 當主機支援時,使用可選的選項。
- 將選項對應到目錄層級:Restrained、Balanced 或 Bold。
- 選擇樣式。 使用
CATALOG.md選擇一個樣式。僅從目錄表格中選擇;不要比較多個design.md檔案。用一句話告訴使用者選擇的樣式及其原因。 - 建立它。 讀取
RULES.md、rules/canvas-rules.md、rules/visualization-strategy.md,以及僅選定的templates/<slug>/design.md,然後:- 將
rules/analysis-prompt.md作為私有編輯檢查清單:決定受眾、產物的任務、核心論點、關鍵實體、關係、取捨,以及 3-6 個值得在畫布上佔據空間的主張。 - 除非使用者另有要求,否則將畫布上的可見文字、標題、章節標籤、註解和說明文字與使用者的主要互動語言匹配。當原文較清晰時,技術詞彙、產品名稱、API 名稱、縮寫、程式碼識別符、度量單位及引用來源詞句可以保留原文。
- 先在約 1600-1700px 寬的邏輯空間中組合
diagram.svg。使用原生的 SVG 形狀:rect、circle、ellipse、line、polyline和text。確保每個可見標籤都是文字。 - 保持 Excalidraw 無限畫布背景為白色。如果選擇的樣式有彩色紙張/背景,請將其繪製為場景內的可編輯矩形;切勿將該顏色放在
appState.viewBackgroundColor中。 - 保持樣式選擇與 Excalidraw 畫布背景無關。根據內容、受眾、正式程度和氛圍來選擇;樣板紙張/背景顏色作為場景內的可編輯矩形,仍是視覺產物的一部分。
- 僅將完成的產物內容放在畫布上。與提示、來源、檔案路徑、選擇的樣式或過程相關的上下文應放在聊天回覆中。
- 將選定的樣式作為視覺系統應用:色調、密度、筆觸、角落處理、層級、強調紀律和版面氛圍。
- 將 SVG 轉換為可編輯的 Excalidraw 場景 JSON:
- 將
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- 驗證場景:
node scripts/validate-scene.mjs --scene scene.json
當存在明確的語言/文字期望時,也進行驗證:
node scripts/validate-scene.mjs --scene scene.json --expected-language <language-code>
- 檢查已開啟的編輯器或已渲染的匯出。修復文字裁剪、間距過窄、層級薄弱、意外重疊、過時的範例文字以及風格漂移。偏好修正
diagram.svg並重新轉換;僅在需要 Excalidraw 特定的清理時才使用場景 JSON 編輯。
- 開啟編輯器。 使用:
node scripts/open-editor.mjs --scene scene.json
每次呼叫都會啟動一個獨立的本地編輯器 URL。為每個新畫布、替代樣板或重新產生的版本執行此操作,而不是重複使用舊的 URL。預設情況下,腳本會推送到一個可用的新連接埠,並從一個獨特的無快取 URL 提供場景。當該 open-editor.mjs 進程停止或主機工作階段結束時,該連接埠即被釋放。
- 交付。 將顯示的本地 URL 提供給使用者。提及編輯器支援中文/英文 UI 切換、重新整理安全的本地自動儲存以及 PNG/SVG 匯出。提議以另一種風格重新渲染相同的內容。
檔案
CATALOG.md:35 種風格,包含氛圍、正式程度和色調特徵。RULES.md:風格系統共用的 SVG 媒介規則。templates/<slug>/design.md:每種風格的色調和氛圍指南。assets/styles/:風格預覽圖片。rules/analysis-prompt.md:私有內容構建檢查清單。rules/canvas-rules.md:Excalidraw 場景和驗證規則。rules/visualization-strategy.md:版面與風格忠實度指引。scripts/preflight.sh:依賴項目與資源檢查。scripts/svg-to-scene.mjs:SVG 轉可編輯 Excalidraw 轉換器。scripts/validate-scene.mjs:場景結構驗證器。scripts/open-editor.mjs:本地編輯器伺服器與場景載入器。預設會為不同的生成項目分配全新的連接埠。
冒煙測試
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