Imported from SunnyBoy-y/LearnGraph (
backend/app/skills/pptx_generation/SKILL.md). Install upstream withnpx skills add SunnyBoy-y/LearnGraph --skill pptx_generation. Copyright stays with the author.
PPT 生成与检查
When to use
- 用户要生成一份演示文稿（PPTX），已有大纲/要点/结论。
- 需要读取既有
.pptx的幻灯片文本、统计页数、检查结构。 - 需要把 PPTX 内容变成可打印/可预览的 HTML（离线无 LibreOffice，不能直接渲染 PPTX 为 PDF/PNG）。
路由边界：普通生成、朴素模板、读取或检查已有 PPTX 都走本 Skill；只有用户明确要求高端视觉设计、PPT 美化、逐页 1280×720 SVG、路演/答辩设计稿，或点名
ppt-agent时，才转ppt-agent。
决策顺序
- 生成：先整理一份结构化大纲 JSON（标题、要点、备注、可选分区），再
build_deck.py生成.pptx。 - 读取：
inspect_deck.py抽取每页文本与形状统计。 - 预览：
deck_to_html.py把幻灯片文本转成可打印 HTML，再交给document-conversion/html_to_pdf（不能直接渲染 PPTX）。 - 不联网、不下载模板字体；版式由脚本内置的简洁模板决定。
脚本索引
| 脚本 | 用途 |
|---|---|
build_deck.py |
从大纲 JSON 生成 PPTX（python-pptx） |
inspect_deck.py |
抽取 PPTX 幻灯片文本/形状统计 |
deck_to_html.py |
PPTX 文本 → 可打印 HTML 预览 |
组合路线
大纲.json ──build_deck──> 报告.pptx
报告.pptx ──inspect_deck──> 文本统计
报告.pptx ──deck_to_html──> 预览.html ──(document-conversion html_to_pdf)──> 预览.pdf安全与限制
- 离线运行，不联网、不执行包安装、不下载模板。
- 大纲 JSON 必须是受控结构（见
references/input-output-contract.md）；所有标题/要点来自用户提供或模型整理的内容，不得编造幻灯片内容。 - PPTX 无法离线直接渲染为 PDF/PNG（镜像不含 LibreOffice）——要交付视觉版请走
deck_to_html → html_to_pdf。
详细说明
组合配方见 references/best-combinations.md，输入/输出契约见 references/input-output-contract.md，常见失败见 references/troubleshooting.md。每个脚本的完整用法见 scripts/*.md。