drawio-academic-skills

Draw.io Academic Overlay

Draw.io Base Skill に学術向けポリシーを適用し、出版可能な品質の draw.io 図を作成、編集、複製、検証、エクスポートします。このオーバーレイは意図的に薄く構成されています。学術向けポリシーとゲート、学術向けドキュメント、論文の例を担当します。兄弟ディレクトリにあるベース ../drawio は、CLI、スキーマ、レンダラー、academic／academic-color を含むテーマ、リファレンス、例、スタイルプリセット、Desktop エクスポートなど、共有するすべての実行機能を担当します。

必須の兄弟ベース

このオーバーレイのディレクトリを基準に、共有リソースを解決します。

• CLI ../drawio/scripts/cli.js、URL フォールバック ../drawio/scripts/runtime/diagrams-net-url.js
• スキーマ ../drawio/assets/schemas/spec.schema.json、テーマ ../drawio/assets/themes/、パレット ../drawio/assets/palettes/
• リファレンス ../drawio/references/docs/、../drawio/references/official/、../drawio/references/workflows/、../drawio/references/examples/、共有の再作業手順 ../drawio/references/workflows/visual-review.md
• 組み込みスタイルプリセット ../drawio/styles/built-in/

オーバーレイ固有のアセット：references/docs/publication-overlay.md、academic-figure-playbook.md、academic-export-checklist.md、references/examples/、references/templates/。

../drawio/scripts/cli.js が見つからない場合は処理を停止し、このオーバーレイの隣に兄弟ベーススキルをインストールする必要があることを報告してください。オーバーレイ内にベースリソースを黙って再作成したり、コピーして含めたりしないでください。

必ず守る契約

• 学術図の作成は YAML 優先かつオフライン優先とします。.mcp.json、MCP、ライブバックエンドを作成、必須化、または経由してはなりません。
• 学術図の最終成果物のデフォルトは .drawio と 300dpi の .png（draw.io Desktop 経由）とします。Desktop がない場合は SVG をオフラインの代替形式とし、その旨を報告してください。実際に生成していないファイルを生成済みとして報告してはなりません。
• ユーザーが最終出力の隣に再現可能なサイドカーバンドルを置くよう明示的に依頼した場合を除き、.spec.yaml、.arch.json、生の YAML、診断情報は、.drawio-tmp/<name>/ のようなプロジェクト内の作業ディレクトリに保存してください。
• エクスポートした PNG（または代替形式の SVG）で、まず論文での可読性と視覚的なセルフチェックを行ってください。エクスポート済みの成果物がある場合、ブラウザーや Playwright のスクリーンショットで代用しないでください。
• プレビューの構成、問題の記録、YAML 優先の再作業、停止条件には、兄弟ベースの ../drawio/references/workflows/visual-review.md を使用してください。このオーバーレイで追加するのは出版向けのチェックのみです。
• 外部の画像生成プレビューは、任意のコンセプトプレビューとしてのみ扱ってください。YAML、成果物、サイドカー、エクスポート済み成果物の検証に取って代わるものではありません。
• ユーザーのプロジェクト内にある .agents/skills/drawio の下に、一時的な JS スクリプトを作成または変更しないでください。長期的に有効な修正は、兄弟ベーススキルのソースに反映してください。

学術向け事前確認

生成または編集を始める前に、開催先／対象読者、図の種類（architecture、roadmap、workflow）、色のポリシー、キャプション／凡例／タイトル、数式、テキスト忠実性に関する要件、エクスポートの想定を確認し、明示してください。ノード予算（基準となる目標値、しきい値、分割方針は references/docs/academic-figure-playbook.md § Node Budget Management を参照）を見積もってください。目標を超える場合は、分割または簡略化の方針についてユーザーの確認を得て、references/templates/ の簡潔なパターンを基に始めてください。判断事項の詳細は references/docs/publication-overlay.md § Required Academic Decisions を参照してください。

パレットの事前確認

会場が判明した後、ユーザーがパレットを指定していない場合は、AskUserQuestion を単一選択で使用します。会場に推奨されるものを先頭にして (Recommended) を付け、選択肢は3〜4個にします。各パレットの displayName をラベルにし、説明には色覚特性やグレースケールでの視認性と、会場を選んだ理由を記載します。会場ごとの対応表：references/docs/academic-figure-playbook.md § Venue Palette Mapping。

ユーザーがすでにパレットまたは明確なスタイルを指定している場合は、それに直接対応付け、質問しないでください。学術図の再現では、ユーザーが明示的に正規化を求めない限り、元のパレットを維持し、選択を省略します。選んだ名前を meta.palette に記録してください。完了報告には、パレット名と色覚特性およびグレースケールでの視認性に関するフラグを、印刷ゲートでの評価引き下げも含めて記載してください。

ソースの理解

論文、参考画像、またはテキストのみのプロンプトから、図に必要な情報だけを抽出し、不確実な点は明示してください。references/docs/publication-overlay.md § Source Understanding および references/docs/academic-figure-playbook.md § Scientific Figure Patterns を参照してください。

図の計画ゲート

論文に基づく複雑な図や、学術画像の再現作業では、簡潔な図の計画を提示し、レンダリング前に確認を待ってください。簡単な学術図では、ゲートを省略できます。テンプレート：references/docs/publication-overlay.md § Diagram Plan Gate。

任意の画像プレビュー

図の計画が確認された後に限り、未公開または機密性の高いコンテンツを送信する前にプライバシーの承認を得たうえで実施してください。生成されたテキストは近似として扱い、YAML 内の最終的なラベル、数式、幾何情報を修正してください。詳細なルール：references/docs/publication-overlay.md § Optional Image Preview。

タスクの振り分け

ルートを1つ選び、そのルートのファイルだけを読み込んでください。overlay はこのディレクトリ、base はこのディレクトリから見た兄弟ディレクトリです。

• academic-create — 論文、学位論文、IEEE、原稿、学術誌、出版用の図 → overlay references/docs/publication-overlay.md、academic-figure-playbook.md、academic-export-checklist.md；base ../drawio/references/workflows/create.md
• math-formula — 数式、方程式、LaTeX、AsciiMath、MathJax、公式 → base ../drawio/references/docs/math-typesetting.md、design-system/formulas.md
• edit — 学術用バンドルまたはインポート済み .drawio の変更 → base ../drawio/references/workflows/edit.md、../drawio/references/docs/migration-readiness.md
• replicate — スクリーンショット、画像、SVG、または参考論文の図の描き直し → overlay references/docs/publication-overlay.md；base ../drawio/references/workflows/replicate.md、../drawio/references/docs/design-system/specification.md、color-guide.md
• base-capabilities — コード／設定／ライブインポート、ラスター画像の抽出、ローカル PNG/JPEG アセット、複数ページのバンドル、AI／SysML／BPMN ステンシル、または出版前チェック前のオフライン後処理 → base ../drawio/references/docs/upstream-capability-compatibility.md、local-image-assets.md；overlay references/docs/publication-overlay.md
• stencil-heavy — 学術向けクラウド、ネットワーク、AWS、Azure、GCP、Cisco、Kubernetes の図 → base ../drawio/references/docs/stencil-library-guide.md、ieee-network-diagrams.md、../drawio/references/official/xml-reference.md
• style-preset — ビジュアルスタイルのプリセットの学習／使用／一覧表示／削除／名前変更 → base ../drawio/references/docs/style-extraction.md、style-presets.md、../drawio/styles/built-in/
• direct-xml-exception — 引き継ぎ専用の小規模な XML、または正確な mxGraph 制御 → base ../drawio/references/upstream/pure-drawio-skill.md、../drawio/references/official/xml-reference.md

学術論文のデフォルト設定

学術論文に関するリクエストでは、レンダリング前に以下を設定します。

meta:
  profile: academic-paper
  figureType: architecture # architecture | roadmap | workflow
  theme: academic # or academic-color when color is acceptable
  palette: okabe-ito # from venue preflight; ieee-bw for IEEE print
  title: Caption-ready title
  description: One sentence explaining the figure intent
  legend: Required when symbols, colors, line styles, or icons need explanation
  print: { target: cn-thesis } # optional gate: cn-thesis | ieee-single | ieee-double

デフォルトの成果物：

• <name>.drawio
• <name>.png（300dpi、draw.io Desktop 経由。Desktop がない場合は <name>.svg にフォールバック）

中間作業ディレクトリ：

• <name>.spec.yaml、<name>.arch.json、未加工または正規化済みの YAML、診断情報

ジャーナル／IEEE のベクター形式での投稿では、<name>.pdf（または .svg）を明示的にエクスポートします。ラスター形式の PNG ではなく、ベクター形式が必須です。その他の形式はリクエストがあった場合のみ使用します。

作成フロー

1. 図を architecture、roadmap、workflow のいずれかに分類します。論文に基づく複雑なリクエストでは、まず図の計画を確認します（確認後にのみプレビューします）。
2. YAML 仕様を正式なソースとして作成または正規化します。フォントを小さくする前に、ラベルを短くします。
3. 兄弟ディレクトリのベース CLI を使って検証とレンダリングを行い、報告する前にエクスポートした成果物を自己チェックします。

node ../drawio/scripts/cli.js input.yaml figure.drawio --validate --write-sidecars --sidecar-dir .drawio-tmp/figure --strict-warnings
node ../drawio/scripts/cli.js input.yaml figure.png --validate --use-desktop

図の種類ごとのパターン：references/docs/academic-figure-playbook.md。

編集と複製のフロー

• まず .spec.yaml サイドカーを編集します。.drawio しかない場合は、ベース CLI を使ってインポートします（--input-format drawio --export-spec）。
• 画像／SVG を複製する場合、表示されているテキストボックス、キャプション、凡例、数式、エッジラベル、ベースライン／オフセット、フォントファミリー／サイズ／斜体の状態、配置、間隔を維持します。独立したテキスト／数式ブロックには明示的な bounds を使い、線からずれたコネクターラベルには labelOffset を使います。
• 再生成したファイルは、ラウンドトリップ可能な成果物とサイドカーとして扱えるよう、同じベース名を維持します。

エクスポートポリシー

ベクター形式での投稿（ジャーナル／IEEE）では、PDF（または SVG）を明示的にエクスポートします。Desktop がない場合は diagrams.net の URL を生成し、エクスポートできないことを正直に報告します。

node ../drawio/scripts/cli.js input.yaml figure.pdf --validate --use-desktop
node ../drawio/scripts/runtime/diagrams-net-url.js figure.drawio

スタイルプリセット

まずオーバーレイ固有のユーザープリセット（~/.drawio-academic-skills/styles/）を使用し、次に兄弟ディレクトリのベースに同梱されているプリセット（../drawio/styles/built-in/）を使用します。同梱されているベースプリセットは変更しないでください。編集またはデフォルトとして使用する前に、ユーザープリセットディレクトリへコピーします。

品質ゲート

以下を満たすまで、完了したと主張しないでください。

• 最終的な .drawio と .png（またはフォールバックの .svg）が、作業ディレクトリの .spec.yaml／.arch.json と一致していること。meta.profile が academic-paper、meta.figureType が architecture、roadmap、または workflow であること
• ノード数がプレイブックの上限内であること（references/docs/academic-figure-playbook.md § Node Budget Management）。上限を超える場合は分割するか、簡略化すること
• ラベルが論文／A4 のサイズで読みやすいこと。数式に公式の区切り記号（$$...$$、\(...\)、AsciiMath のバッククォート）を使用し、フォントクラスが段階的なサイズ設定に従い、ラベルの収まりに関する警告がないこと
• CJK とラテン文字が混在するラベルで、Times New Roman + SimSun のフォントスタックが適用されること（テーマの cjk スタックまたは meta.font）
• キャプション、凡例、コールアウト、数式、エッジラベルが切れておらず、コネクター線上に配置されていないこと。凡例がコンパクトであること（複数行を含む単一のテキストノード）
• 色だけが意味を伝える手段になっていないこと。meta.palette が投稿先の選定と一致していること。PALETTE_PRINT_GATE がクリアであること。厳格な印刷要件を満たさない場合は、ieee-bw／tol-high-contrast を提案すること
• エクスポートした PNG（またはフォールバックの SVG）について、ライブプレビュー／ブラウザーでのプレビューより前に、兄弟ディレクトリのベース ../drawio/references/workflows/visual-review.md に従って視覚的な自己チェックを行っていること。学術論文向けのチェックでは、A4 での読みやすさ、キャプション／凡例、数式、印刷時の意味、投稿先の制約も確認すること
• リクエストされた Desktop エクスポートを試行したか、利用できないことを報告していること。MCP の設定、サーバー、ライブバックエンドは不要です
• 参照されるローカル画像アセットで、空でない raster_reason、atomic_raster_unit: true、contains_reconstructable_content: false が宣言されていること

完了レポート

最後に簡潔なレポートを記載します。成果物のパス、中間サイドカーを生成した場合はその作業ディレクトリ、実行した兄弟ディレクトリのベース CLI コマンド、選択したパレットとその色覚多様性／グレースケール対応フラグおよび印刷ゲートによる格下げ、利用できなかった Desktop エクスポートと提供したフォールバック、投稿先固有で今後手動確認が必要な項目を含めます。