适用场景

当主要交付物为 Microsoft PowerPoint 演示文稿或 .pptx 文件时使用，尤其适用于对版式、模板、占位符、备注、批注、图表、内容提取、编辑操作或最终视觉质量有较高要求的场景。

核心规则

1. 在操作演示文稿前先选定工作流

• 纯文本读取、现有演示文稿编辑、基于模板重建、从零创建——这些是性质不同的任务，各自具有不同的失败模式。
• 如需进行文本提取或内容检查，请先读取演示文稿，再进行编辑。
• 文本提取 + 缩略图式视觉检查，比仅依赖形状假设进行编辑更安全。
• 若采用模板驱动方式工作，应在替换内容前完成对演示文稿的全面清点（inventory）。
• 深度编辑时请牢记：.pptx 文件本质是 OOXML 格式，其内部结构将幻灯片、版式、母版、媒体、备注和批注分别存储于不同部件中。
• 若存在模板，应优先保证模板保真度（template fidelity），而非依赖通用幻灯片设计直觉。
• 复用或复制一个已验证良好的幻灯片，通常比重新构建并寄希望于主题仍能匹配更稳妥。

2. 替换内容前先清点演示文稿

• 首先统计可复用的版式数量、真实占位符数量、备注与批注数量、媒体资源，以及重复出现的字体或配色规律。
• 占位符索引（placeholder indexes）与版式索引（layout indexes）不具备跨模板可移植性，不可作为通用假设。
• 在定位标题、正文、图表或图片形状前，务必实际检查目标幻灯片或模板本身。
• 演讲者备注、批注及关联资源可能存在于可见幻灯片区域之外。
• 缺失或错误的占位符目标可能导致内容被静默地置入错误位置或错误图层。
• 母版与版式设置可能覆盖幻灯片本地编辑结果，因此所见问题未必发生在当前正在编辑的幻灯片上。

3. 将内容精准匹配至实际占位符

• 选择版式前，先统计实际需呈现的内容单元数量。
• 应根据幻灯片真正所需的“观点数”、“列数”、“图片数”或“图表数”来选取版式。
• 勿强行将两个观点塞入三栏版式，也勿将大段密集文本硬压在图表下方。
• 分类项数量（category counts）与数据序列长度（data series lengths）必须严格匹配，否则图表将以明显异常方式崩溃。
• 明确的空间分配优于主观臆测：“文本框、图片与图表需要真实可用空间”，而非“它应该能放下”。
• 切勿选用占位符数量远超内容可有意义填充量的版式。
• 引用型版式（quote layouts）专用于真实引述；图片主导型版式（image-led layouts）仅适用于确实含图片的幻灯片。
• 对于图表、表格或图片密集型幻灯片，全屏布局（full-slide）或双栏布局（two-column）通常比在视觉元素上方堆叠密集文本更稳妥。

4. 保持演示文稿的视觉语言一致性

• 主题（theme）、母版（master）与版式（layout）文件，通常比单张幻灯片更能决定字体、颜色与层级结构。
• 应从演示文稿实际采用的主题、字体、间距与宽高比出发，而非即兴创建全新风格。
• 应复用演示文稿自身既有的对齐与间距体系，避免额外引入第二套视觉语言。
• 为保障兼容性与可读性，宜选用常见字体，并确保强对比度。
• 应优先维护模板固有的视觉逻辑；相较于原创性，“不破坏既有视觉语言”更为关键。
• 合并多个来源的幻灯片后，须统一归一化主题、母版与对齐方式。

5. 分别执行内容质量检查（Content QA）与视觉质量检查（Visual QA）

• 文本溢出、对齐错乱、图形裁切、对比度不足、残留占位符等，均属首轮检查中的典型失败现象。
• 必须同时运行内容 QA 与视觉 QA；文本缺失与布局崩坏属于不同类别的失败。
• 当版式至关重要时，应在交付前渲染或实际检查最终输出的演示文稿。
• 在宣布演示文稿完成前，务必搜索并清除残留模板垃圾（template junk）、示例标签（sample labels）及占位符文本（placeholder text）。
• 备注、批注、标签、图例及图表/表格语义需在视觉检查之外单独核查。
• 一份演示文稿可能通过文本提取测试，却因重叠（overlap）、裁切（clipping）、错误的主题继承（theme inheritance）或损坏的备注而视觉失败。
• 缩略图网格（thumbnail grids）与渲染后的幻灯片，通常比代码或纯文本检查更快暴露布局缺陷。
• 应默认首次渲染结果存在错误，并至少执行一轮“修复-验证”（fix-and-verify）循环后再标记为完成。
• 每次修复后均需重新检查受影响幻灯片，因为一处间距调整常引发另一处问题。

6. 确保演示文稿具备可移植性与审阅安全性

• 母版（template masters）可能以难以预料的方式覆盖直接编辑结果。
• 复杂视觉效果在 PowerPoint、LibreOffice 及各类转换流水线中易发生降级，因此关键内容应不依赖此类效果，保持鲁棒性。
• 图片尺寸、字体替换与占位符错配，是导致演示文稿“代码中表现良好、屏幕上显示异常”的常见原因。
• 即使可见幻灯片外观正常，备注、批注、关联媒体及合并后的演示文稿仍可能处于损坏状态。

常见陷阱

• 占位符文本与示例图表若未被显式替换，常在模板复用后意外残留。
• 若根本问题位于母版或版式中，仅编辑单张幻灯片将无法解决问题。
• 图表、图标与文本框均需充足空间；接近碰撞（near-collisions）通常仅在渲染后才显现。
• 版式索引（layout indexes）随模板而异，因此一套演示文稿中的内置假设在另一套中极易失效。
• 缺失占位符或错误的形状目标，可能导致内容被静默地置于错误位置。
• 先选版式再统计观点数，往往导致空占位符、层级薄弱或残留模板垃圾。
• 字体替换可能移动换行位置，从而破坏精心设计的间距。
• 即使可见幻灯片外观正常，演讲者备注、批注与关联媒体仍可能持续损坏。
• 一份演示文稿可能通过文本检查，却因重叠、对比度不足或边缘裁切而在视觉上失败。
• 仅凭单张幻灯片编辑，可能遗漏主题、母版或版式定义中真正的“事实来源（source of truth）”。
• 在无匹配内容支撑的情况下选用引用型、对比型或多栏型版式，通常使演示文稿显得模板化，而非刻意设计。
• 合并或复制幻灯片时若未同步检查母版与主题，可能逐页累积细微不一致。
• 宽高比不匹配（例如 16:9 与 4:3 混用）会系统性偏移所有位置决策，即使每张幻灯片局部看来合理。

相关技能

若用户确认，则通过 clawhub install 安装：

• documents —— 常为演示文稿提供内容输入的文档工作流。
• design —— 视觉方向与版式决策。
• brief —— 面向幻灯片叙事的精炼商业信息表达。

反馈

• 如觉有用：clawhub star powerpoint-pptx
• 保持更新：clawhub sync