draw.io 図作成スキル
このスキルを使用するタイミング
- ユーザーがフローチャート、プロセスマップ、ワークフロー図を要求した場合
- ユーザーがERD、データベース図、エンティティ関連モデルを要求した場合
- ユーザーがアーキテクチャ、システム、コンポーネント図を要求した場合
- ユーザーがクラス図、シーケンス図、UML図を要求した場合
- ユーザーが「draw.io」、「図」、「フローチャート」、「このプロセスを可視化」と言った場合
- ユーザーが既存の
.drawioファイルの更新、修正、拡張を依頼した場合
必須 — 何かを生成する前に必ず読むこと
- 最初に図の種類を検出する — XMLを書く前に
diagram-types/のリファレンスを参照すること - ユニバーサルボックススタイル標準を適用する —
references/box-style-standards.mdを参照 - すべての位置はハードコードされている — draw.io XMLには自動レイアウトは存在しない
- エクスポート後は必ずビジュアルレビューループを実行する —
references/visual-review-protocol.mdを参照 - 視覚的な確認なしに完了と宣言しない — 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は使用しない — 改行には
を使用 - 複数行コンテンツのボックスには
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>