Document PPTX 是一项专注于 PowerPoint(.pptx)幻灯片与模板构建、编辑和检查的技能,核心构建工具为 PPTX-Automizer。资料明确其边界:当 claude.ai 的 Slides artifact 类型或官方 Anthropic pptx 技能可用时,纯创建/编辑、通用模板填充和视觉 QA 应优先使用它们;本技能用于其专项领域。
用途方面,资料列出四条专长方向:一是在自动化前检查模板,包括版式、占位符 idx、形状名称与 OOXML 部件;二是使用 PPTX-Automizer 填充设计师自有模板;三是提取演讲者备注以及检查损坏的演示文稿;四是进行无障碍与 EN 301 549 审查。
主要能力与脚本方面,资料提供快速参考表:检查模板用 scripts/pptx_inventory.py --json,可获得版式名称、占位符 idx 与类型、形状名称;检查损坏演示文稿或其部件用 scripts/pptx_ooxml_inspect.py,可发现损坏的关系、缺失目标与修复对话框;提取或备份演讲者备注用 scripts/pptx_extract_notes.py,支持 Markdown 或 JSON;填充设计师自有模板使用 PPTX-Automizer,仅做命名元素替换(图表数据、文本、表格、图像);Python 报告或提取使用 python-pptx;JS/TS 或浏览器导出使用 PptxGenJS,支持真正的组合图表,默认 16:9 版式。
退出码方面,pptx_ooxml_inspect.py 返回 0 表示无损坏的关系目标,返回 1 表示发现损坏目标(作为门禁),--report-only 对结构良好但目标损坏的包返回 0,返回 2 表示文件缺失、无效包或关系部件格式错误;pptx_inventory.py 与 pptx_extract_notes.py 返回 0 表示已写入,返回 2 表示文件缺失、不可读或非 .pptx。
使用方式上,资料给出决策规则:优先模板还是从零开始——当演示面向外部受众、需要品牌或法务审查、或请求点名“我们的模板”时使用品牌模板;内部草稿、探索性原型或数据驱动报告可从零构建。存在模板时绝不猜测品牌颜色、字体或版式名称,应先盘点。无模板且无品牌要求时,干净的无品牌演示优于虚构的企业风格。PPTX-Automizer 仅用于窄范围填充,它将命名元素合并进设计师所有的结构中,不是通用幻灯片生成器。版式始终按名称解析,因为版式索引在不同模板间不可移植。占位符需按 idx 集合判断,slide.placeholders 中 1 恒为 False,应使用 {ph.placeholder_format.idx for ph in slide.placeholders} 测试。每页一个要点,图表数据可追溯到唯一数据源并注明单位、时间范围和来源。无障碍是编写的一部分,包括标题、阅读顺序、对比度和替代文本,而非最后一步。
工作流为:分类任务(新演示、模板填充、备注提取或修复);在编写幻灯片代码前先构建叙事;在任何自动化更改前检查模板;生成或编辑后运行发布门禁。发布门禁要求最终保存后重新打开并盘点幻灯片数量、版式名称、占位符、媒体关系、图表数据和演讲者备注,在声明的交付目标中将每页渲染为图像或 PDF,检查文字裁切、字体替换、幻灯片外对象、图表标签损坏、低分辨率图像和意外的空白占位符;当 PowerPoint 保真度或无障碍是验收标准时须进行真实 PowerPoint 通过,否则标记为未验证。渲染后需与源数据比对图表和标题数字。
已知限制包括:python-pptx 没有动画 API 和幻灯片切换 API,需直接编辑 OOXML 的 <p:timing>/<p:transition>;python-pptx 无法创建真正的组合图表(柱形加折线),需填充模板组合图表或使用 PptxGenJS;python-pptx 没有渐变填充 API,也没有受支持的编辑主题颜色方式;颜色类为 RGBColor 而非 RgbColor;默认幻灯片尺寸不同,python-pptx 默认 10 × 7.5 英寸(4:3),PptxGenJS 默认 10 × 5.625 英寸(16:9);PptxGenJS 无幻灯片切换或自动前进选项;PPTX-Automizer 的 modifyElement(selector, callback) 接收修改回调而非选项对象;盲目编辑模板可能破坏时序、媒体或可修复性;库行为在版本间会变化,需针对已安装版本重新测试。
参考资料包括版式、图表、模板品牌、演讲者备注交付、无障碍合规、故障排查修复、动画与切换、演示叙事与视觉模式、提取栈等文档,以及 data/sources.json、三份脚本、三份模板资源(pitch-deck.md、quarterly-review.md、slide-narrative-template.md)和若干相关技能。