Communityライティング&編集github.com

Spotlight-Revenue/drawio-diagrammer-skill

美しいdraw.io図を生成し、強制的なビジュアルQAループで図が実際に正しく見えることを確認します。

drawio-diagrammer-skill とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がdraw.ioを使用してフローチャート、ERD、アーキテクチャ図、UML図などを自動生成するためのものです。単にXMLを出力するだけでなく、図の種類を自動検出し、統一されたボックススタイルとレイアウトルールを適用することで、プロフェッショナルで美しい図を生成します。最大の特徴は、生成後に必ずPNGとしてエクスポートし、その画像を「視覚的にレビュー」して問題(重なり、配置のずれ、余白不足など)を修正するループが組み込まれている点です。これにより、AIが「人間が見て正しい」図を必ず提供できるようになります。macOSおよびLinux環境をサポートし、draw.io CLIを使用してPNG、SVG、PDF形式で出力できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

draw.io 図作成スキル

このスキルを使用するタイミング

  • ユーザーがフローチャート、プロセスマップ、ワークフロー図を要求した場合
  • ユーザーがERD、データベース図、エンティティ関連モデルを要求した場合
  • ユーザーがアーキテクチャ、システム、コンポーネント図を要求した場合
  • ユーザーがクラス図、シーケンス図、UML図を要求した場合
  • ユーザーが「draw.io」、「図」、「フローチャート」、「このプロセスを可視化」と言った場合
  • ユーザーが既存の.drawioファイルの更新、修正、拡張を依頼した場合

必須 — 何かを生成する前に必ず読むこと

  1. 最初に図の種類を検出する — XMLを書く前に diagram-types/ のリファレンスを参照すること
  2. ユニバーサルボックススタイル標準を適用する — references/box-style-standards.md を参照
  3. すべての位置はハードコードされている — draw.io XMLには自動レイアウトは存在しない
  4. エクスポート後は必ずビジュアルレビューループを実行する — references/visual-review-protocol.md を参照
  5. 視覚的な確認なしに完了と宣言しない — PNGをエクスポートし、読み取り、修正し、繰り返す

図の種類の検出

ユーザーが言ったキーワード参照ファイル
「フローチャート」、「プロセス」、「ステップ」、「ワークフロー」、「SOP」references/diagram-types/flowchart.md
「ERD」、「データベース」、「テーブル」、「エンティティ」、「外部キー」references/diagram-types/erd.md
「アーキテクチャ」、「システム」、「コンポーネント」、「サービス」references/diagram-types/layout.md
「クラス」、「UML」、「継承」、「メソッド」、「属性」references/diagram-types/class.md
「シーケンス」、「インタラクション」、「ライフライン」、「アクター呼び出し」references/diagram-types/sequence.md

標準生成ワークフロー

ステップ 1 — タイプリファレンスを読み込む

XMLを書き始める前に、適切な references/diagram-types/ ファイルを読むこと。

ステップ 2 — すべての要素を計画する

コーディング前に、すべてのノード、接続、セクションをリストアップする。構築途中でレイアウトを即興で変更しないこと。

ステップ 3 — ユニバーサルボックススタイルを適用する

すべてのノードに、references/box-style-standards.md で定義されたユニバーサルな間隔属性を含めること。

ステップ 4 — 出力フォルダを作成し、XMLを書き込む

mkdir -p ./diagrams

保存先:

./diagrams/<図名>.drawio

保存前のチェックリスト:

  • すべての mxCell 要素に一意で連続した数値IDが設定されている
  • すべてのノードスタイルにユニバーサルボックス間隔が適用されている: spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • 矢印は、単一ソースから多数のターゲットへのファンアウトではなく、チェーンルーティングを使用している
  • 任意の2つのボックス間に最低15~20pxのギャップがある(サブアイテムリストの下端と次のセクションの上端を確認)
  • 高さは box-style-standards.md の計算式(fontSize=10 で1行あたり×16px)に従って計算されている
  • 幅広テキストパネル(メモ、説明)は530px以上 — 460px以下ではない
  • value属性にリテラルの \n は使用しない — 改行には &#xa; を使用
  • 複数行コンテンツのボックスには verticalAlign=top を設定

ステップ 5 — PNGをエクスポートし、ビジュアルレビューループを実行する

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<name>.png --scale 2 --border 30 ./diagrams/<name>.drawio

その後、references/visual-review-protocol.md の完全なプロトコルに従うこと。

ステップ 6 — 納品する

まずPNGをユーザーに送信する。大きな図の場合は、セクションごとのスクリーンショット(上部、中央、下部)を先に送ってから全体像を送ること。

次に、希望する追加フォーマットを尋ねる:

図の準備ができました。どの形式をご希望ですか?

1 — PNG画像(すぐに閲覧可能)
2 — .drawioファイル(draw.ioで編集可能)
3 — SVG(スケーラブルベクター)
4 — PDF
5 — 上記すべて

ご希望の番号を入力してください。

Google Driveへの配信やカスタム出力パスについては、references/workflow-sop.md に従うこと。


CLI リファレンス

# macOS — PNGエクスポート(標準)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# macOS — 高解像度PNGエクスポート
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <file.drawio>

# macOS — SVGエクスポート
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <file.drawio>

# macOS — PDFエクスポート
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <file.drawio>

# Linux / ヘッドレス — PNGエクスポート
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <file.drawio>

# Linux / ヘッドレス — SVGエクスポート
xvfb-run -a drawio --export --format svg --output <out.svg> <file.drawio>

関連スキル