コードと論文から編集可能なMicrosoft Visio科学図を作成する

Scientific Model Diagram Visio (科学的モデル図 Visio)

Microsoft Visio でネイティブ編集可能なオブジェクトを使用して、科学的なアーキテクチャ図を作成または修正します。科学的正確性、読みやすいジオメトリ、編集容易性をそれぞれ独立したゲートとして扱い、3つすべてを通過してから納品します。

モードを選択

• 完全再構築: 検証済みのモデル契約とビジュアルリファレンスから、要求されたページを構築します。
• 部分修正: VSDX をバックアップし、指定されたステージ、シンボル、寸法、コネクタ、タイポグラフィ、または間隔のみを変更します。
• 監査/エクスポート: 既存の VSDX を検査し、許可された欠陥のみを修正して再開し、PDF と 300 DPI の PNG をエクスポートします。

ソースロジックがコード、設定、原稿、古い図の間で整合していない場合は、最初に scientific-model-diagram-prompting を使用するか、handoff-contract.md でエビデンスパスを実行してください。外観だけで融合操作やテンソル次元を推測しないでください。

必須ワークフロー

1. ターゲットモデルを確定

ステージ順序、各境界でのテンソル形状、操作セマンティクス、学習可能パラメータ、融合ルール、分類器の幅、クラス数、正確なラベルを含むモデル契約を作成します。コードや原稿が利用可能な場合は、ソースファイルと行番号を引用します。

ユーザーが明示的に別のターゲットを選択しない限り、このエビデンス優先順位を適用します:

1. 正常に構築または実行されたモデル;
2. トレーニング実装と実験設定;
3. 原稿の数式とメソッドテキスト;
4. 古い VSDX またはラスター図;
5. 生成されたビジュアルリファレンス。

矛盾がアーキテクチャを実質的に変更する場合は、描画を開始する前に停止して報告します。必要なハンドオフスキーマについては handoff-contract.md を参照してください。

2. ソースを保護し、作業ファイルを分離

• 編集前にソース VSDX と正確な出力パスを解決します。
• ユーザーの指定された作業ディレクトリを使用します。指定がない場合は、兄弟ディレクトリとして _visio_work を作成します。
• スクリーンショット、リファレンスラスター、タイムスタンプ付きバックアップ、一時エクスポート、QAレンダリング、ヘルパー出力をその作業ディレクトリ内に保持します。
• 最初の変更の前にソース VSDX をバックアップします。唯一のコピーを上書きしないでください。
• ユーザーが許可し、作業ログにページ名を記録した場合にのみ、関連のないページを削除します。

3. Microsoft Visio を意図的に制御

利用可能な場合は computer-use Windows 自動化スキルを使用します。新しいセッションでの最初の UI アクションの前に、ランタイムを初期化し sky.documentation("guidance") を読み取ります。確認が必要な可能性があるアクションの前に sky.documentation("confirmations") を読み取ります。アプリケーション/ウィンドウ ID で Visio ウィンドウをターゲットにし、ブラインド座標シーケンスではなくスクリーンショットを検査します。

VSDX を Microsoft Visio で開きます。ユーザーが Visio を要求した場合、Visio の実行をラスター、SVG スクリーンショット、PowerPoint、または汎用ダイアグラムエディタに置き換えないでください。

Visio を制御する前に visio-execution.md を読んでください。

4. 詳細の前にジオメトリを構築

モジュールを配置する前に、ページサイズ、向き、余白、レイヤー、ステージコンテナ、行ベースライン、コネクタコリドーを設定します。並列ブランチには座標計画と繰り返しジオメトリを使用します。

繰り返し使用するコンポーネントには、再利用可能なネイティブマスターまたはグループ化された形状を作成します。オペランド、演算子、寸法、コネクタは独立したままにします。3D 直方体は、編集可能な前面/上面/側面のグループのままにしなければなりません。ページをフラット化しないでください。

レイアウトトークン、フォントサイズ、直方体の構築、コネクタ、グループ化、およびユーザーの出版基準については layout-and-style.md を使用してください。

5. パスで描画

これらのパスを順番に実行します:

1. ページ、レイヤー、コンテナ;
2. 繰り返し行ガイドとコネクタコリドー;
3. モジュールと再利用可能な直方体;
4. 数学的オペランドと独立した演算子;
5. 接続ポイントに接着されたコネクタ;
6. ラベル、寸法、凡例、キャプション;
7. 配置、分布、ローカルグループ化;
8. プレビュー倍率と元の詳細での視覚的クリーンアップ。

各主要パスの後、作業ディレクトリにスクリーンショットをキャプチャします。部分修正が要求された場合は、影響を受ける領域のみを変更し、その入出力接続を再確認します。

6. ルーティングと可読性を強制

• 完全に水平なブランチラインと直交曲がりを優先します。
• テキストを配置する前に、空のコネクタレーンを予約します。
• すべての機能コネクタを明示的な接続ポイントに接着します。
• テキスト、演算子、直方体、プロットカード、または他の矢印ヘッドを通して線を通過させないでください。
• 並列行の高さと間隔を均等に保ちます。目視ではなく、整列と分布を使用します。
• テキストを最小サイズ以下に減らす前に、ラベルを短くするかコンテナを広げます。
• 全ページプレビューとズームしたスクリーンショットの両方を検査します。ズームしたときにのみ読み取れるテキストは不合格です。

7. 保存、再開、編集可能性の確認

最終的な VSDX を要求されたパスに保存し、閉じて、Visio で再開します。少なくとも以下を個別に選択して編集します:

• グループ化された直方体内の1つの面;
• 1つの数学演算子または記号;
• 1つのコネクタとその両方の接着された端点;
• 1つのステージラベル。

リファレンス画像が削除されているか、ロックされた Reference レイヤーに隠されていること、要求された場合に関連のないページがないこと、オブジェクトが単一の全ページビットマップになっていないことを確認します。

保存後、scripts/inspect_vsdx.py を実行します。この静的チェックは補足的なものであり、視覚的検査を決して置き換えるものではありません。

8. エクスポートと最終 QA の実行

Visio から PDF と PNG をエクスポートします。16 × 9 インチのページの場合、300 DPI のラスターは少なくとも 4800 × 2700 ピクセルです。クリッピング、フォント置換、細い/切れた線、影のアーティファクト、ページ境界エラーについて両方のエクスポートを検査します。

完全な qa-checklist.md を実行します。科学的忠実性、重なり、コネクタ、テキスト完全性、エクスポート、または編集可能性の項目が1つでも不合格の場合は納品しないでください。

部分修正ルール

• 影響を受けない形状、スタイル、レイヤー、ページ設定を保持します。
• 編集前にバックアップし、新しいバージョンでリビジョンを保存してから受け入れられるようにします。
• 影響を受ける最小のサブグラフ（入力コネクタ、編集オブジェクト、出力コネクタ）を診断します。
• オブジェクトを移動した後、隣接するコネクタを再ルーティングします。
• 全ページプレビュー QA を再実行します。ローカルな修正がグローバルな衝突を引き起こす可能性があります。

必須ハンドオフ

以下を報告します:

1. ターゲットアーキテクチャとエビデンスベース;
2. ソース、バックアップ、作業ディレクトリ、出力パス;
3. 削除または保持されたページ;
4. VSDX、PDF、PNG パス、および PNG ピクセルサイズ/DPI;
5. 静的 VSDX 検査サマリー;
6. 再開/編集可能性テストの実行;
7. 残っている不確実性。

ファイルが保存またはエクスポートされたという理由だけで成功を主張しないでください。