Community寫作與編輯github.com

Spotlight-Revenue/drawio-diagrammer-skill

生成美觀的 draw.io 圖表,並搭配強制性的視覺 QA 循環,讓你的 AI 代理能夠建立真正看起來正確的圖表。

drawio-diagrammer-skill 是什麼?

此技能讓 AI 代理能夠直接產生專業等級的 draw.io 圖表,從流程圖、架構圖到 UML 圖表,一應俱全。其核心特點在於強制執行「視覺審查循環」:代理在生成 XML 後,會自動匯出 PNG,並依照嚴格的視覺檢查協議進行比對,確保圖表佈局、間距與樣式都符合規範後才算完成。此技能支援 macOS 與 Linux 環境,並提供詳細的參考檔案(如盒狀樣式標準、各圖表類型指南)來強制輸出的一致性。對開發者而言,此技能解決了 AI 生成圖表常見的「看起來不對」問題,透過結構化的流程與反覆迭代,顯著提升圖表品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

draw.io 圖表繪製技能

使用時機

  • 使用者要求流程圖、流程圖或工作流程圖
  • 使用者要求 ERD、資料庫圖或實體關係模型
  • 使用者要求架構圖、系統圖或元件圖
  • 使用者要求類別圖、循序圖或 UML 圖
  • 使用者說「draw.io」、「圖表」、「流程圖」或「將此流程視覺化」
  • 使用者要求更新、修復或擴展現有的 .drawio 檔案

強制 — 在產生任何內容前請先閱讀

  1. 先偵測圖表類型 — 在撰寫 XML 前,先參閱 diagram-types 參考檔案
  2. 套用通用盒狀樣式標準 — 參閱 references/box-style-standards.md
  3. 所有位置皆為硬編碼 — draw.io XML 中無自動佈局功能
  4. 每次匯出後執行視覺審查循環 — 參閱 references/visual-review-protocol.md
  5. 未通過視覺檢測前,不得宣告完成 — 匯出 PNG,讀取它,修正它,重複執行

圖表類型偵測

使用者說...參考檔案
「流程圖」、「流程」、「步驟」、「工作流程」、「SOP」references/diagram-types/flowchart.md
「ERD」、「資料庫」、「資料表」、「實體」、「外鍵」references/diagram-types/erd.md
「架構」、「系統」、「元件」、「服務」references/diagram-types/layout.md
「類別」、「UML」、「繼承」、「方法」、「屬性」references/diagram-types/class.md
「循序」、「互動」、「生命線」、「角色呼叫」references/diagram-types/sequence.md

標準產生工作流程

步驟 1 — 載入類型參考

在撰寫任何 XML 之前,先讀取正確的 references/diagram-types/ 檔案。

步驟 2 — 規劃所有元素

在編寫程式碼之前,列出每個節點、連線和區塊。不要在構建過程中臨時調整佈局。

步驟 3 — 套用通用盒狀樣式

每個節點都必須包含來自 references/box-style-standards.md 的通用間距屬性。

步驟 4 — 建立輸出資料夾並寫入 XML

mkdir -p ./diagrams

儲存至:

./diagrams/<diagram-name>.drawio

儲存前檢查清單:

  • 所有 mxCell 元素都有唯一的序號數字 ID
  • 每個節點樣式已套用通用盒狀間距:spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • 箭頭使用鏈式路由,而非從單一來源扇出至多個目標
  • 任意兩個方塊之間至少有 15–20px 的間距(驗證子項目清單底部與下一個區塊頂部)
  • 高度採用 box-style-standards.md 中的公式計算(字型大小 10 時,每行 ×16px)
  • 寬文字面板(備註、描述)至少 530px 寬 — 不能是 460px 或更小
  • 值屬性中不得使用文字 \n — 請使用 &#xa; 作為換行符
  • 所有多行內容方塊均設定 verticalAlign=top

步驟 5 — 匯出 PNG 並執行視覺審查循環

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio

接著依照 references/visual-review-protocol.md 中的完整協定執行。

步驟 6 — 交付

先將 PNG 傳送給使用者。對於較大的圖表,請先傳送區塊截圖(上方、中間、下方),再傳送完整圖片。

接著詢問他們想要哪些其他格式:

圖表已備妥。您想要哪些格式?

1 — PNG 圖片(可直接檢視)
2 — .drawio 檔案(可在 draw.io 中編輯)
3 — SVG(可縮放向量圖形)
4 — PDF
5 — 以上全部

請回覆您選擇的編號。

如需透過 Google Drive 交付或自訂輸出路徑,請參閱 references/workflow-sop.md。


CLI 參考

# macOS — 匯出 PNG(標準)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# macOS — 匯出高解析度 PNG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>

# macOS — 匯出 SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>

# macOS — 匯出 PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>

# Linux / 無頭模式 — 匯出 PNG
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# Linux / 無頭模式 — 匯出 SVG
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>

相關技能