SuperAPI AI 工具集

presentation-builder

办公与效率

查看项目

更新于 11-04 20:00

技能介绍

presentation-builder 是一个面向演示文稿创建、修订与审查的技能,核心目标是把任意主题和来源材料转化为清晰、面向特定受众的演示,使故事线、视觉、演讲者备注与运行时行为都可被审查。默认输出为一份自包含 HTML 幻灯片。

用途:适用于决策汇报、战略、产品故事、教学课程、研究报告、项目更新、技术讲解、销售叙事、演示、作品集等需要受众理解、记住、决策或行动的场景;也可用于审查已有 HTML 演示的结构、备注、编辑模式、导航、可访问性或质量问题。若仅制作 UI 界面稿,应使用 work-item 的 mockup 模式;若综合单个功能的规格、任务、设计稿等产物生成评审演示,应使用 feature-presentation,该产物可用本技能的校验器以 --profile=review 检查。

主要能力:

  • 在写幻灯片前明确受众、目标、环境、主题与证据边界、输出与交接要求。
  • 建立来源台账,把关键论断、数字、图表、引言与日期映射到来源或明确标注为假设/示意,区分事实、解读、建议与示例。
  • 先选叙事原型再布局,生成包含幻灯片 ID、用途、论断、证据、过渡、时长与备注状态的幻灯片地图。
  • 编写主题相关的设计方案(颜色令牌与对比检查、字体家族与角色/字号、布局构图、视觉语言、动效)。
  • 生成语义化、自包含的 HTML,使用稳定标记:.slide、data-slide-id、data-purpose 或 data-principle、.slide-notes、data-action="toggle-notes"、data-action="toggle-edit"。
  • 实现演讲者运行时契约:上一页/下一页按钮与方向键、PageUp/PageDown、空格、Home、End 键盘导航;备注切换与关闭(aria-expanded/aria-pressed、Escape 关闭、aria-live 状态);带 aria-pressed 的编辑模式,可编辑正文与当前页备注,结构、品牌与数据视觉元素受保护;本地命名空间草稿的防抖保存及已保存/未保存/存储不可用状态;破坏性重置确认;去除编辑状态的干净 HTML 导出;全屏及状态同步;进度文字与进度条;超过六页时的总览跳转;可访问的图像、图表、表格与逻辑阅读顺序、焦点可见、对比度与不依赖颜色的编码;打印 CSS 与减少动效路径。不自动翻页,触控/指针导航只能作为补充。

使用方式(技能内声明的命令):

  • node .claude/skills/presentation-builder/scripts/create-presentation.cjs <deck.json> <output.html>:依据 JSON 规格生成符合契约的自包含起始幻灯片,根需稳定 id,每页需稳定 id、标题、用途、原则、body/bodyHtml/typed blocks 之一,以及含 say、why、evidence、transition、timing、question 的 notes 对象。
  • node .claude/skills/presentation-builder/scripts/create-presentation.cjs --example <output.html>:生成示例规格形状的起始幻灯片。
  • node .claude/skills/presentation-builder/scripts/validate-presentation.cjs <deck.html> [--profile=presenter|review]:执行确定性静态检查。 修改工具脚本后需运行两个工具测试文件。对于 5 页及以上的幻灯片,先构建两页代表性幻灯片自评修正后再生成其余内容。

流程:框定受众/目标/环境 → 研究并建立来源台账 → 选择叙事原型 → 编写幻灯片地图 → 制定主题相关设计方案 → 生成 → 静态校验 → 有浏览器时手动排练审查 → 报告证据与局限。必须按声明步骤顺序执行并保留进度与证据;不可仅凭静态标记声称浏览器行为、离线、全屏、持久化或可访问性通过,需区分 PASS 与 NOT VERIFIABLE。

限制与注意事项:绝不虚构主题论断、精度、来源、受众或设计理据;若简报信息缺失,需声明假设而非编造事实、品牌规则、指标或引语;不得把本地存储视为协作或版本历史;默认所有必需资源本地打包,只有明确接受网络依赖时才设置 allowExternalAssets: true 并在产物中披露。

费用、价格与具体平台支持情况暂未提供。