Communitygithub.com

Zimzheng/prompt-to-canvas

將使用者提供的內容轉換為精美且可編輯的 Excalidraw 畫布之代理技能。

prompt-to-canvas 是什麼?

此技能專為 AI 代理設計,可將使用者輸入的文字或想法轉化為視覺化、可編輯的 Excalidraw 畫布。它結合了設計系統的概念,透過預先定義的風格目錄(CATALOG.md)和佈局規則(RULES.md),讓代理能自主決定畫面的主題、結構與視覺層級。支援的流程包含:與使用者溝通需求與視覺風格、分析內容核心、產生 SVG 草圖、轉換為 Excalidraw 場景 JSON、驗證以確保品質、最後在本地編輯器開啟。此技能特別適合用來繪製資訊圖表、架構圖、時間軸、比較圖表或儀表板等需要精美且可編輯的視覺化產物,支援 Claude Code、Cursor、Codex 等平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Zimzheng/prompt-to-canvas

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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/ 存在。

如果缺少任何項目,請告知使用者缺少什麼並停止。

如何進行對話

  1. 理解畫布。 識別內容、目的和受眾。如果這些資訊模糊到足以改變看板,請在開始建構前先問一個簡短的問題。
    • 當主機支援結構化或可選的選項時,請使用它們。否則請提出一個簡潔的文字問題。
    • 提供 2-3 個推測選項,將推薦選項放在第一位,並在使用者語言中包含一個「代理自行選擇」的選項,前提是提示已包含足夠的上下文。
  2. 詢問視覺風格。 詢問視覺風格:安靜、專業、活潑、大膽、品牌風格、顏色偏好或氛圍。如果使用者沒有偏好,提供代理代為選擇。如果使用者已指定風格或明確氛圍,則跳過此步驟。
    • 當主機支援時,使用可選的選項。
    • 將選項對應到目錄層級:Restrained、Balanced 或 Bold。
  3. 選擇樣式。 使用 CATALOG.md 選擇一個樣式。僅從目錄表格中選擇;不要比較多個 design.md 檔案。用一句話告訴使用者選擇的樣式及其原因。
  4. 建立它。 讀取 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 編輯。
  1. 開啟編輯器。 使用:
node scripts/open-editor.mjs --scene scene.json

每次呼叫都會啟動一個獨立的本地編輯器 URL。為每個新畫布、替代樣板或重新產生的版本執行此操作,而不是重複使用舊的 URL。預設情況下,腳本會推送到一個可用的新連接埠,並從一個獨特的無快取 URL 提供場景。當該 open-editor.mjs 進程停止或主機工作階段結束時,該連接埠即被釋放。

  1. 交付。 將顯示的本地 URL 提供給使用者。提及編輯器支援中文/英文 UI 切換、重新整理安全的本地自動儲存以及 PNG/SVG 匯出。提議以另一種風格重新渲染相同的內容。

檔案

冒煙測試

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

相關技能