Agents365-ai/drawio-skill

何を解決するか

drawio-skill は、自然言語、既存のコードベース、またはインフラ構成から、プロフェッショナルで編集可能な図を生成できるようにします。draw.io で図形を手動でドラッグ＆ドロップする手間を省き、.drawio XML ファイルのレイアウトと作成を自動化し、さまざまな画像形式にエクスポートできます。

動作方法

このプロジェクトは、Claude Code や Cursor などの AI エージェント用のスキルとして機能し、ネイティブの draw.io デスクトップ CLI と連携します。抽出器とレイアウトエンジンのパイプラインを使用して、入力を構造化された図に変換します：

• 自然言語： AI エージェントがプロンプトを図の仕様に翻訳します。
• コード／インフラインポート： Python、JS-TS、Go、Rust、Terraform、Kubernetes、docker-compose ファイル、または ER 図用の SQL DDL から構造を抽出する専用スクリプトがあります。
• レイアウトエンジン： Graphviz を使用してノードの配置と直交エッジルーティングを行い、重なりや「ヘアボール」状態を回避します。
• 精緻化： 自己チェック機構を備えており、出力された PNG を読み取り、重なりや切り取られたラベルを自動で修正します。
• 変換： Mermaid テキストをネイティブで編集可能な .drawio ファイルに変換できます。

対象ユーザー

• ソフトウェアアーキテクト： ドリルダウン可能な複雑なマイクロサービス、クラウドインフラ、C4 モデルを可視化するため。
• 開発者： コードやデータベーススキーマからクラス階層、インポートグラフ、ER 図を自動生成するため。
• DevOps エンジニア： Infrastructure-as-Code (IaC) ファイルを公式クラウドアイコンを使ってアーキテクチャ図に変換するため。
• C4 モデル実践者： リンクされたコンポーネントを持つ複数ページのシステムドキュメントを作成するため。

特徴

• 広範な図のサポート： ERD、UML、C4、SysML、BPMN、ネットワークトポロジーなど、11種類のプリセットを提供。
• コードから図への変換： 複数の言語および IaC マニフェストからプロジェクト構造を自動抽出。
• クラウドアイコン統合： AWS、Azure、GCP、Kubernetes の公式アイコンを自動解決。
• AI/LLM ブランドロゴ： standard draw.io にはない 321 種類の現代的な AI ツール（OpenAI、Claude、LangChain など）のロゴを含む。
• 高度なレイアウト： パイプラインの旅に適した「Tube-Map Mode」や、決定論的なシーケンス図をサポート。
• 反復的 AI ループ： 最大 5 ラウンドのターゲットド refine と視覚的自己修正をサポート。
• 多形式エクスポート： draw.io CLI を通じて PNG、SVG、PDF、JPG にエクスポート可能。