drawio-diagrams

drawio-diagrams

目標

高品質な draw.io ／ diagrams.net の図を作成、編集、検証、納品し、編集可能な .drawio ファイルとして提供します。ライトモードとダークモードの両方で動作する、自己完結型の図を優先してください。

最初の応答に関する要件

最初の実質的な応答では、作成に取りかかる前に、選択可能な表示形式を提示してください。design_profile（technical、operator-grid、isometric-air、neon-hub、aurora-story、または adapted-<short-name>）、theme_mode（adaptive、light、または dark）、animation（on、off、または preserve）、アイコンモード（未解決のノードまたは汎用ノードには、セマンティックな代替アイコンを使う official-first）を含めます。選択したプロファイルとスタイル設定を明示してください。依頼の内容に重大な曖昧さがある場合に限り、質問してください。これらの選択肢を納品まで伏せてはいけません。

公式アイコンおよびロゴの方針

利用可能で、図の表記法にも適合する場合は、組織、製品、サービスの公式アートワークを優先してください。汎用、ベンダー中立、または未解決のノードに限り、セマンティックなグリフを使用してください。元のアートワーク、ブランドカラー、比率、viewBox、バリエーションを維持してください。公式のマークに、任意の着色、色変更、単色化、反転、フィルター処理、切り抜き、引き伸ばし、スタイル変更を加えてはいけません。周囲のニュートラルな面でコントラストを確保してください。ノードごとの代替内容を記録し、明示的に依頼された場合、またはアクセシビリティ上必要な場合に色を変更したことを開示してください。

使用する場面

アーキテクチャ図、フローチャート、シーケンス図、ER／UML／状態図、BPMN、SysML、ML／DL、スイムレーン、タイムライン、ネットワーク図、C4 形式の図、アイコンを多用した技術的なビジュアルなど、draw.io の図の作成、描画、生成、編集、修復、変換、検証、エクスポートを依頼された場合に、このスキルを使用してください。

使用しない場面

ユーザーが draw.io の図を明示的に希望していない限り、棒グラフ、折れ線グラフ、円グラフ、データ分析のプロット、写真の編集、芸術作品、編集できないイラストには使用しないでください。

ワークフローの選択

直接呼び出された場合は、以下の4つのワークフローを必ず提示します。

• create：新しい図を作成する、または提供された意味情報を編集可能な draw.io に変換します。
• edit-repair：既存の .drawio ファイルを編集、修復、または意図的にスタイル変更します。
• review：意味、構造、検証、または見た目を読み取り専用で評価します。
• export：再設計せず、すでに問題のない .drawio ソースをエクスポートします。

auto ワークフローはありません。タスクの意図と権限のみから推測します。

• 新しい図の作成、または意味情報の編集可能な図への変換を行う場合は、create を選択します。
• 既存の図を編集、修復、または意図的にスタイル変更する場合は、edit-repair を選択します。
• 変更の依頼を伴わない意味、構造、検証、または見た目の評価には、review を選択します。
• 再設計せず、すでに問題のない .drawio ソースをエクスポートする場合は、export を選択します。

直接的な意図が明確な場合は、4つのワークフローすべて、選択したワークフローとその理由、入力、依頼された出力、デザインプロファイル、テーマ／アニメーション／アイコンのモード、推奨する作成・レンダリング経路（direct-xml | transactional-native | approved-raw-cli-manual | fixed-theme-browser-raster | browser-url-preview | html-viewer-preview）、書き込み範囲、想定される成果物、保護対象ファイル、後続の承認境界を示してから作業を進めます。単独の呼び出し、範囲が大きく異なる複数の結果を求める依頼、または未解決のソース／出力先がある場合は、選択肢を提示して質問します。エージェントが自発的に有効化する場合は、確認を求めずに review を選択して、その旨を伝えられます。変更を伴うワークフローを選択できるのは、ユーザーの既存の依頼がその結果と範囲をすでに許可している場合に限られます。インストール、ホストされたコンテンツの転送、ブラウザーでのラスター化、ファイル書き込みのフォールバックヘルパー、破壊的な上書き、有料／外部アクション、範囲の拡大には、それぞれ別途承認が必要です。

意図が明確な場合は、create | edit-repair | review | export と選択した経路を簡潔に開示すれば十分です。すでに会話で決まっている選択内容や詳細を繰り返したり、選択について再度質問したりしないでください。明示された承認を再利用できるのは、対象のアクション、対象物、ツール／プロバイダー、該当する場合は費用、書き込み範囲を引き続き網羅している場合に限られます。承認境界はそれぞれ独立しています。ある操作への許可が、別の操作への許可を意味することはありません。判断が変更された場合、または不足している場合にのみ、再度確認してください。

確認する入力

ワークフローと権限を選択するために必要なプロンプト、依頼された出力、対象読者、質問、範囲、抽象度、プライバシー制約を確認します。選択後、アーキテクチャのソース、既存の .drawio ファイル、現在の状態／目標の状態、アイコン、プロファイル／テーマ、テキスト階層、ルーティング上のリスク、ツール固有の入力を確認する前に、変更を伴わない機能の事前確認を実行します。新しい方向性のあるフローでは、アニメーションをデフォルトで on にします。事前確認では、読み取り専用の scripts/probe-drawio-toolset.mjs [--json] ヘルパーを使用して、Node >= 18、Python、draw.io の候補、ブラウザー／MCP のシグナル、キャッシュを検出します。機能に関する証拠は、許可を意味しません。/proc/self/fd の保証がある Linux ネイティブの draw.io 候補を優先します。probe-drawio-toolset.mjs で候補のバージョンを確認し、古い、または実行できない DRAWIO_BIN の候補は、raw/manual エクスポートのフォールバックに回します。ブラウザーでのラスター化では、絶対パスが固定された実行ファイルを指定する場合に限り、rasterize-themed-svg.mjs を使用します。インストール／セットアップには承認が必要です。機能確認の記録には、サニタイズ済みのパスを使用してください。

ワークフロー

workflow-details.md に記載された詳細な機能レベルの手順と受領手順に従ってください。

1. すでに通知した選択内容と範囲を使用し、新たな証拠によって経路や重要な判断が変わる場合にのみ更新してください。変更を伴うワークフロー／エクスポートのワークフローでは、変更を加えない機能の事前チェックを実行してください。review では事前チェックを省略します。
2. review が選択されている場合は、厳格な読み取り専用の分岐を使用してください。提供されたソースと既存のレンダリング結果を確認し、必要なセマンティックモデルのみを構築して、読み取り専用のバリデーターのみを実行します。バックアップの作成、XML の作成またはパッチ適用、レンダリング、ラスタライズ、エクスポート、ホスト型サービスへの接続、指摘事項の修正は行わないでください。指摘事項と証拠の限界を報告してから戻り、残りのワークフロー手順は実行しないでください。
3. コンパクトなセマンティックモデルを構築し、transactional-native | approved-raw-cli-manual | fixed-theme-browser-raster | browser-url-preview | html-viewer-preview | direct-xml から経路を選択して、コネクターの余白を計画し、編集可能なソースを保持してください。
4. 選択した権限の範囲内でのみ .drawio XML を作成またはパッチ適用してください。選択したプロファイル、公式アイコンを優先する方針、具体的なエッジルーティング、アニメーション方針を適用してください。ユーザーが提供したビジュアル参考資料は、再利用可能なトークンや効果にのみ応用してください。その構図やアセットをコピーしたり、明示的な依頼なしに学習したプロファイルを保存したりしないでください。
5. scripts/preflight-drawio-xml.mjs、scripts/validate_drawio.py <file> --animation on|off|preserve、scripts/validate-drawio-diagram-rules.mjs を実行し、すべての ERROR を修正し、すべての WARN を修正するか、理由を説明してください。
6. セマンティクス、ルーティング、ライトモード／ダークモードのアクセシビリティを自己レビューしてください。承認済みの経路でのみレンダリングし、ソース、要求されたエクスポート、受領記録、証拠の限界、意図的な省略事項を納品してください。

安全規則

単独または曖昧な呼び出しから、変更を加える権限があると推測しないでください。review は厳格な読み取り専用です。指摘事項を報告し、変更を伴うワークフローが承認されるまで待ってください。ツールのインストール、WSL／Windows またはその他の境界をまたぐ実行、ブラウザーの使用、ホスト型サービス／MCP への転送、キャッシュの作成、有料／プロバイダー関連の操作、破壊的な上書き、ファイルを書き込む代替ヘルパーは、それぞれ個別の承認を必要とします。ネイティブ形式の PNG／SVG／PDF 出力が明示的に要求された場合、事前チェックの後に許可されるのは、指定されたネイティブ形式の書き込みのみです。選択した公開 SVG アセットのみを取得し、検証して埋め込んでください。機密性の高い作業ではローカルパスを優先し、シークレット、顧客データ、非公開のリポジトリパス、内部ホスト名は決して含めないでください。

参考資料

• references/workflow-details.md：詳細なワークフロー、機能レベルの手順、アイコンの忠実度、安全性、受領記録の要件に使用します。
• references/xml-authoring.md：XML の直接生成と既存ファイルの編集に使用します。
• references/diagram-type-playbook.md：セマンティックな計画と経路の選択に使用します。
• references/layout-readability.md：アーキテクチャの読みやすさ、コネクターラベルの余白、分岐レーン、間隔、階層、ビジュアルレビューに使用します。
• references/icon-catalog.md：図にアーキテクチャ、ブランド、クラウド、または製品のアイコンが必要な場合に使用します。
• references/routing-and-simplification.md：エッジルーティング、プラス／マイナスによる折りたたみの評価、簡略表示／詳細表示に使用します。
• references/design-profiles.md：ユーザーがテンプレート／スタイルを要求した場合、または成果物にオペレーターグリッド、アイソメトリック、ネオンハブ、オーロラの表現が明らかに必要な場合に使用します。
• references/theming-dark-mode.md：配色とライトモード／ダークモードへの対応に使用します。
• references/toolset-setup.md：オプションのツールの検出や推奨に使用します。
• references/verification-checklist.md：納品前、および自動検証が利用できない場合に使用します。
• references/delivery.md：エクスポートコマンドとブラウザー URL による納品に使用します。

スクリプト

• scripts/preflight-drawio-xml.mjs：Python の lint より前に、禁止された構文がないか読み取り専用で厳密に XML を事前検査します。
• scripts/validate_drawio.py：.drawio／mxGraph XML を読み取り専用で lint します。
• scripts/validate-drawio-diagram-rules.mjs：意味的に浮いたエッジ、コンポーネントアイコンの網羅性、縦横比が固定されたロゴ、経路の交差の可能性を読み取り専用で検査します。
• scripts/render-drawio.mjs：明るいテーマの PNG と暗いテーマの SVG をステージングして検証した後、コミット時の上書き防止チェックを行って両方を配置します。コミットが中断された場合は部分的な出力と復旧用バックアップが保持され、置き換えが正常に完了した場合は、手動でクリーンアップするために保持された復旧用ディレクトリが報告されます。正規のネイティブ PNG／SVG 出力を求める明確な依頼があれば、事前検査後にこれらの名前付きファイルへの書き込みが許可されます。
• scripts/probe-drawio-toolset.mjs [--json]：Python、Node、draw.io の候補、形式のサポート状況、ブラウザー／agent-browser、MCP／ホスト型プレビューの兆候、パッケージマネージャー、環境固有のネイティブインストール案を読み取り専用で調査し、機能と来歴を確認します。パッケージのインストールや設定の書き込みは行いません。範囲を限定した PNG／SVG のスモークエクスポートは一時的に作成され、検証後にプローブの終了前に削除されるため、レンダリング成果物は残りません。
• scripts/rasterize-themed-svg.mjs：ユーザーが選択した絶対パスを通じて、明るいテーマまたは暗いテーマに固定された、自己完結型で範囲が限定された SVG から、上書きしない PNG を 1 つ書き込みます。固定されたローカルの Chrome、Chromium、または Edge 実行ファイルを使用し、埋め込み SVG 画像データを再帰的に調べてアクティブコンテンツやリモートコンテンツがないことを確認し、出力を検証して元の寸法を維持します。使用前にユーザーの明示的な承認が必要です。
• scripts/open-drawio-url.mjs：.drawio ファイル用の読み取り専用ブラウザー URL ビルダー／オープナーです。
• scripts/search-shapes.mjs：設定済みまたは標準キャッシュ内のローカルシェイプインデックスを、厳密一致とファジー検索によるフォールバック順位付けで検索します。

出力形式

選択したワークフローとその根拠、入力、出力、書き込み範囲、保護対象ファイル、作成経路、ツールセット、デザインプロファイル、テーマ／アニメーション／アイコンのモード、アイコンの出典とノードごとの置き換え内容、lint の概要、意味・レイアウト・明暗テーマのレビュー概要、正当な警告を報告してください。作成／編集・修復／エクスポートのレシートには、以下の項目もすべて正確に含めてください。

• Capability status
• Renderer route
• Tool-install approval
• Cross-boundary approval
• Export status
• Visual verification
• Evidence scope
• Fallback (used/offered)

レシートでは、制約も明記してください（生の CLI／手動／Windows ブリッジにはトランザクション保証がないこと、ブラウザープレビューは正規の出力ではないことを含みます）。validate_drawio.py と validate-drawio-diagram-rules.mjs を明示してください。review の場合は、変更を行った、または行うと主張せず、確認した証拠、検出事項、制約、推奨する次のワークフローを報告してください。アーキテクチャの場合は、ビュー／対象範囲、意図的に省略した項目、コネクターレール、ラベルの背景、間隔、アイコンの網羅性も報告してください。サードパーティのロゴまたはアイコンが含まれる場合は、references/delivery.md に記載された責任に関する通知を 1 つ含めてください。依頼がない限り、アイコンごとの法的分析は行わないでください。

完了基準

4 つのワークフローが提示され、タスクに基づく選択とその理由が述べられているか、曖昧さが解消されており、権限が依頼された成果や範囲内に保たれ、機能の事前確認と受領情報の各項目が完了し、選択したワークフローの成果が提示されていれば、タスクは完了です。review は、作成、レンダリング、エクスポート、修正を行わずに、読み取り専用の根拠と所見のレポートが返された時点で完了します。その他のワークフローでは、該当する場合は有効な編集可能 .drawio ファイル、エラーのない決定論的な lint と図のルール、修正済みまたは妥当な理由が示された警告、依頼されたデザインプロファイルとアニメーションポリシー、関連するアイコン／ロゴの網羅、可能な場合は依頼されたエクスポート、そして誠実な自己レビューの報告が必要です。アーキテクチャの作成を完了するには、明確な問い／ビュー／抽象度のレベルが 1 つ定められ、現状／目標の状態、意図的な省略、読みやすいルーティングと階層、そしてユーザーが適用しないことを選択した場合を除き、すべての主要コンポーネントに関連するアイコン／ロゴが必要です。

失敗時の対応

CLI がない場合は、視覚的なエクスポートをスキップし、その旨を伝えてください。MCP が利用できない場合は、XML を直接使用してください。選択した表現豊かなプロファイルが、正式な記法、情報密度、印刷用途、またはアクセシビリティと相反する場合は、意味を保ちながら、最も近い読みやすいプロファイル表現に切り替え、調整内容を説明してください。ブランドロゴを取得または解決できない場合は、そのノードにネイティブの意味的なアイコンを使用し、代替したことを開示してください。残りのロゴセットはそのまま維持してください。ブラウザー URL が長すぎる場合は、.drawio ファイルを納品してください。既存のページが圧縮されている場合は、編集前に展開してください。XML の生成が大きくなりすぎた場合は、ページに分割してください。