技能介绍

要解决什么问题

很多团队用 HTML/CSS 做汇报 deck：浏览器里好看，但现场不能指望只开浏览器，同事也更习惯 .pptx。直接截图塞进 PPT 会失去可编辑文字和后续改稿空间。本技能面向「已有单文件 HTML 幻灯片」，目标是产出尽量可编辑的 PowerPoint，而不是整页糊成一张图。

技能如何工作

转换由 convert.py 驱动，流水线大致是：测量 HTML 各页布局 → 组装 OOXML → 按需从 Google Fonts subset 嵌入字体（含 CJK 时自动种子 Noto 系列）→ 结构化自检与视觉 audit。内部把 CSS 分成四档：矢量文字、矢量形状、装饰栅格（deco_snapshot）、媒体直传；普通背景色、边框、简单几何尽量留在 PPT 原生 shape/text 层。

第一次全量跑完后会在源目录生成 .audited.html 工作副本：audit 修复只改这份文件，不动你的源 HTML；后续转换默认以 audited 版为输入。支持 --only-slides 在修某几页时增量重跑 measure/对比图，但全局 CSS、字体或 deck 级 token 变更仍需全量重跑。

视觉 audit（Stage 5b）需要本机 PowerPoint COM 或 LibreOffice 把 pptx 渲成 PNG 做 HTML/PPT 半图对比；模式可在 triage / page / manual 间配置。WPS 不读 pptx 内嵌裸 TTF 时，可选把解析到的字体装到用户字体目录（需事先确认）。

边界与注意点

复杂装饰（box-shadow、gradient、backdrop-filter、mix-blend-mode 等）多走截图兜底，可编辑性会下降；彩色 emoji、background-clip: text 等需按文档走 HTML workaround。
Agent 侧应遵守「一轮修完所有 finding 再重转」、sticky 重复问题停手告知用户，以及不原地改 skill 内的 measure.py / assemble.py；通用写法沉淀到本地 lessons-learned.md。
交付前可用 --cleanup 清理 audit 中间产物，保留 .pptx 与 audited.html。