sparklabx/drawio-ai-kit

解決的問題

AI代理在建立準確的 draw.io 圖表時經常遇到困難，經常幻覺出不存在的模板ID，或未能遵循架構佈局標準。此工具包提供一個框架，確保AI生成的圖表在結構上精確、視覺上標準化，並使用有效的雲端架構模板。

工作原理

本專案採用三管齊下的方法來引導AI代理：

1. 宣告式目錄：一個可信的來源，將 draw.io 模板ID對應到正確的分類與顏色，防止AI虛構形狀。
2. 設計原則：AI必須遵循的一組形式化架構與佈局規則。
3. 結構驗證引擎：一個靜態分析引擎，審計圖表XML，確保模板引用有效且設計原則獲得遵守，才最終定稿檔案。

代理透過零相依CLI（drawio-ai）與這些工具互動。系統也支援一個佈局引擎，能根據定義的拓撲（例如網路、流程或網狀）以程式方式計算空間座標，而非要求AI猜測原始像素座標。

適用對象

使用AI代理（如Claude Code或Gemini CLI）自動建立AWS、Azure、GCP與Databricks架構圖，以及BPMN流程圖的雲端架構師與開發者。

主要特色

• 多雲支援：針對AWS、Azure、GCP與Databricks的專用領域技能。
• 零相依CLI：一個自包含工具，可用於搜尋模板、驗證XML與渲染圖表。
• 自動佈局：根據邏輯拓撲自動處理尺寸與間距的佈局引擎。
• 視覺導向修正：支援「渲染-分析-修正」循環，AI可將圖表渲染為PNG，並利用視覺能力進行自我修正。