codex-visio-replica-workflow

name	codex-visio-replica-workflow
description	当 Codex 需要根据参考图片、截图、白板图、系统架构图、流程图或业务图，在 Microsoft Visio 中生成、复刻、录屏演示或教学拆解图表时使用。本技能覆盖环境检查、参考图拆解、Visio COM 自动化、鼠标键盘可见录屏准备、导出预览验证，以及可分享教程资料交付。
metadata	{"short-description":"生成和教学 Visio 图表复刻流程"}

Codex Visio 复刻流程

当用户希望 Codex 生成 Visio 图、把参考图复刻成可编辑 Visio、准备鼠标操作录屏，或把流程封装成教程资料时，使用本技能。

工作模式

先选择一种模式，并用一句话告诉用户：

• 先自动化：用脚本生成可编辑 .vsdx，导出预览，再视需要进行可见演示或录屏。
• 可见录屏：只用 Visio 界面、鼠标和键盘操作。除非用户明确要求立即直播式录制，否则先做彩排。
• 教程封装：交付可复用流程、脚本、提示词、检查清单和示例输出结构，方便别人照着学。

如果用户要录屏，在用户确认“已经开始录屏”之前，不要开始任何可见界面操作。

快速流程

1. 收集输入

   • 参考图路径或用户上传的图片。
   • 输出文件夹和文件名。
   • 复刻目标：结构复刻、视觉一比一，或适合教学的可编辑草稿。
   • 是否需要把原图作为 Visio 的参考页或背景页嵌入。

2. 检查环境

   • 运行 scripts/check_visio_environment.ps1。
   • 确认能找到 VISIO.EXE、COM 自动化、导出能力，以及 PDF/PNG 转换工具。
   • 只关闭本任务启动的 Visio 实例，不要关闭用户正在编辑的其他 Visio 文件。

3. 拆解参考图

   • 记录画布尺寸和宽高比。
   • 标出主要区域、边界框、重复模块、文字标签、图标、箭线路由和配色。
   • 以参考图像素坐标为准，把像素映射到 Visio 英寸。常用比例：100 px = 1 in。

4. 构建 Visio 计划

   • 优先使用可编辑基础图形，不要只粘贴整张截图。
   • 使用矩形、虚线容器、标签、连接线、箭头、椭圆和简化图标。
   • 保留第二页，命名为 原图参考 或 Reference，把原图铺满用于对比。
   • 对复杂图，创建或更新 JSON 计划，然后交给 scripts/create_visio_from_plan.ps1 生成。

5. 生成与验证

   • 保存 .vsdx。
   • 导出矢量预览（.emf 或 .pdf），可行时再转成 .png。
   • 检查预览：文字是否换行异常、字体是否缺失、图形是否超出画布、线条是否混乱、页面比例是否错误。
   • 反复调整，直到第一页预览可以接受。

6. 准备录屏

   • 关闭后台自动化留下的 Visio 实例。
   • 根据教程目标，打开最终 .vsdx 或从空白 Visio 文件开始。
   • 准备简短操作脚本：设置页面、插入参考图、绘制大容器、复制重复模块、连接箭头、添加文字、导出预览。
   • 告诉用户：“准备好了，你开始录屏后回复‘开始’，我再操作。”

复刻准则

• 先匹配页面宽高比，后面所有坐标都依赖它。
• 先画大容器，再画细节。
• 重复模块用坐标和复制对齐生成，不要每个都凭感觉拖。
• 系统边界优先用虚线，流程线优先用黑色箭头；除非参考图明显不同。
• 图标优先用可编辑近似图形；如果用户提供 SVG/PNG，再使用精确素材。
• 不要依赖 emoji 或冷门符号做 Visio 标签，它们导出时很容易变形或缺字。
• 中文标签如果换行难看，优先缩短文字、放大框、降低字号，而不是硬挤。

PowerShell 和 Visio 注意事项

• Windows PowerShell 5.1 可能会误读带中文的 UTF-8 脚本。推荐这样加载：

$p = "C:/path/to/script.ps1"
$text = [System.IO.File]::ReadAllText($p, [System.Text.Encoding]::UTF8)
& ([scriptblock]::Create($text))

• Visio 刚启动时，COM 调用可能被拒绝。对 New-Object -ComObject Visio.Application、Visible、Documents.Add、SaveAs、Export 等关键步骤加等待和重试。
• 自动化烟测时默认让 Visio 后台运行；只有录屏或现场演示时才打开可见窗口。
• 如果 Visio COM 反复出现 RPC_E_CALL_REJECTED 或普通 COM 异常，先关闭所有空白 Visio 窗口，等待 10 秒，重新运行环境检查；如果仍不稳定，切换到可见录屏模式。
• 如果直接导出 PNG 卡住，先导出 .emf，或用 LibreOffice 把 .vsdx 转成 .pdf，再用 pdftoppm 把 PDF 渲染成 PNG。
• visio.AlertResponse = 7 可以减少自动保存时的弹窗，但它不是必需项；设置失败时不要让主流程失败。

鼠标录屏操作顺序

教程录屏建议按这个顺序：

1. 打开 Visio，新建空白绘图。
2. 设置页面大小，让宽高比匹配参考图。
3. 把参考图插入参考页，或临时放在锁定图层。
4. 绘制外框和主要分区线。
5. 绘制主要模块容器。
6. 用复制、粘贴和对齐工具添加重复模块。
7. 绘制连接线和箭头。
8. 添加文字标签并调整字号。
9. 导出预览，与参考图对比。
10. 保存 .vsdx，展示最终可编辑结构。

可见操作要稳定、简洁，只解释当前正在做的步骤。用户录屏时，不要同时跑隐藏生成脚本，除非用户明确要做混合式教程。

交付物

普通图表任务建议交付：

• 可编辑 .vsdx。
• 预览 .png 或 .pdf。
• 如果用了自动化，附上源脚本或 JSON 计划。
• 简短说明复刻限制，尤其是图标和字体。

教程分享任务建议交付：

• Skill 或流程文件夹。
• 环境检查脚本。
• 可复用 Visio 生成脚本。
• 一句别人可以直接复制的示例提示词。
• 导出预览质量检查清单。

内置脚本

• scripts/check_visio_environment.ps1：检查 Visio、COM 启动、导出和转换工具。
• scripts/create_visio_from_plan.ps1：根据 JSON 计划创建 .vsdx，支持页面尺寸、图形、连接线、文字和可选参考图。

任务需要稳定生成 Visio 文件时，优先读取或运行这些脚本。