以 skill 自身的术语
这是一份关于使用 PptxGenJS 构建单张 PowerPoint 幻灯片背后 JavaScript 的实现指南,面向每人负责一张幻灯片的编程 Agent。它首先固定了周边契约:10 × 5.625 英寸的 16:9 画布、一个仅包含 primary、secondary、accent、light 和 bg 的 theme 对象、与 slideConfig 一起导出的同步 createSlide 函数,以及每个文件都可独立运行的预览。
除此之外,它还强制执行一系列规范——微软雅黑或 Arial 字体、正文不加粗、只使用调色板中的颜色、不使用渐变或动画——并要求除封面外每张幻灯片都带页码标记。QA 被定位为一场 bug 排查,只有在完成“修复并验证”循环后才算结束。
它产出什么
- 每张单独幻灯片都要有一个完整、可运行的 JavaScript 文件。
工作方式
- 01先阅读 PptxGenJS 参考文档
在编写幻灯片代码之前,先打开 pptxgenjs.md 查看完整的 API 范围:设置与结构、文本与格式、列表、形状与阴影、图片与图标、背景、表格与图表。
- 02保持 createSlide 为同步函数
入口函数必须是普通函数而非 async 函数,因为编译步骤不会对其使用 await。
- 03基于 theme 对象进行渲染
每一种颜色都取自传入的 theme——例如幻灯片背景色——而不是硬编码写入。
- 04导出模块契约
每个文件都需要把 createSlide 与 slideConfig 一并返回,这样编译脚本才能组装整份演示文稿。
- 05把 QA 当作找 Bug
在首次渲染时主动寻找问题,而不是确认效果看起来还算过得去。