技能介绍

问题从哪来

大模型直接生成的 PPT 往往版式随意、信息密度不稳，课堂里也很难做识字闯关、分角色朗读这类互动。这条链路的做法是：先把任意资料收敛成可执行的课件规格，产出可在浏览器里放映的单文件 HTML5 互动课件，再把同一套页面骨架编译成 PPTX，让「能上课用」和「能投影讲」共用一份结构。

工作方式

技能按三阶段执行，顺序不能跳过。

Phase 1 — 输入规范化：一句话、教案 docx、课文文本、教材图片或混合资料，最终收敛为 meta、生字表、脉络、角色、难点、讨论、金句、作业，以及供后续共用的 pages.json 骨架。教案走 scripts/extract_docx.py 抽文本；图片侧依赖多模态读图做 OCR 与理解。

Phase 2 — 互动 HTML：加载 互动课件设计师（interactive-courseware-designer），按其四阶段流程产出 HTML；TeachAny 不可用时用 fmg-hdkc 兜底。低段常见模块包括趣味识字、写字小法官、故事脉络、分角色朗读（TTS）、难点可视化、讨论投票、词语排序、知识树、分层作业。HTML 按逻辑页组织，并映射为 pages.json 条目（type 决定版式）。

Phase 3 — HTML → PPTX：根据 pages.json 的 cover / intro / cards / writing / flow / read 等类型，用 scripts/build_slides.py 批量生成 .slide（内置 12 种版式），再经 slidep（tencent-pptx 底层引擎）编译为 .pptx。改 PPT 排版时通常只改 JSON 或模板，不必重做 HTML。

边界与注意

编译 PPTX 需要 MCP 后端（文档写明 localhost:39099）在线；离线环境只能稳定交付 HTML 与 .slide 源文件。
slidep DSL 有明确禁区：禁 flex 简写、禁 calc()、数组 map 的 style 须多行并以 ))} 收尾、.slide 须 LF 换行；手改模板请对照 skill 内 references/slidep_dsl.md。
Phase 2 与 Phase 3 的脚本路径、Node/Python 环境在 SKILL.md 里写的是作者本机路径，迁移到其他机器需自行对齐 slidep 与 python-pptx。
适用触发语包括「帮我做个《X》课件」「把教案转成 PPT」「课文生成课件」；若只要静态 PPT、不要 HTML 互动层，仍会被迫走完整三阶段。