Community影像github.com

svg-creator

根據使用者描述,建立具有手繪風格的 SVG 流程圖與圖表。支援指定長寬比(16:9、4:3、1:1、A4 或自訂 W:H 比例)。每當使用者要求建立流程圖、圖表、架構圖、流程圖、心智圖或任何工作流程/系統的可視化呈現時,請使用此技能。

svg-creator 是什麼?

這個 SVG 手繪流程圖建立技能,能將使用者對流程、系統或工作流程的文字或口頭描述,轉換為美觀、具有手繪風格的 SVG 流程圖。輸出結果看起來就像是用彩色馬克筆在白板上的隨手塗鴉,而不是死板的商業圖表。它支援多種預設長寬比(16:9、4:3、1:1、A4、A4 橫向)以及自訂比率,並會根據所選比例自動調整佈局方向,例如寬螢幕採用從左到右的流向,直立格式則採用從上到下的流向。核心技術是使用 SVG 的 `feTurbulence` 和 `feDisplacementMap` 濾鏡組合來產生手繪的晃動邊緣效果,搭配交叉陰影填滿圖案以及指定的手寫字型(中文用 Ma Shan Zheng,英文用 Comic Sans MS)。此技能可用於 Claude Code 等 AI 編碼代理,其運作方式包含一個結構化的六步驟工作流程:理解與分解使用者的描述、決定長寬比、規劃佈局、產生具有手繪風格的 SVG、自動驗證所有連線箭頭(這是關鍵步驟,避免箭頭消失),最後輸出並根據使用者意見反覆迭代。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

SVG 手繪流程圖建立器

你可以將使用者對流程、系統或工作流程的口頭/書面描述,轉化為美觀的 手繪風格 SVG 流程圖。輸出結果應該看起來像是某人用彩色馬克筆在 白板上隨手畫出來的 — 而不是死板的商業圖表。

長寬比

每個 SVG 都必須有定義好的長寬比。使用者可以明確指定,否則預設為 16:9(適合簡報使用)。長寬比決定了 <svg> 元素的 viewBox 和 width/height 屬性。

預設值

名稱比例典型 viewBox最佳用途
16:916:90 0 1600 900投影片、簡報、寬螢幕顯示
4:34:30 0 1200 900傳統投影片、文件
1:11:10 0 1000 1000社群媒體、方形縮圖
A4~1:1.4140 0 1000 1414可列印文件、直式海報
A4-landscape~1.414:10 0 1414 1000可列印橫式文件

自訂比例

使用者可以指定任何 W:H 比例(例如 3:2、21:9)。計算 viewBox 時, 應將較長邊縮放到約 1400-1600 像素,較短邊則依比例縮放。

長寬比如何影響佈局

  • 寬格式(16:9、21:9):偏好從左到右的流向。水平空間較多, 可以舒適地在一行放置 4-6 個元素。垂直堆疊會浪費空間。
  • 高格式(A4、9:16):偏好從上到下的流向。充分利用垂直空間; 每行水平元素限制在 2-3 個。
  • 正方形(1:1):平衡 — 適合放射狀佈局和 2×2/3×3 網格。 適合沒有強烈方向性的概念圖。
  • 4:3:良好的中間選擇。兩種方向都適用,但稍微偏好水平方向。

在步驟 2 規劃佈局時,務必先檢查長寬比,並選擇能自然利用可用空間的 佈局方向。不要強行將從左到右的流向塞進直式畫布,或將從上到下的流向 塞進寬螢幕畫布。

預設行為

如果使用者沒有指定比例,則使用 16:9 — 它適用於大多數圖表,並且 可以立即用於簡報。如果內容明顯需要不同的比例(例如一個非常高的階層結構), 可以建議更改,但不要默默地覆蓋。

整體工作流程

  1. 理解與分解 — 將使用者的描述解析為離散的模組/步驟/角色
  2. 決定長寬比 — 使用使用者指定的比例,或預設為 16:9
  3. 規劃佈局 — 決定視覺結構,並根據長寬比進行調整
  4. 產生 SVG — 撰寫具有手繪風格和正確 viewBox 的簡潔 SVG 程式碼
  5. 驗證箭頭 — 自我檢查每個節點之間的連線都有可見的箭頭
  6. 輸出與迭代 — 提供檔案路徑給使用者,並根據反饋進行優化

步驟 1:理解與分解

當使用者描述一個流程時,請提取:

  • 角色 — 參與者是誰?(例如「PM」、「系統」、「使用者」)
  • 階段 — 主要的分組是什麼?(例如「輸入階段」、「處理階段」)
  • 步驟 — 每個階段的個別操作是什麼?
  • 連線 — 流程如何進行?順序?分支?反饋迴圈?

如果描述不明確,請在繪製前提出澄清問題。

步驟 2:規劃佈局

選擇符合流程結構的佈局:

  • 從上到下:簡單的順序流程
  • 從左到右的區段:當有不同階段相互交接時
  • 分組框:當不同角色擁有不同的步驟集時
  • 反饋迴圈:使用包圍在外側的虛線箭頭

在撰寫 SVG 座標前,先在腦中草擬粗略的邊界框:

  • 為每個區段提供足夠空間(通常每個主要群組約 400×500 像素)
  • 在元素之間預留 40-60 像素的間隙給箭頭
  • 規劃一個能容納所有內容並留有 30-50 像素邊距的畫布尺寸

步驟 3:產生 SVG — 核心技術

3.1 手繪效果:feTurbulence + feDisplacementMap 組合

這是草圖風格的關鍵。它使用 Perlin 噪聲來位移像素,使直線和銳角 看起來像是手繪的。

<defs>
  <!-- 用於形狀(方框、橢圓、大型容器)— 中等晃動 -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

重要:請勿對箭頭/連線線套用任何濾鏡。 feDisplacementMap 濾鏡 即使比例很小,也會導致細線在大多數 SVG 渲染器中變得不可見或斷裂。 箭頭必須在沒有任何濾鏡屬性的情況下繪製。箭頭的手繪感來自於使用 stroke-width="3" 或更粗的線條,這在與帶濾鏡的形狀並列時已經 看起來足夠自然。

3.2 陰影填充圖案

對角線圖案模擬手繪的交叉陰影:

<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

為了可讀性,將陰影圖案與半透明的純色填充圖層疊加:

<!-- 陰影圖層 -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- 可讀性疊加層 -->
<rect ... fill="#dbeafe" opacity="0.25"/>

為圖表中使用的每種顏色主題建立一個陰影圖案。

3.3 手寫字型 — 精確使用這些字型,不得替換

所有圖表必須使用一致的字型。請使用這個精確的 <style> 區塊 — 不要 使用 Caveat、Patrick Hand 或任何其他字型。這是硬性要求。

對於包含中文文字的圖表:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* 中文文字 — 馬善政毛筆風格字型 */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* 英文標籤(程式碼名稱、技術術語如 /task-add、Backlog、YAML) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

對於完全使用英文的圖表:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

在中文圖表中,將 class="label-en" 套用於英文文字元素。絕不使用 Caveat、 Patrick Hand、Indie Flower 或任何其他手寫字型 — 中文堅持使用馬善政(Ma Shan Zheng), 英文堅持使用 Comic Sans MS。

3.4 箭頭標記

定義與每個區段主題顏色匹配的彩色箭頭標記:

<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

在連線線上使用 marker-end="url(#arrow-blue)"。對於虛線連線 (表示間接/可選流程),請加上 stroke-dasharray="14 10"。

3.5 形狀詞彙

概念SVG 形狀範例
角色<ellipse>PM、使用者、系統
流程步驟<rect rx="6">/task-add、build step
容器/階段<rect rx="20"> 大型,帶陰影「1. 需求錄入」區段
資料/輸出<path> 平行四邊形Backlog、Report
決策<path> 菱形是/否分支
外部邊界<rect> 帶 stroke-dasharray系統邊界、反饋迴圈

3.6 顏色主題

每個主要區段/角色應有自己的顏色。良好的調色盤:

  • 藍色:stroke="#3b82d0"、fill="#dbeafe"、text="#1e40af"、hatch="#a0c4f0"
  • 橘色/黃色:stroke="#d4920a"、fill="#fef3c7"、text="#92400e"、hatch="#f0d080"
  • 綠色:stroke="#2d8a4e"、fill="#d1fae5"、text="#065f46"、hatch="#5a9e6f"
  • 紫色:stroke="#7c3aed"、fill="#ede9fe"、text="#5b21b6"、hatch="#b4a0e8"
  • 灰色(用於虛線連線器):stroke="#777"

3.7 連接元素 — 箭頭不使用濾鏡

這是最關鍵的部分。斷裂或消失的箭頭會毀掉整個圖表。

規則:

  1. 每個箭頭 <line> 或 <path> 連線器必須有 stroke-width="3" 或更粗
  2. 每個箭頭必須有 marker-end="url(#arrow-xxx)" 屬性
  3. 切勿在任何箭頭上加上 filter="url(#sketchy)" 或 filter="url(#sketchy-line)" — 濾鏡會使細線不可見
  4. 在形狀邊緣與箭頭起點/終點之間留出 5-10 像素的間隙,以便箭頭尖端清晰可見
  5. L 形箭頭必須終止於目標的中心軸 — 如果目標形狀在 x=600 處居中, 則箭頭的最後一個線段必須在 x=600 處結束,而不是在某個偏移位置。 從目標的 cx/cy(對於橢圓)或 x + width/2、y(對於矩形)計算其中心座標
  6. 箭頭標籤不得與箭頭線重疊 — 將標籤放置在箭頭路徑上方或下方 15-20 像素處, 絕不能放在與水平箭頭相同的 y 座標或與垂直箭頭相同的 x 座標
<!-- 實線箭頭(直接流程)— 無濾鏡屬性 -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#arrow-blue)"/>

<!-- 虛線箭頭(間接/可選流程)— 無濾鏡屬性 -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#arrow-gray)"/>

<!-- L 形或曲線路徑 — 無濾鏡屬性 -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#arrow-green)"/>

步驟 4:驗證箭頭(自我檢查)

在撰寫 SVG 後,你必須在儲存檔案前驗證每個連線。這個步驟 能捕捉最常見且最具破壞性的缺陷 — 缺少箭頭。

程序:

  1. 列出所有連線:返回步驟 1 的分解結果,並列舉每一個 應該存在的箭頭。將它們寫成檢查清單:

    連線檢查清單:
    - [ ] 節點 A → 節點 B (下單)
    - [ ] 節點 B → 節點 C (處理訂單)
    - [ ] 節點 C → 節點 D (支付成功)
    ...
    
  2. 對於每個連線,在 SVG 中驗證:存在一個 <line> 或 <path> 元素, 其座標從來源節點的底部/右側邊緣到目標節點的頂部/左側邊緣, 並且它具有 marker-end 屬性。

  3. 檢查濾鏡污染:在 SVG 中搜尋任何包含 filter= 的 <line 或連線器 <path。 如果找到,從該元素中移除 filter 屬性。

  4. 檢查座標合理性:對於每個箭頭,驗證:

    • 起點 (x1,y1) 靠近來源形狀的底部/右側邊緣
    • 終點 (x2,y2) 靠近目標形狀的頂部/左側邊緣
    • 對於 L 形路徑,最後一個線段必須在目標形狀的中心 x 或 y 處結束
    • 起點和終點不同(不是零長度線條)
  5. 檢查標籤放置:對於每個箭頭標籤文字元素,驗證:

    • 標籤的 y 至少在箭頭 y 座標上方或下方 15 像素處(對於水平箭頭)
    • 標籤的 x 至少在箭頭 x 座標左側或右側 15 像素處(對於垂直箭頭)
    • 標籤不與任何形狀框重疊

如果缺少任何連線,請在儲存前補上。

步驟 5:輸出與迭代

  1. 撰寫前檢查檔案是否存在:儲存前,檢查目標檔案是否已存在。 如果是,請加上版本後綴以避免覆蓋:

    • 第一個檔案:flowchart.svg
    • 如果 flowchart.svg 存在:另存為 flowchart-v1.svg
    • 如果 flowchart-v1.svg 也存在:另存為 flowchart-v2.svg
    • 持續增加直到找到未使用的檔名
    • 使用 ls 或 test -f 在寫入前檢查是否存在
  2. 將 SVG 寫入確定的檔案路徑

  3. 將 SVG 轉換為 PNG 並進行視覺自我檢查:請勿立即為使用者開啟檔案。 而是先轉換並檢查結果:

    rsvg-convert input.svg -o output.png
    

    然後使用讀取工具檢視生成的 PNG 圖像。仔細檢查是否:

    • 佈局問題:元素是否重疊?是否有文字被裁剪或溢出容器? 是否有過大的空白間隙或擁擠的區域?
    • 箭頭問題:所有箭頭是否都可見?是否有箭頭指向錯誤的方向、 穿過形狀或看起來斷開/損壞?
    • 文字可讀性:文字是否清晰可讀且不與其他元素重疊?
    • 整體平衡:圖表在畫布內看起來比例是否良好?

    如果發現任何問題,請返回並修正 SVG,重新轉換,然後重新檢查。 重複直到圖表通過視覺檢查。

  4. 一旦圖表通過檢查,通知使用者 SVG 和 PNG 檔案已準備就緒, 並提供檔案路徑。請勿使用 open — 使用者可能使用遠端伺服器。

  5. 準備好接收反饋 — 常見的要求包括:

    • 「這個框太小了」→ 增加尺寸並重新定位
    • 「箭頭斷了」→ 移除箭頭上的任何濾鏡,增加 stroke-width
    • 「字體不夠手寫」→ 驗證 Google Fonts 匯入,檢查確切的 font-family 字串
    • 「顏色太淡/太深」→ 調整透明度與描邊顏色
    • 佈局重新安排 → 重新計算座標

常見陷阱

  • 箭頭消失:頭號問題。切勿將 filter 套用於 <line> 或箭頭 <path>。 位移濾鏡會使細元素不可見。只有形狀(<rect>、<ellipse>、 容器 <path>)才應使用濾鏡。
  • 字型不一致:中文始終使用 Ma Shan Zheng,英文始終使用 Comic Sans MS。 切勿用 Caveat、Patrick Hand、Indie Flower 等取代。
  • 文字看起來不像手寫:Google Fonts @import 需要網路連線。

相關技能