HTML 幻灯片转 PPTX 转换器
把结构化的单页或多页 HTML 幻灯片转换成原生可编辑的 PowerPoint 文件，而不是截图式的图片导出。
证据显示该 skill 仅为本地文件转换工具，依赖仅 cheerio 与 pptxgenjs，无网络调用、无敏感数据处理或外部副作用的迹象；提供 check-env 自检、显式安装说明与中间模型 dump，数据流较透明。扣分点：核心脚本源码未在本次审查范围内提供，无法核实其least-privilege与回滚行为；许可元数据存在冲突（包内 ISC，仓库级 Apache-2.0），来源归属不完整。
文档自洽、工作流清晰（识别preset→转换→QA→迭代），有环境自检、依赖故障排查（cheerio/pptxgenjs 缺失）、可移植性说明和 preflight QA 层，失败反馈设计较好。扣分点：无独立测试套件（test 脚本仅指向 check-env），关键路径未经验证可复现，静态校准上限为10。
适用范围与非目标（非通用 HTML/CSS 转换器、非截图导出）声明明确，preset 决策规则详尽，语义触发条件（用户有结构化 HTML slide 且需可编辑 PPTX）清晰；qa-heuristics.md 为中文，中文支持良好，依赖仅来自 npm，无完全不可达的境外服务依赖。扣分点：仅支持两个极窄的 preset 家族，未执行验证触发精度。
文档分层良好（SKILL.md→README→references），有 preset 模板、决策规则、QA 启发式与 roadmap，扩展路径明确。扣分点：许可元数据冲突（ISC vs Apache-2.0）、package. author 为空、无版本/变更日志、无明确维护责任声明；roadmap 中的项目与已交付能力混杂。
核心价值主张（将结构化 HTML 转为可编辑原生 PPTX 对象而非截图）明确，边际价值在分析师风格固定版式场景下可观，工作流包含 QA 与迭代机制。扣分点：无任何已验证的代表性输出，可编辑性与保真度完全未经执行证据支持，静态校准上限为7，且证据薄弱故再降。
提供了 lockfile（含 integrity 哈希）、详细的引擎已知限制（引用 PptxGenJS/python-pptx issue 编号）和原型来源文件路径，属可审计的一手材料。扣分点：所有关键声称（转换质量、QA 有效性）均无执行或第三方佐证，引用的 issue 无法在源文件内核实，覆盖率单薄。
- 本次为静态审查，未执行任何脚本；转换质量、可编辑性与 QA 有效性均未验证，使用前请在自有样例上实测。
- 许可元数据冲突：包声明 ISC，仓库 README 声明 Apache-2.0，商用前需确认实际许可。
- 仅支持两个极窄的 preset 家族（v9-architecture、ai-runtime-page），不匹配结构时需自行新增 preset，成本不可忽略。
- 未提供独立测试套件，test 脚本仅执行环境检查，可靠性主要依赖文档描述。
- 发布者身份未经 FollowSkills 注册表验证，维护与更新路径不明确。
这个 Skill 能做什么，适合哪些场景？
这是一个预设（preset）驱动的转换工具：读取结构化的 HTML 幻灯片，解析出语义区块，再映射为原生 PowerPoint 对象（文本框、形状、chips、箭头、面板）。它只承诺对已支持版式的还原度，不承诺任意 HTML/CSS 的通用转换；遇到新版式时，需要先添加新 preset 再转换。每次生成都会运行 preflight QA 检查，适合迭代式地逼近版式还原。源码位于 mucsbr/ppt-agent-workflow-san 仓库的 html-slide-to-pptx/ 目录，采用 Apache 2.0 许可证。
读取输入的 HTML 幻灯片文件，判断其是否属于某个已支持的幻灯片家族（preset），将其解析为小型中间模型，再通过内置脚本生成含原生文本和形状的 PPTX。提供 npm run check-env 检查环境、node scripts/html_to_pptx.js <input.html> <output.pptx> 执行转换（可指定 --preset 和 --dump-model）、node scripts/preflight_qa.js <model.> 运行 QA。若现有 preset 不匹配，按文档要求实现 DOM 提取规则、布局映射规则和 QA 规则三层来新增 preset。
- 需要制作 Gartner/分析师风格技术幻灯片的用户，希望从 HTML 设计稿得到可编辑的 PPTX 而非截图。
- 需要将架构页（分层架构堆叠、驱动面板、判断链条面板）转为可编辑 PowerPoint 的技术人员。
- 需要将 AI 运行时页面（输入/输出 chips、模块化运行时框、支撑层卡片）搬进 PPT 的产品或方案团队。
- 使用 ppt-workflow 先产出 HTML/PNG 预览、确认版式后再正式交付可编辑 PPT 的完整工作流用户。
- 能阅读并扩展 preset 规则的工程型用户，可为新的固定版式 HTML 页面家族添加支持。
这个 Skill 有哪些优点和局限？
- 输出的是原生可编辑 PowerPoint 对象，而不是截图贴图，方便后续在 PPT 里继续修改。
- 内置 preflight QA 流程，每次生成都会检查间距、溢出、箭头方向等常见问题。
- preset 机制明确：只承诺已支持版式的还原度，避免对任意 HTML 做不切实际的转换承诺。
- 有完整的扩展文档（setup、preset 决策规则、preset 模板、QA 启发式、路线图），便于工程用户扩展新版式。
- 目前只支持两个预设版式（v9-architecture 和 ai-runtime-page），不匹配的 HTML 无法直接转换。
- 明确不承诺任意 HTML/CSS 保真；遇到新信息架构需要开发者手动实现三层 preset 规则，有开发成本。
- 仓库未提供 Topics 标签、测试套件或使用量证明；README 与 SKILL.md 对子项目数量描述不一致（README 称两个项目，仓库描述称捆绑 3 个 skill），文档一致性存疑。
- 需要 Node.js 环境和 npm 依赖，且明确要求把浏览器渲染仅作为参考而非生成引擎。
如何安装这个 Skill？
将仓库 clone 到本地：git clone https://github.com/mucsbr/ppt-agent-workflow-san.git。skill 位于仓库内的 html-slide-to-pptx/ 目录（含 SKILL.md）。在新机器或新 agent 环境上，先阅读该目录下的 references/setup.md，然后在 skill 目录运行 npm run check-env 检查环境；若缺依赖，运行 npm ci 或 npm install。具体的 agent 客户端安装路径（如放置目录位置）文档未说明。
如何使用这个 Skill？
- 把你的 HTML 幻灯片交给 agent，让它先判断是否命中现有 preset（v9-architecture 或 ai-runtime-page）。2. 命中后执行转换：node scripts/html_to_pptx.js input.html output.pptx --preset=v9-architecture（可选 --dump-model model. 导出中间模型）。3. 运行 preflight QA：node scripts/preflight_qa.js model. --preset=v9-architecture --report report.。4. 打开 PPTX 检查间距、溢出、箭头方向等问题；还原度不够时迭代 preset 映射。若结构不属于任何 preset，按 SKILL.md 要求先新增 preset 再转换。