draw-io

draw-io 技能提供了一套完整的工具箱，用於直接在程式庫中管理架構圖、系統流程圖和技術文件。此技能專為開發人員和架構師設計，能夠對 .drawio XML 檔案進行程式化操作，確保複雜圖表、時序圖和基礎設施模型的一致性。透過將圖表視為程式碼 (diagrams as code)，此技能簡化了版本控制流程，並能自動產生高品質的視覺內容，適用於簡報和文件說明。

• 精確的座標與幾何操作：透過 XML 基礎結構調整 draw.io 元素，確保排版精準與視覺清晰度。

• 自動化轉換管線：利用 pre-commit 勾點將原始 .drawio 檔案轉換為高解析度、透明背景的 PNG，適用於 Quarto 簡報與 README 文件。

• 標準化樣式與字體管理：包含針對 Noto Sans JP 的特定配置，以及針對 PDF 與螢幕閱讀優化的自適應字體大小調整。

• 進階排版策略：包含元素分組、透過系統到元件層級的漸進式揭露，以及標準化箭頭放置，提升技術圖表的易讀性。

• 完整的 AWS 圖示支援：遵循專業設計原則，例如確保足夠的留白邊距，並透過換行與偏移調整優化標籤位置。

• 原始 workflow 主要基於 XML 編輯，需特別注意 mxGeometry 與 style 屬性設定。

• 務必透過執行轉換腳本來驗證輸出，確保排版調整不會造成元素重疊或內容裁切。

• 為獲得最佳效果，建議針對網頁或 PDF 使用 1.5 倍字體縮放，並優先使用透明背景以確保與各種簡報主題的相容性。

• 請遵循座標計算規則，特別確保內部元素在父框架內保持至少 30 像素的間距。

• 請勿直接編輯產生的 .drawio.png 檔案；僅依賴自動化轉換流程，以確保原始檔案作為唯一真實來源 (Source of Truth) 的完整性。