Drawio Visuals Skill (Drawio ビジュアルスキル)

サーバー、MCP、固定テンプレート、Scene IR、カスタムレンダラーを使用せずに、ネイティブでユーザー編集可能な Drawio ファイルを作成、再構築、編集します。

デフォルトはオブジェクト、テキストモジュールではありません

新しい説明フロー（プロセス、パイプライン、スイムレーン、要求ライフサイクル、アーキテクチャフロー）では、デフォルトで認識可能な編集可能オブジェクトと可視化された変更を使用します。「ワークフローを描いて」のような単純な要求でこのルールが適用されます。ユーザーが「絵で」「具体的に」「図解して」と明示する必要はありません。図の種類は、このビジュアル処理とは別に選択してください。

ノードを配置する前に、何が動き、何が変化し、誰が行動するかを特定します。次に、主要なビジネスオブジェクトと処理段階ごとに、シルエット、意味のある内容、または小さなオブジェクトシーンを選択します。キューには個別のタスクカードと吸入口/排出口があります。パーサーはドキュメントが抽出されたパーツになる様子を示します。返金は保留中の資金と返金済み資金を区別します。これらのネイティブパーツを最初に描き、次に短い名前やアクションを追加します。ステップ名を含む矩形の連続は、ラベルが短くレイアウトがすっきりしていても、このデフォルトを満たしません。繰り返しのサーバーラック、絵文字、散文カード上の無関係なアイコンは、可視化された意味の代用にはなりません。これらのフローを作成する前に、visual-storytelling.md を読んでください。

バンドルされたグラフィックから開始: コンポーネントインデックスを参照し、関連する assets/components/ の .drawio XML を読み、そのネイティブな子孫を再利用するか、そのパーツを適合/結合するか、その構造を新しいネイティブオブジェクト生成の参照として使用するかを選択します。タスクの要求に応じて、ブラウザ、ドキュメント、メッセージ、キュー、ワーカー、ストレージ、チャンク、テーブル、ベクター、レビュー、決定、通知オブジェクトを組み合わせます。たとえば、ブラウザ + ドキュメント → ストレージ、次に別個のメッセージ → キュー → ワーカーのように構成します。これらの名前を単に矩形内に記述しないでください。12 のスターターは拡張可能なシードライブラリであり、完全なテンプレートや機能制限ではありません。追加のオブジェクトを生成する場合は、シルエット、意味のある内容、ステータスマーク、ネスト、接続ポートなどの関連する構築アイデアを借用し、ドメインに適合させてください。スターターのサンプルパレットを強制したり、正確なコピーを強制したりしないでください。

組み込みコンポーネント言語: assets/components/ の下で再利用可能なアセットを追加、生成、または維持する場合は、すべてのキャプション、フィールド名、説明用テキスト値、ステータス、ページ名、ツールチップを英語のままにしてください。数値、数式、記号はそのままにしておいてかまいません。これはライブラリ作成ルールです。ユーザー向けに生成される図は、引き続き要求/ソース言語に従い、スターターテキストはそれに応じて調整されます。

例外はタスクに従い、便宜に従わない: 忠実な再構築、ローカル編集の範囲、明示的なテキストのみ/最小限のボックス要求、および必要な正式な表記法を保持します。クラス/ER コンパートメント、シーケンスライフライン、決定/フォーク/結合記号、状態境界は実際のセマンティクスを持ちます。これらを保持してください。「フローチャート」「シンプルな」図、スターターの欠如、Mermaid の可用性に関する一般的な要求は例外ではありません。互換性がある場合は、可視化されたオブジェクトの変更で状態を説明してください。形式的な関係を絵に置き換えないでください。これらのデフォルトはすべてのページに適用され、向きやタイプの変更後も維持されます。

コアルール

現在の .drawio ファイルを内部の編集可能な信頼できる情報源として扱います。デフォルトでは、ページごとの PNG 画像と 1 つの HTML プレビューのみを提供します。ネイティブファイルは内部作業ディレクトリに保持し、配信ディレクトリの外に置き、引き継ぎ時にリンクしません。明示的に要求された場合にのみ、ネイティブファイル、SVG、PDF、またはその他の形式を配信します。
入力を上書きしないでください。すべての機械的な書き込みは、内部作業ファイルを含む新しい出力パスを使用する必要があります。
テーマ、形状リスト、図の種類、座標グリッド、レイアウトレシピを強制しないでください。
ユーザーが指定した図の種類、表記法、向きに従ってください。これらが指定されていない場合は、タスクの実際の質問に最もよく答えるプレゼンテーションを選択してください。UML および非 UML 形式を含みます。すべてのリクエストをデフォルトでフローチャートやスイムレーンにしないでください。プレゼンテーションを選択または大幅に変更する場合は、diagram-selection.md を使用してください。
新しい説明フローには、上記のオブジェクト優先のデフォルトを適用します。標準の制御記号と再利用可能なコンポーネントスターターは、固定されたアイコンカタログを強制することなくこれをサポートします。
垂直フローチャートの場合、メインパスを上から下に実行し、並列ブランチを横に並べ、決定ダイヤモンドからの出口にラベルを付け、サポートチェックを薄いグレーの点線のボックスに平易な言葉で目的を記述してグループ化します。
中央エンジンが外部モジュールを調整する場合、コアを中央に配置し、入出力とワーカーを両側にグループ化し、アクションラベル付きの番号付き矢印を使用して、1 つのタスクを通してリーダーをガイドします。関連する場合は、フィードバックをコアの上にルーティングし、人間の決定と通知チャネルをその下に配置し、例となるワークフローを下部に沿って表示します。被写体に合わせて色を選択します。
任意のネイティブ Drawio の形状、ステンシル、スタイル、ジオメトリ、ウェイポイント、レイヤー、グループ、ラッパーメタデータを保持します。
圧縮されたノード、ラベル、ルーティングコリドーよりも、大きなキャンバスまたはコンテナを優先します。衝突のないファイルは、必ずしも広々としており、読みやすく、適切に構成されているとは限りません。
隣接するノードを配置する前に、コネクタラベルのスペースを確保します。長いラベルは、接続された形状の間に表示可能なクリアランスを持って収まるか、明示的な改行または別の明確なラベル位置を使用する必要があります。エンドポイントとラベルのリスクを解決し、図の準備ができているとマークする前に、実際のレンダリングテキスト境界を確認してください。コネクタラベルのクリアランスを参照してください。
新しく作成した、または大幅に再設計したコンテンツについては、デフォルトで、通常、セカンダリ、データ、例外、再試行フローを含む、有向セマンティックフローエッジにネイティブ flowAnimation=1 を設定します。参照、注釈、包含、グループ化、および純粋に構造的な関係は静的のままにします。明示的なユーザーの意図をこのポリシーより優先させます。
アニメーションの正規化が要求されていない限り、ローカル編集時に無関係なアニメーションスタイルを保持します。モーションが階層を不明瞭にする場合は、レンダリングされた QA 中にトポロジを変更する代わりに、優先度の低いセマンティックフローを静的します。
コネクタアニメーションを視覚効果として扱い、ルーティングや衝突回避としては扱いません。
バンドルされた CLI は、検査、クエリ、パッチ、検証、レイアウト/トポロジチェック、Desktop/Web エクスポートオーケストレーション、コンパニオン HTML、ページ CRUD、バージョン一覧表示、公開、復元にのみ使用します。オーサリング、レイアウト、またはレンダラーの実装は行いません。render は Drawio Desktop に委任し、web-svg-bridge は選択された 1 ページを公式の Drawio Web に委任し、プレビュー HTML は公式のリモートビューアに委任します。
<base>-vNNN を、その画像と HTML によって共有される論理的な配信バージョンとして扱い、すべての内部書き込みとしては扱いません。ネイティブのバージョン管理は、ソース配信が要求されない限り、内部のままです。デフォルトでは、1 つのユーザー承認済み変更は、最大で 1 つの新しい兄弟バージョンを消費します。
すべての公開 CLI --page-index をゼロベースに保ち、inspect によって返される index と一致させます。マルチページ作業には、安定したページ ID を優先してください。
各ドキュメントを 15 ページに制限します。CLI は、この制限を超える既存のドキュメントと追加を PAGE_COUNT_LIMIT で拒否します。この制限を満たすためにページを切り詰めることはしないでください。
このスキルを公式の drawio@drawio スキルと一緒に有効にしないでください。このスキルは既に同じネイティブ Mermaid/XML オーサリングパスを持っています。

プレゼンテーションを選択する

図の種類とオーサリングツールを分離します。リーダーが理解する必要があるもの（進行、責任、相互作用、状態、構造、デプロイメント、データ移動、比較）に基づいて選択します。提供された図、明示的な形式、または要求されたローカル編集は、その選択を制約します。ユーザーがそれを未定のままにした場合は、自律的に選択し、有用な場合は簡単に説明してから続行します。ユーザーにカタログから選択させることはしないでください。質問から形式へのガイドとトレードオフについては、diagram-selection.md を参照してください。

デフォルトのビジュアル処理、またはタスクの明示的な例外を、すべてのページとリビジョンに適用します。オブジェクトベースの説明の代わりとして、プレーンテキストのコンパニオンページを追加しないでください。

次に、そのプレゼンテーションに適したオブジェクトと表記法を選択します。具体的なイラストはペイロードと変換を説明できますが、正式な UML、ER、およびその他の確立された記号は、そのセマンティック規則を保持する必要があります。ラベル付きのすべてのクラス、状態、またはスキーマボックスを、テキスト量の多いフローの欠陥として扱わないでください。

ワークフローを選択する

リクエスト	ワークフロー
プロセス、パイプライン、スイムレーン、ライフサイクル、またはアーキテクチャフローを説明する	証拠/所有権 → visual-storytelling → オブジェクト/状態構築 → 直接ネイティブ XML → 公式レンダラー QA
正式な構造図または明示的に最小限のボックス図を作成する	表記法/内容を保持 → Desktop が利用可能な場合は Mermaid (意図した表現を保持する場合)。それ以外の場合はネイティブ XML
カスタムシェイプ/スタイル/位置で作成する	直接ネイティブ XML → `.drawio`
PDF またはテキストから作成する	ソースを読む → サポートされている構造を抽出 → 同じデフォルトを使用して表現を選択 → ネイティブ XML または適切な Mermaid
画像から再構築する	元の解像度で検査 → 編集可能なネイティブセル → オプションのプレビュー比較
視覚的な競合をチェックする	`check-layout` → Desktop `render` → 画像を検査 → 小さなパッチ → 再レンダリング。Viewer HTML にフォールバック
ビジネスフローをチェックする	既知の開始点、終了点、および必要なエッジを使用して `check-topology`
Desktop なしで表示する	`preview` → 公式リモートビューアを使用して、表示可能なページ数/名前を含むコンパニオン `.html`
Desktop なしで SVG をエクスポートする	1 つの `web_svg_session.py` ループバックセッションを優先。手動リカバリのために `web-svg-bridge → commit-web-svg` を保持
要求されたレイアウトをエクスポートまたは適用する	最初に `.drawio` を作成 → Drawio Desktop CLI
編集、ターゲット不明	`inspect → query → patch`
編集、ページとセル ID が既知	`query → patch`
編集、新しい信頼できる CLI 結果にすでにリビジョンとターゲットがある	`patch`
ページの追加、名前変更、または削除	`inspect → page add/rename/delete`
ファイルバージョンの一覧表示または復元	`versions` または `versions → inspect old → restore`
完成した作業ファイルを公開する	`inspect working → publish`
1 つ以上の既知のセルを表示する	`query`
ファイルを独立してチェックする	`validate`

作成、プレビュー、Desktop 検出、レイアウト、エクスポートについては、references/authoring.md を参照してください。Desktop が利用できず、要求された SVG を公式の Drawio Web を通じてエクスポートする必要がある場合にのみ、references/web-svg-export.md を参照してください。混雑した図を作成する場合、ページ間の視覚的な一貫性を維持する場合、check-layout を解釈する場合、またはレンダリングされたビジュアル QA を実行する場合に、references/layout-authoring.md を参照してください。プロセス、ライフサイクル、または要求パスを接続する必要がある場合は、references/topology.md を参照してください。ソースが PDF、テキスト、または画像である場合は、references/source-to-diagram.md を参照してください。直接 XML オーサリングの場合にのみ、references/drawio-xml.md を参照してください。パッチを構築する前に、references/patch-contract.md を参照してください。ページコマンドと不変の履歴については、references/versioning.md を参照してください。

論理的な配信を計画する

書き込む前に、要求されたすべての変更を、そのページ/セル、必要な決定の出口、重要な開始/終了/エッジの制約、副作用またはエラーパス、用語、および影響を受けるすべてのページにマッピングします。
新しいマルチページドキュメントの場合、オーサリング前にドキュメントローカルのビジュアルロールを定義し、ページ全体でページ基盤、タイポグラフィ、繰り返されるコンポーネントスタイル、および関係スタイルを再利用します。コンテンツを追加または編集する場合は、要求された範囲内で既存のドキュメント規則を継承します。ドキュメントの視覚的一貫性に従って、ロールの選択、意図的な例外、およびページ間の受け入れを行います。
後でトポロジ、レイアウト、またはビジュアルの修正を必要としない 1 つのアトミックな編集の場合、新しい内部ネイティブバージョンに直接書き込みます。
マルチページの編集、または QA 修正が必要になる可能性が高いタスクの場合、エージェント所有の一時ディレクトリを作成し、working-01.drawio、working-02.drawio などと書き込みます。要求されたすべての編集とチェックをそこで完了します。publish は、内部の最終スナップショットまたは明示的に要求されたネイティブ配信にはオプションです。
配信 HTML とページごとの PNG は、同じ最終チェック済みネイティブスナップショットから生成します。公開された .drawio の成果物は必須ではありません。ユーザー向け HTML の場合、各ページの検証済みレンダリングを preview --fallback-png で埋め込みます（ページ順に繰り返します）。リモート Viewer をブロックした状態（狭い幅でも）で配信 HTML をチェックします。オンラインレンダリングが成功しただけでは、受信者のプレビューが確認できません。公式レンダラーが利用できない場合は、HTML をオンライン専用とラベル付けし、制限を開示します。一時的なプレビューは QA アーティファクトであり、成果物ではありません。
自己完結型の画像と HTML を確認した後、このタスクによって作成された使い捨ての QA ファイルのみを削除します。最終的なネイティブスナップショットは、後で編集するために内部的に保持します。明示的なユーザー承認なしに、既存の正式なバージョンをクリーンアップしないでください。

作成

references/authoring.md を読み、構文を選択する前に表現を選択します。新しい説明フローの場合は、オブジェクト優先のデフォルトと直接ネイティブ XML を使用します。Desktop の可用性によってエクスポートが変わりますが、ビジュアル要件は変わりません。Mermaid は、選択されたセマンティクス/表現（正式な構造図や明示的に最小限のボックス図など）を保持する場合にのみ使用します。変換/エクスポートのために Desktop を検出します。
説明的な小文字ハイフン区切りのベースを選択し、最初の画像/HTML 配信用に <base>-v001 を予約し、その .drawio スナップショットを内部に保持します。

... (省略)

drawio-visuals-skill