Visio Automation 是一个面向 AI 智能体的技能，用于通过 Visio COM 自动化控制真实的 Microsoft Visio，从而创建和修改图表。其目标产物是可编辑的 .vsdx 文件，使用 Visio 内置主控形状、原生动态连接线、已粘附端点以及能在手动编辑后继续生效的 ShapeSheet 设置。
用途
该技能适用于用户希望 AI 智能体创建、编辑、转换、检查或修复可编辑 Microsoft Visio 图表的场景，覆盖流程图、BPMN、UML、网络图、组织架构图、DFD、VSM，以及 Mermaid、draw.io 转换、截图重建、白板重建等。
主要能力
- 通过 COM 自动化控制真实 Microsoft Visio，生成原生可编辑的 .vsdx。
- 使用 Visio 内置模具与 NameU 主控形状，仅在无对应语义主控形状或用户明确要求通用草图时使用基础图元。
- 使用 Visio 连接线主控形状配合 GlueToPos 建立连接，避免绘制无法随形状移动的松散线条。
- 保留连接线路由方式：正交保持正交、直线保持直线、曲线保持曲线。
- 对非平凡图表、转换、图像重建或缺少明确坐标的任务，先构建轻量级 Graph Model。
- 支持图表族分类、模具/主控形状发现、语义搜索与缓存、图模型与转换、图像重建、验证等功能。
- 提供 PowerShell 辅助脚本，避免重复编写 COM 样板代码。
使用方式
默认在可见前台模式下运行面向用户的 Visio 工作，让用户能观察图表出现。仅在用户明确要求后台/无头操作，或用于不绘制面向用户文档的狭窄内部发现/验证时，使用 New-InvisibleVisioApplication。
始终加载辅助脚本而非重写 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
核心工作流：
- 根据用户意图分类图表族。
- 读取相应参考文件。
- 通过目录、语义搜索或本地发现选择原生模具/主控形状。
- 当结构超过少量手动放置的形状时，将图表规范化为 Graph Model。
- 默认使用可见 Visio 渲染，采用原生主控形状与已粘附动态连接线。
- 保存 .vsdx，在有用时导出预览，验证输出与连接线行为，然后总结结果。
任务与参考文件对应：
- 选择图表族、模具或主控形状：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
适用场景
流程图、BPMN、UML、网络图、组织架构图、DFD、VSM 等图表的创建与修改；Mermaid、draw.io 转换；截图、白板、PDF 裁剪或草图重建；对现有 Visio 文档的检查与修复。
限制与注意事项
- 对包含 UTF-8 中文文本的脚本使用 pwsh；不带 BOM 的 Windows PowerShell 5 可能误解析 UTF-8 文件。
- 使用 OpenEx(..., 66) 保持模具隐藏/只读，避免保存提示。
- 除非用户明确要求，否则不要关闭用户可见的 Visio 窗口。
- 避免为可编辑图表生成原始 .vsdx XML，因为它通常缺少用户关心的原生主控形状与连接线行为。
- 若未来可能继续编辑，将任务脚本保留在工作区。
关于收费、价格、平台支持版本等具体信息，资料暂未提供。