Agents365-ai/drawio-skill

Agent skill that turns natural language, code, Terraform/K8s, SQL, OpenAPI, AsyncAPI, Protobuf and GraphQL sources into editable, tested draw.io architecture diagrams: incremental sync, multi-view projection, drift diff, CI architecture tests, whiteboard derasterize, interactive HTML/PPTX/Mermaid exports.

解決する課題

このプロジェクトは、プロフェッショナルなアーキテクチャ図の作成と保守を自動化します。自然言語のプロンプトや既存のコードベースと、編集可能な .drawio ファイルとの間のギャップを埋め、複雑なシステム図を手動で描画・更新する手間を解消します。

仕組み

このツールは、LLM を活用したコーディングアシスタント(Claude Code や Cursor など)と統合できるエージェントスキルとして機能します。マルチステップのパイプラインを使用し、リクエストの解釈やソースコード(Terraform、Kubernetes 設定、Python クラスなど)の分析を行い、レイアウトを計画し、.drawio XML を生成して、視覚的な出力に対して自己修正を行います。また、既存インフラのインポート、CI でのアーキテクチャルールの強制、手動のレイアウト調整を損なうことなく図の変更を同期するための CLI ツールスイートも含まれています。

対象ユーザー

手動の描画ツールによるオーバーヘッドなしで、システムのドキュメント化、コード構造の可視化、またはコードとしてのアーキテクチャ図管理を行いたいソフトウェアエンジニア、アーキテクト、DevOps プロフェッショナル向けに設計されています。

ハイライト

  • 自動生成: 自然言語のプロンプトやコードソース(Python, Go, Rust, Terraform, K8s)を、構造化された編集可能な図に変換します。
  • インクリメンタル同期: コードの変更に基づいて図を更新しつつ、手動で行ったレイアウトやスタイルの調整を保持します。
  • アーキテクチャ・アズ・コード: CI/CD パイプラインにおいて、視覚的な差分表示を伴うアーキテクチャルール(依存関係の循環、信頼境界など)の強制を行います。
  • 広範なエコシステム: 11 種類以上の図タイプ(C4, UML, ERD など)をサポートし、10,000 以上の公式アイコンと、モダンな技術スタック向けの 321 個の AI/LLM ブランドロゴを提供します。
  • エージェント互換性: MCP サーバーまたはスタンドアロンの CLI として機能し、Claude Desktop や Cursor などの主要な AI コーディングエージェントと互換性があります。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト