pptx-document-processing skill

何时使用

• 根据已经确认的大纲与材料创建 PowerPoint，或修改用户提供的 .pptx。
• 提取幻灯片中的文字、检查布局、批量替换已确认的内容，并交付可编辑文件。
• 需要保留现有模板、图表和关系文件时，先评估编辑工具的保真范围。

边界：不把无法渲染的文件称为视觉检查通过；不把未知的宏、嵌入对象或外部链接当作可信代码执行。输入仅有旧 .ppt 时，先由用户环境中的 PowerPoint/LibreOffice 转为 .pptx，保留原件。

资源与环境

本技能正文包含完整工作流程，没有随包的 html2pptx.js、OOXML 辅助脚本或幻灯片模板。根据用户现有环境选择 PowerPoint、PptxGenJS 或 python-pptx；这些应用/库是明确的外部运行依赖，执行前记录实际版本和可用能力，不自动安装。

• PptxGenJS：适合创建具有原生文字、形状、图表的可编辑演示。
• python-pptx：适合读取文字、修改已存在的文本框和基本形状；不能假定所有高级对象往返保存都保真。
• PowerPoint/LibreOffice：用于真实打开、重算/渲染和导出 PDF；若缺失，交付时注明尚未做视觉验收。
• .pptx 是 ZIP 中的 XML 与资源集合。需要直接编辑时，用标准 ZIP/XML 库在副本上操作，无需未随包的 helper。

来源与本次重写边界见 RESOURCES.md。

步骤

1. 确定输入与交付：记录源文件、页面比例、语言、目标听众、页数和可编辑要求。源文件复制到工作目录，永远保留原件；写明最终文件和预览的绝对路径。
2. 盘点现有环境：查找用户已有的演示应用或库，并记录版本。没有可用编辑工具时先产出大纲、逐页文案和布局规格，说明生成 .pptx 所缺的具体依赖。
3. 检查输入结构：用应用或 ZIP/XML 库枚举页面、版式、母版、图片、图表、嵌入对象、备注和外部关系。记录页序和文本框标识。不要仅凭 ZIP 中文件名推断用户看到的页面顺序，应读取 presentation 的关系与页面列表。
4. 选择最小改动方式：新建文件直接用工具原生 API；修改模板尽量保留已有母版、主题和占位符。存在工具不支持的对象时，改用原应用编辑，或明确局部修改范围和仍需人工复核的对象。
5. 逐页构建或修改：先完成标题层级、正文、图表和来源，再调整排版。每次替换确认页面/形状存在；保留用户正确的现有内容与格式。图表尽量保留原生可编辑数据；把截图作为图片使用时说明它的编辑限制。
6. 结构校验：新文件写到新路径，重新打开并枚举页面。检查关系目标可解析、XML 可解析、媒体存在、页数和页序正确、必需文本完整。ZIP 可解压不等于演示应用能正确显示。
7. 视觉验收：通过用户环境中的 PowerPoint/LibreOffice 导出 PDF 或逐页图片，检查每页溢出、遮挡、字号、对齐、图片比例、字体替换和图表标签。调整后重新渲染受影响页面。没有渲染环境时只能报告结构验证结果，列出待验收项。
8. 交付：提供 .pptx、可用的预览和简短变更说明；报告已运行的检查、未检查的对象及环境版本。

指令

• 每张幻灯片只承载一个主要结论；标题应表达结论，正文只保留支持它的证据。
• 用原生文本、形状和图表表达可编辑内容，避免用整页截图冒充可编辑演示。
• 文本框尺寸、字号和段落间距以渲染结果为准。字符数估算不能替代逐页检查。
• 编辑图表、备注或 OOXML 时，保留未涉及的关系、命名空间、内容类型和包内文件。不要直接删除未知部件来消除错误。
• 图片、字体、模板和数据均使用用户提供或有明确授权的材料；把来源记在备注或交付说明中。
• 输出到新文件；校验失败保留工作副本与错误证据，不覆盖原始演示。

示例

用户给出 12 页模板，要求更新其中 3 页的数据：

1. 复制模板，记录 12 页的顺序、标题和目标形状。
2. 识别这 3 页的图表是否可由当前工具保真修改；无法保真时使用原应用。
3. 仅更新目标内容，复查所有页面的结构与目标数字。
4. 在演示应用中重新打开并导出预览；核对 3 页改动，同时检查未修改页面没有格式漂移。
5. 交付新文件，说明数据来源和验证结果。

注意事项

• python-pptx 写入文件不代表执行了 PowerPoint 的重算、字体布局或渲染；分别报告这些检查。
• 不引用本目录没有分发的脚本、模板或固定平台路径。
• 工具报错、文件损坏或高级对象不受支持时，停止该分支，保留输入并给出具体缺项；可以交付文案与布局规格，不能声称 .pptx 已完成。

互见

• related：python-pptx-deck-generator、markdown-to-docx、theme-factory。
• combines_with：python-pptx-deck-generator、board-deck-builder。