visio-automation

Visio の自動化

実際の Microsoft Visio を COM オートメーションで制御して、図を作成・変更します。成果物は、組み込みの Visio マスター、ネイティブの動的コネクタ、接着された端点、手動編集後も維持される ShapeSheet 設定を使用した、編集可能な .vsdx です。

キーワード

Visio、.vsdx、Visio COM、ステンシル、マスター、NameU、ShapeSheet、Dynamic Connector、GlueToPos、コネクタのルーティング、コネクタの接着、フローチャート、BPMN、UML、ネットワーク図、組織図、DFD、VSM、Mermaid、draw.io、スクリーンショットの再現、ホワイトボードの再現、ネイティブで編集可能な図。

デフォルトのルール

• ユーザー向けの Visio 作業は、デフォルトで前景の可視モードで実行し、ユーザーが図の作成過程を確認できるようにします。New-InvisibleVisioApplication は、ユーザーがバックグラウンド／ヘッドレスでの動作を明示的に求めた場合、またはユーザー向けのドキュメントを作成しない限定的な内部調査／検証に限って使用します。
• Visio 組み込みのステンシルと NameU マスターを優先します。意味に合ったマスターがない場合、またはユーザーが意図的に汎用的なスケッチを求める場合に限り、基本図形を使用します。
• 複雑な図、変換、画像の再現、または明確な座標がないタスクを描画する前に、軽量なグラフモデルを作成します。
• コネクタマスターと GlueToPos を使用します。図形に連動して移動すべき関係を、接続されていない線で描かないでください。
• 指定または確認したコネクタのルーティングを維持します。直角は直角のまま、直線は直線のまま、曲線は曲線のままにします。
• .vsdx を保存し、必要に応じて PNG プレビューをエクスポートしてから、完了を報告する前に作成したドキュメントを検証します。

読むファイルを選択する

現在の依頼に必要なファイルだけを読みます。

タスク	読むファイル
図の種類、ステンシル、またはマスターを選択する	references/diagram-selection.md、必要に応じて references/master-catalog.md
不明なマスターまたはローカライズされたマスター／ステンシル	references/master-discovery.md
自然言語によるマスター検索、中国語／英語の別名、繰り返しの編集	references/semantic-search-and-cache.md
計画済みグラフの描画、自動レイアウト、自然言語のフロー、矢印付きテキストフロー、Mermaid、draw.io	references/graph-model-and-conversion.md
スクリーンショット、ホワイトボード、PDF の切り抜き、またはスケッチの再現	references/image-reconstruction.md
ルーティング、接着、ShapeSheet セル、出力ファイルの検証	references/verification.md
Visio COM、VBA、または ShapeSheet API の詳細が必要	references/official-docs.md

COM の定型コードを再入力せず、必ずヘルパースクリプトを読み込みます。

. "$env:USERPROFILE\.codex\skills\visio-automation\scripts\visio_helpers.ps1"

Codex 以外のエージェントでは、.codex\skills の部分をそのエージェントのスキルディレクトリに置き換えます。

便利なヘルパーには、次のものがあります。

• Visio アプリ／ドキュメント：New-VisibleVisioApplication、New-InvisibleVisioApplication、Get-OpenVisioDocumentByPath
• ステンシル／マスター：Open-VisioStencilReadOnly、Get-VisioEnvironment、Build-VisioMasterIndex、Find-VisioMasters、Find-SemanticVisioMaster
• グラフの描画／変換：Render-VisioGraphModel、Invoke-VisioGraphLayout、Convert-NaturalLanguageFlowToVisio、Convert-TextFlowToVisio、Convert-MermaidToVisio、Convert-DrawIOToVisio、Convert-ImageReconstructionToVisio
• 図形／コネクタの編集：Set-VisioTextStyle、Set-VisioShapeFill、Set-VisioShapeBounds、Connect-VisioShapesOrthogonal、Connect-VisioShapesStraight、Connect-VisioShapesCurved
• ルーティングポリシー：Resolve-VisioRoutingIntent、Resolve-VisioRouteDecision、Get-VisioRoutingDefault、Resolve-VisioLoopbackGlue
• セッションキャッシュ：Get-VisioSessionCache、Update-VisioSessionCache、Add-VisioSessionRecentMaster

コアワークフロー

1. ユーザーの意図から、図の種類を特定します。
2. 上記の表から該当するリファレンスファイルを読みます。
3. カタログ、セマンティック検索、またはローカルでの検索を通じて、ネイティブのステンシル／マスターを選択します。
4. 手動で配置する図形が数個を超える構造の場合は、図をグラフモデルに正規化します。
5. デフォルトでは表示中の Visio でレンダリングし、ネイティブのマスターと接着された動的コネクタを使用します。
6. .vsdx を保存し、必要に応じてプレビューをエクスポートして、出力とコネクタの動作を確認してから、結果を要約します。

実用上の注意

• UTF-8 の中国語テキストを含むスクリプトには pwsh を使用します。Windows PowerShell 5 では、BOM のない UTF-8 ファイルを正しく解析できない場合があります。
• 保存時の確認ダイアログを避けるため、ステンシルは OpenEx(..., 66) で非表示／読み取り専用にしておきます。
• ユーザーが明示的に依頼しない限り、ユーザーに表示されている Visio ウィンドウを閉じないでください。
• 編集可能な図の作成に、生の .vsdx XML を生成する方法は避けてください。ユーザーが重視するネイティブのマスターやコネクタの動作が失われることがよくあります。
• 今後の編集が見込まれる場合は、タスクのスクリプトをワークスペースに残しておきます。