SuperAPI AI 工具集

ppt

办公与效率

查看项目

更新于 10-22 16:16

技能介绍

用途

本技能用于端到端构建幻灯片(PPT / PowerPoint / 演示文稿 / slide decks),将文件系统当作数据库:每个演示文稿是 .pptwork/<deck-name>/ 下的一个文件夹,其中 deck.json 是幻灯片顺序的唯一事实来源,每页文件夹包含 design.md、slide.html、thumbnail.png,可选包含 outline / 研究笔记。

主要能力

  • 方法论:意图澄清、素材消化、研究、故事规划、视觉 QC、导出,分为 references/<phase>.md 阶段文档。
  • 脚本:deck.mjs 用于创建、调整、删除、列出演示文稿和幻灯片;screenshot.mjs 无头渲染 slide.html 生成 thumbnail.png;export.mjs 导出 PPTX,支持 editable 与 raster 两种模式。
  • 模板桶:内置 assets/corporate-light/(5 个布局:封面、议程、两栏+图表、KPI 行、结尾)与 assets/claude-warm/(5 个布局:封面、章节、时间线、引言、便当网格),每个桶有 index.json 描述布局 id、pageType、description、authoringHints、htmlPath。也支持跳过模板桶从零编排。
  • 单页编写由配套 ppt-html-authoring 技能负责。

使用方式

首次安装:在 skills/ppt 目录下运行 npm install(或 bun install)。截图/导出脚本会按顺序寻找 Chrome/Edge:PPT_BROWSER_EXECUTABLE 环境变量 → playwright 内置 chromium → 系统 Chrome (channel) → 系统 Edge;若均不可用,运行 npx playwright install chromium。 所有脚本针对 process.cwd()/.pptwork/ 操作,需从用户项目根目录运行。

端到端流程(单一操作者逐阶段执行):

  1. 澄清意图(受众、场景与长度、页数、风格/品牌、必备章节、输出语言、是否需要核实外部事实、导出目标)。默认推荐 raster(像素保真、不可在 PowerPoint 中编辑);editable 仅在需要在 PowerPoint 内编辑时使用,且需遵循 references/editable-html-rules.md,存在布局漂移风险。
  2. 可选素材消化 → references/material-digest.md。长文档/多文件/会议纪要或大型参考 deck 时触发。
  3. 可选研究 → references/research.md。涉及时效数据、需核实数字/事实、缺少竞品/行业基准时触发。技能不自带 web fetch/search,应使用宿主应用内置 webfetch/websearch,并将结构化发现归档到 .pptwork/<deck>/materials/research.md。
  4. 故事规划 → 输出 .pptwork/<deck>/outline.md(≥5 页)或结构化上下文摘要,做模板多样性、来源引用、必备章节覆盖的轻量审查。此阶段不写 slide.html。
  5. 初始化 deck 与幻灯片骨架: node skills/ppt/scripts/deck.mjs init <deck-name> --mode raster node skills/ppt/scripts/deck.mjs init-slide <deck-name> <slide-name> 先编写 1~2 页并与用户确认再扩展,避免结构错误导致返工。
  6. 逐页编写:交由 ppt-html-authoring 技能,产出 design.md(frontmatter title + layout + ## Content / ## Note / ## Design)和自包含单文件 slide.html(演讲者备注镜像到 #ppt-speaker-notes-json script 岛)。长 deck 需逐页运行,不要批量一次编写多页。
  7. 视觉 QC:运行 node skills/ppt/scripts/screenshot.mjs <deck> <slide>,阅读 thumbnail.png 并按 references/visual-qc.md 清单检查,微调 slide.html,最多迭代 3 次,未解决问题反馈用户。
  8. 导出: node skills/ppt/scripts/export.mjs <deck-name> # 默认 editable(html2pptx-pro) node skills/ppt/scripts/export.mjs <deck-name> --mode raster # 高保真回退 node skills/ppt/scripts/export.mjs <deck-name> --editable-engine dom-to-pptx # 备用诊断引擎 输出默认 .pptwork/<deck-name>/<deck-name>.pptx,可用 --output <path> 覆盖。deck.json 的 exportMode 可设定默认模式;未设置则视为 editable。

修改循环:编辑 slide.html → screenshot.mjs 验证 → export.mjs 发布。不要直接编辑导出的 .pptx 并期望回写。若先创建了 raster/复杂 HTML deck 后需要 editable PPTX,需先按 editable-html-rules.md 用语言模型重写每页 slide.html,再截图 QC 并导出 editable。

模板桶结构:assets/<bucket>/ 包含 index.json、html/<id>.html、可选 specs/<id>.json、可选 materials/<id>/manifest.json。index.json 条目需含 id、pageType、description、authoringHints、htmlPath,可选 materialDir、zones。故事规划只读取 id / pageType / description / authoringHints,不读原始 HTML;编写阶段可借鉴 HTML 的构图(安全区、列、层级、槽位),但不要复制占位文案。

适用场景

需要规划、编写、截图或导出整套演示文稿的场景,尤其适合希望以 HTML 为源、可控导出为 PPTX 的工作流。

限制

  • 无内置 web fetch/search 工具,依赖宿主应用能力。
  • editable 导出在复杂 CSS / 字体 / SVG 上可能漂移,需要 PowerPoint 验证;raster 不可编辑。
  • dom-to-pptx 为备用诊断引擎,仅支持单页备份导出,已知有布局漂移。
  • 单页编写为硬性约定,不能批量一次编写多页。
  • 费用、价格、具体平台兼容性等资料未提供。