draw.io 圖表繪製技能
使用時機
- 使用者要求流程圖、流程圖或工作流程圖
- 使用者要求 ERD、資料庫圖或實體關係模型
- 使用者要求架構圖、系統圖或元件圖
- 使用者要求類別圖、循序圖或 UML 圖
- 使用者說「draw.io」、「圖表」、「流程圖」或「將此流程視覺化」
- 使用者要求更新、修復或擴展現有的
.drawio檔案
強制 — 在產生任何內容前請先閱讀
- 先偵測圖表類型 — 在撰寫 XML 前,先參閱 diagram-types 參考檔案
- 套用通用盒狀樣式標準 — 參閱
references/box-style-standards.md - 所有位置皆為硬編碼 — draw.io XML 中無自動佈局功能
- 每次匯出後執行視覺審查循環 — 參閱
references/visual-review-protocol.md - 未通過視覺檢測前,不得宣告完成 — 匯出 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— 請使用
作為換行符 - 所有多行內容方塊均設定
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>