Agents365-ai/drawio-skill

解決的問題

drawio-skill 允許使用者從自然語言、現有程式碼庫或基礎設施設定中生成專業且可編輯的圖表。它透過自動化 .drawio XML 檔案的佈局與建立，消除了在 draw.io 中手動拖曳圖形的繁瑣工作，生成的檔案可匯出為多種影像格式。

工作原理

此專案作為 AI 代理（如 Claude Code 或 Cursor）的技能，與原生 draw.io 桌面 CLI 進行互動。它使用提取器與佈局引擎的流程，將輸入轉換為結構化圖表：

• 自然語言： AI 代理將提示轉換為圖表規格。
• 程式碼/基礎設施匯入： 專用腳本可從 Python、JS-TS、Go、Rust、Terraform、Kubernetes 和 docker-compose 檔案，或用於 ER 圖的 SQL DDL 中提取結構。
• 佈局引擎： 使用 Graphviz 進行節點定位與正交邊路由，避免重疊與「毛球」現象。
• 優化： 工具包含自檢機制，可讀取自身產生的 PNG 輸出，自動修復重疊與截斷的標籤。
• 轉換： 支援將 Mermaid 文字轉換為原生、可編輯的 .drawio 檔案。

適用對象

• 軟體架構師： 可用於可視化複雜的微服務、雲端基礎設施與 C4 模型，並支援下探檢視。
• 開發者： 可從程式碼與資料庫模式中自動產生類別階層、匯入圖與 ER 圖。
• DevOps 工程師： 可將基礎設施即程式碼（IaC）檔案轉換為使用官方雲端圖示的架構圖。
• C4 模型實踐者： 可建立包含連結元件的多頁系統文件。

主要亮點

• 廣泛的圖表支援： 提供 11 種預設，包括 ERD、UML、C4、SysML、BPMN 與網路拓撲。
• 程式碼轉圖表： 可從多種語言與 IaC 清單中自動提取專案結構。
• 雲端圖示整合： 自動解析官方 AWS、Azure、GCP 與 Kubernetes 圖示。
• AI/LLM 品牌圖示： 包含 321 個標準 draw.io 中未提供的現代 AI 工具圖示（如 OpenAI、Claude、LangChain 等）。
• 高階佈局： 支援「地鐵圖模式」用於流程圖，以及決定性序列圖。
• 迭代式 AI 循環： 支援最多 5 輪針對性優化與視覺自修正。
• 多格式匯出： 透過 draw.io CLI 匯出為 PNG、SVG、PDF 與 JPG。