| name | ppt-master |
| description | 生成和导出 PPT 的专业工作流 Skill。适用于把 Markdown、报告、方案、会议材料或已有文档整理为演示文稿，按策略规划、设计规范、SVG 页面生成和 PPTX 导出步骤执行。 |
PPT Master for WorkWise
这是 WorkWise 内置的 PPT Master 瘦身版，用于把资料、提纲、报告或 Markdown 内容转成结构化演示文稿。它保留核心工作流、脚本、参考规范、通用图表模板、常用布局、localhost 确认页和两个轻量顶级咨询风 examples；不内置全量官方示例、用户 projects、导出结果、备份目录、大体积 icon 库或私有 PPT 文件。
适用场景
- 用户要求“做 PPT”“生成演示文稿”“把这份方案转成 PPT”“把 Markdown 做成汇报材料”。
- 需要把工程方案、项目汇报、经营分析、产品介绍、培训材料整理成 16:9 或其他比例的演示文稿。
- 需要先确定受众、页数、风格、配色、图表表达，再生成可导出的 PPTX。
WorkWise 约束
- 不使用 Pandoc。文档转换优先使用 Python 原生路径；不支持的旧格式应请用户转为 Markdown、DOCX、PDF、HTML、XLSX 或 PPTX 后再处理。
- 不读取或打包用户本地
projects/、全量官方 examples/、exports/、backup/ 等目录；内置 examples/ 只作为少量风格参考，内置 projects/ 只是空占位目录。
- 不默认使用大体积
templates/icons/ 图标库。需要图标时优先使用当前项目已有素材、简洁 SVG 形状或用户明确提供的图标资源。
- 如果用户提供公司私有材料，只在当前工作区生成项目文件，不写入内置 Skill 目录。
- 生成图片素材时，优先使用 WorkWise 的 Agnes AI 生图能力或用户指定素材；不得臆造真实现场照片。
核心流程
- 明确输入：确认主题、受众、页数范围、语言、比例和交付格式。
- 整理资料：将用户提供的 Markdown、报告正文、PDF/DOCX 转换或摘要为可用于分页的内容。
- 创建项目：用
scripts/project_manager.py 初始化项目目录，项目应放在用户当前工作区。
- 本地确认页：先写入
<project>/confirm_ui/recommendations.json，默认启动 scripts/confirm_ui/server.py <project> --daemon --wait，让用户在 localhost 页面选择风格、字体、受众、页数、配色、图片策略等；浏览器不可用时再回落到聊天确认。
- 策略规划：读取
references/strategist.md 和 templates/design_spec_reference.md，结合 confirm_ui/result.json 输出设计规范、内容大纲和执行锁定文件。
- 页面生成：启动
scripts/svg_editor/server.py 作为 localhost 实时预览，然后按页生成 SVG 页面；每页遵守 spec_lock.md，需要图表时参考 templates/charts/charts_index.json。
- 质量检查：运行 SVG 检查、修复尺寸和资源引用，必要时逐页修正。
- 导出 PPTX：用
scripts/svg_to_pptx.py 导出为 PowerPoint 文件。
常用脚本
| 脚本 | 用途 |
|---|
scripts/project_manager.py | 初始化、校验和管理 PPT 项目 |
scripts/confirm_ui/server.py | Step 4 本地确认页，用于选择风格、字体、受众、页数、配色、图片策略等 |
scripts/svg_editor/server.py | Step 6 本地 SVG 实时预览页 |
scripts/svg_to_pptx.py | 将 SVG 页面导出为 PPTX |
scripts/finalize_svg.py | SVG 后处理 |
scripts/svg_quality_checker.py | SVG 质量检查 |
scripts/update_spec.py | 批量更新设计规范相关字段 |
scripts/total_md_split.py | 拆分讲稿或长 Markdown |
scripts/source_to_md/pdf_to_md.py | PDF 转 Markdown |
scripts/source_to_md/doc_to_md.py | DOCX/HTML/EPUB/IPYNB 等原生路径转 Markdown |
scripts/source_to_md/excel_to_md.py | XLSX/XLSM 转 Markdown |
scripts/source_to_md/ppt_to_md.py | PPTX 转 Markdown |
scripts/source_to_md/web_to_md.py | 网页转 Markdown |
执行要点
- 在动手生成前，默认使用
confirm_ui 本地页面完成 8 项确认；如果启动失败或用户明确不需要页面，再用聊天方式确认同一组字段。
confirm_ui 默认端口为 5050，被占用时会自动尝试 5051 等后续空端口；实际 URL 以脚本输出为准。- 用户在页面点击 Confirm 后，读取
<project>/confirm_ui/result.json，不需要再要求用户在聊天里二次确认。
- 如果用户已在聊天中明确确认这些要素，可以直接进入项目创建和生成，但仍应记录关键选择到
design_spec.md 与 spec_lock.md。
- 长文档或大页数时，建议分阶段：先完成策略和
design_spec.md，再继续生成 SVG 和 PPTX。
- 每页 SVG 生成前都要重新读取
spec_lock.md，避免长任务中风格漂移。
- 图表页优先复用
templates/charts/ 的通用结构，并根据实际数据改写，不要为了好看牺牲数据含义。
内置参考
examples/ 保留两个轻量顶级咨询风示例，仅含 design_spec.md 和 svg_final/，用于参考风格、页面节奏和信息密度。projects/ 是默认输出位置的占位目录。正式运行时应在用户当前工作区创建项目，不要把用户材料写回内置 Skill 目录。templates/layouts/ 保留少量官方通用布局；templates/icons/ 全量图标库仍不内置。
依赖
运行脚本前可按需安装：
pip install -r ${SKILL_DIR}/requirements.txt
如果只是把现成 SVG 导出为 PPTX，通常只需要 python-pptx。本地确认页和实时预览需要 flask。PDF、DOCX、Excel、网页和图片处理能力按任务需要安装对应 Python 包。
