# Codex Visio Replica Workflow

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

- Skill: `uigiuf/codex-visio-replica-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add uigiuf/codex-visio-replica-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uigiuf/codex-visio-replica-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: uigiuf (https://skillmd.com/u/uigiuf)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/uigiuf/codex-visio-replica-workflow

---


# 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 脚本。推荐这样加载：

```powershell
$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 文件时，优先读取或运行这些脚本。