Menu
使用PPT模板生成演示文稿。根据用户主题，通过SVG路径或模板填充方式生成专业PPT。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | ppt-auto |
| description | 使用PPT模板生成演示文稿。根据用户主题，通过SVG路径或模板填充方式生成专业PPT。 |
| runAs | subagent |
| effort | high |
| allowed-tools | bash, read_file, write_file, edit_file, grep, todo_write, image_understand, image_generate, web_search, web_fetch |
根据用户主题和PPT模板，生成专业演示文稿，输出为 .pptx 文件。
本 skill 需要系统已安装 Python 3.10+（不再携带嵌入式运行时，跨平台通用）。
首次使用前，请安装依赖：
bash <skill_dir>/setup_python.sh<skill_dir>\setup_python.bat脚本会执行 pip install -r <skill_dir>/requirements.txt 安装 python-pptx、Pillow、lxml 等依赖（纯 Python，无需 Office）。
若系统中没有
python3命令，请先安装 Python 3.10+：
- macOS：
brew install python- Ubuntu/Debian：
sudo apt install python3 python3-pip- Windows：从 https://www.python.org/downloads/ 安装并勾选 "Add to PATH"
<project_dir>/exports/*.pptx（+ 可选 PDF），每页带演讲者备注。todo_write 跟踪进度（尤其多页 PPT）。下文命令中 <skill_dir> 和 <project_dir> 是占位符，调用时替换为实际绝对路径：
<skill_dir>：本 skill 的安装目录（即 SKILL.md 所在目录）。<project_dir>：Step 4 init 创建的工作目录（init 会打印它的绝对路径）。后续所有文件（SVG、备注、导出）都在它下面。在 Step 4 init 之前，<project_dir> 不存在——需要它的步骤都在 init 之后。Windows 提示：下文统一用
python3。若 Windows 上python3命令不存在（python.org 的安装包只提供python.exe），把python3换成python即可。
默认走路线 A（SVG 路线），除非用户明确要求"直接用模板填充/不改版式"才走路线 B：
svg_to_pptx.py 用纯 Python（python-pptx），不需要安装 Office。template_fill_pptx.py）。保留模板原有版式，适合"模板已经很完美，只想换文字/数据"。如果用户提供了文档，先提取内容。注意此时尚未 init 项目，输出路径用一个临时位置（Step 4 init 后再移入 <project_dir>/sources/）：
python3 <skill_dir>/scripts/extract_content.py <file1.pdf> <file2.docx> source_content.json
支持格式：PDF、DOCX、XLSX、CSV、TXT、MD。init 完成后把产物挪到 <project_dir>/sources/。
如果用户主题需要最新数据：
web_search(query="<根据用户主题组织搜索关键词，如：XX行业 2024 最新趋势/数据/政策>")
在生成 SVG 之前，先规划好每页的内容大纲。这一步分两段：先构思，init 项目后落盘成文件。
根据主题、源文档、搜索结果，规划每页的内容大纲。大纲内容必须来自用户给的具体主题和素材，不要套固定结构。
每页大纲包含：
references/layout_templates.md 的布局选型构思完成后，在 Step 4 init 项目之后，把大纲写入 <project_dir>/design_spec.md（项目根目录）。这一步必须落盘——项目的验证逻辑（project_manager.py validate）会检查该文件是否存在，缺失会警告 "Missing design specification file"；且生成中途你要反复回看大纲保证每页贴合规划，不落盘容易跑偏。
python3 <skill_dir>/scripts/project_manager.py init <project_name> --format ppt169
init 会创建标准项目目录，后续所有步骤的文件都落到对应子目录，路径不要写错：
| 目录 | 用途 | 由哪一步写入 |
|---|---|---|
svg_output/ | 逐页 SVG 源文件（slide_01.svg…） | Step 8 生成 SVG |
notes/ | 演讲者备注 | Step 11 |
exports/ | 最终 PPTX / PDF | Step 12、Step 14 |
backgrounds/ | 模板导出的背景图 | Step 6 |
previews/ | PPTX 截图（仅 validate 模式） | Step 13a |
sources/ | 源文档 | Step 1（可选） |
svg_to_pptx.py默认从svg_output/读 SVG、从notes/读备注、输出到exports/。若 SVG 没写到svg_output/，转换会读不到。
init 完成后，立刻把 Step 3 构思的大纲写入 <project_dir>/design_spec.md（项目根目录的 markdown 文件）。这是后续生成 SVG 时的内容蓝图，也是项目完整性校验的必需文件。
在任务开始时，读取一次 template_config.json，并把其中约束牢记在心、贯穿后续所有 SVG 生成：
read_file <skill_dir>/template_config.json
template_config.json 是配色、字号、布局规则、内容密度的唯一事实源。 生成每一页 SVG 时严格遵守其中字段——check_svg.py（Step 10）会按这份配置检查，自行发挥的配色会通不过。关键字段：colors（hex 值）、fonts、rules（forbidden 元素/字数/对齐/留白/background_rules/content_density）、default_prompt。
下方 Step 7/8 会把这些约束展开成生成时可直接套用的具体值，方便逐页生成 SVG 时参考——但若与 config 有出入，以
template_config.json为准（config 是检查器实际校验的依据）。
python3 <skill_dir>/scripts/analyze_template.py <template.pptx> <project_dir>/backgrounds/
⚠️ 此脚本通过 COM 调用 PowerPoint 或 WPS 导出每页背景图。若机器上两者都未安装，会报错——此时回退为不使用模板背景（SVG 用纯白底 + config 配色），并告知用户"未检测到 Office/WPS，已用纯色背景代替模板背景"。
根据 Step 3 的大纲，为每页选定布局类型。版式要多样，同一版式不超过总页数的 1/5。
布局选型参考 references/layout_templates.md——它给出每种布局的坐标规格（封面、2×2卡片网格、时间线、左右对比、表格、仪表盘等）。规划时就对照它选，不要等到生成时才找。
模板使用原则（来自 template_config.json 的 template_usage）：背景保持原样、保留 logo、遵循配置配色、布局可调整但须商务克制。
逐页生成 SVG，每页写入 <project_dir>/svg_output/slide_01.svg、slide_02.svg…（文件名按页序编号，svg_to_pptx 按此顺序合成）。每页 SVG 都必须：
<image> 元素"0 0 1280 720"font-family="Microsoft YaHei, Arial, sans-serif"#1084CD，强调色 #FF7F00，浅蓝 #D9EAF7/#EAF5FC，正文 #333333，辅助文字 #888888#1084CD，正文用 #333333，辅助说明用 #888888；不要在深色底上放大量正文#FF7F00 只用于关键数据、按钮、警告、待办/风险标记，每页最多 1 个橙色焦点filter/feDropShadow/pattern/mask/foreignObjectx=60, y=60，font-size=26，fill=#1084CD，bold（左上角固定，勿居中）以上 4–10、13 条的具体值（配色、字号、标题位置）均与
template_config.json的colors/rules/default_prompt一致，列出是为了生成时直接套用。若将来改了 config 的配色，以 config 为准。
中国移动商务风格补充约束（也源自 config，生成时务必遵守）：
视觉元素来源：
| 需求 | 方式 |
|---|---|
| 封面主视觉图 / 内容页配图 | image_generate 工具 |
| 图表/流程图 | 引用 templates/charts/ 模板（见下方资源；charts_index.json 含选型规则） |
| 图标 | 引用 templates/icons/ 库 |
| 装饰元素 | 直接写 SVG 代码 |
fix_svg.py 处理单个文件，对 svg_output/ 下每一页都跑一次（输入和输出可以是同一个文件，就地修复）：
python3 <skill_dir>/scripts/fix_svg.py <project_dir>/svg_output/slide_01.svg <project_dir>/svg_output/slide_01.svg
# 对 slide_02.svg、slide_03.svg … 重复
check_svg.py 同样是单文件，对每页跑一次：
python3 <skill_dir>/scripts/check_svg.py <project_dir>/svg_output/slide_01.svg --config <skill_dir>/template_config.json --mode <fast|validate>
# 对每页重复
模式由用户在设置页选择（template_config.json 的 mode 字段）：**fast（默认）跳过本步直接进 Step 11；validate**逐页检查，有问题的页用 edit_file 改 SVG 后重查，最多 3 轮。
python3 <skill_dir>/scripts/save_notes.py <project_dir> <notes_json>
备注规则：
python3 <skill_dir>/scripts/svg_to_pptx.py <project_dir>
此步用 python-pptx（纯 Python），不需要 Office。
仅在 mode=validate 时执行。快速模式跳过。
Step 13a: 导出截图（需要 PowerPoint/WPS）
python3 <skill_dir>/scripts/export_previews.py <project_dir>
⚠️ 此脚本通过 COM 调用 PowerPoint/WPS 截图。未安装则跳过本步并告知用户。
Step 13b: 逐页检查
对每页截图调用 image_understand：
image_understand(
image="<project_dir>/previews/slide_03.png",
prompt="检查这个PPT页面：
1. 文字是否压住了边框或装饰线？
2. 文字是否超出了框体边界？
3. 元素是否对齐整齐？
4. 颜色是否协调统一？
5. 文字是否清晰可读？有没有内容丢失或看不清？
6. 结尾页是否只有致谢文字（没有多余内容）？
每项回答：是/否
最后总结：通过/需改进+具体问题"
)
Step 13c: 修正问题
如果发现问题：记录问题页面 → 用 edit_file 只改该页 SVG（不要整体重写）→ 修复 + 检查 + 转换 → 再次检查，直到通过。
python3 <skill_dir>/scripts/export_pdf.py <input.pptx> <output.pdf>
⚠️ 此脚本通过 COM 调用 PowerPoint/WPS。未安装则跳过并告知用户。
edit_file 改单页 SVG，其他页保持不变当用户明确要求"直接用模板填充/不改版式"时，用 template_fill_pptx.py 直接在原生 PPTX 模板的占位符里填内容：
analyze（分析模板结构）→ scaffold（搭内容骨架）→ check-plan（校验计划）→ apply（填充）→ validate（校验）
与路线 A 二选一，不要混用。详细参数见 template_fill_pptx.py --help。
用户自然语言输入覆盖 template_config.json 中的默认值：
| 用户说 | 覆盖内容 |
|---|---|
| "用XX模板" | template |
| "做10页" | pages |
| "深色风格" | style + colors |
| "用绿色主色" | colors.primary |
| "要有表格" | content_requirements 追加 |
| "快速模式" | mode = fast |
| "校验模式" | mode = validate |
| 脚本 | 功能 | 依赖 |
|---|---|---|
| extract_content.py | 提取源文档内容（PDF/DOCX/XLSX/CSV/TXT）→ JSON | 纯 Python |
| project_manager.py init | 初始化项目目录结构（推荐）。⚠️ import-sources 子命令依赖未打包的脚本，本 skill 内不可用，导入源文件请改用 extract_content.py | 纯 Python |
| fix_svg.py | 修复 SVG XML 错误 | 纯 Python |
| check_svg.py | SVG 质量检查，支持 --config <json> --mode fast|validate（按 config 校验） | 纯 Python |
| svg_to_pptx.py | svg_output/ + notes/ → exports/*.pptx | python-pptx（纯 Python） |
| save_notes.py | 保存演讲者备注到 notes/ | 纯 Python |
| svg_quality_checker.py | SVG 质量检查（详细版，支持 --template-mode/--format） | 纯 Python |
| analyze_template.py | 模板分析，COM 导出每页背景图 | 需 PowerPoint 或 WPS |
| export_previews.py | 从 exports/*.pptx 导出每页 PNG 截图 | 需 PowerPoint 或 WPS |
| export_pdf.py | PPTX → PDF 导出 | 需 PowerPoint 或 WPS |
| template_fill_pptx.py | 路线 B 专用：不经 SVG，直接填充原生 PPTX 模板 | 见脚本内说明 |
| 资源 | 数量 | 用途 |
|---|---|---|
| templates/charts/ | 23 个图表 SVG + charts_index.json（含 71 个图表的选型规则） | 图表/流程图，可直接引用 |
| templates/icons/ | 5 个图标库（chunk-filled / phosphor-duotone / simple-icons / tabler-filled / tabler-outline） | 图标，可直接引用 |
| templates/visual-styles/ | 19 种视觉风格 | 设计参考 |
| templates/modes/ | 6 种叙事模式 | 内容组织参考 |
| references/layout_templates.md | 多种布局坐标规格 | Step 7 规划时对照选型 |
| references/error_handling.md | 错误处理指引 | 排错参考 |