Anthropic PPTX 技能深度解析（一）
Lv.2潜力创作者
Anthropic PPTX 技能为演示文稿制作提供了两种生成路径：模板编辑工作流与从零创建工作流。两条路径共享同一套设计原则与质量保障体系。
一、模板编辑工作流
模板编辑路径设计为六阶段操作流程，适用于以现有 PPTX 文件为设计模板进行内容替换的场景，可完整保留原始模板的主题色彩体系、幻灯片母版与版式资源链，确保输出文件在视觉风格上与原始模板高度一致，无需从零搭建视觉框架。
第一阶段，使用 thumbnail.py 分析模板文件，生成缩略图网格用于视觉布局审阅。该脚本默认以 3 列排列，每网格最多容纳 12 张幻灯片，画面标注各幻灯片文件名以便快速定位。同时通过 python -m markitdown template.pptx 提取全文本以识别所有占位内容，并为每个内容区块匹配合适的布局版式。规范要求主动避免重复使用单一文字密集型版式——应充分挖掘两栏布局、多栏网格、半出血图片、大号数字标注、图标加文本行等多样化方案，确保演示文稿的视觉节奏富有变化，而非在所有幻灯片上重复同一版式。
第二阶段，运行 unpack.py 将 PPTX 解包为 XML 文件树。PPTX 文件本质为 ZIP 压缩包，unpack 脚本在解压基础上完成 XML 的 pretty-print 格式化与智能引号转义——将机器可读的直引号转换为人工可读的 Unicode 弯引号（左双引号 U+201C、右双引号 U+201D、左单引号 U+2018、右单引号 U+2019），确保后续人工审阅 XML 时的可读性与编码正确性。
第三阶段，运行 add_slide.py 复制现有幻灯片或从布局创建新幻灯片。该脚本自动处理备注引用、Content_Types.xml 和关系 ID 等手工操作极易出错的环节，输出 <p:sldId> 元素供插入到幻灯片顺序列表 <p:sldIdLst> 的指定位置。技能文档明确禁止手动复制幻灯片文件——任何遗漏的内部引用均导致文件损坏或渲染异常，add_slide.py 正是为解决此问题而设计的专用工具。该脚本还支持直接从 slideLayout 创建新幻灯片，适用于需要在模板基础上扩展新版式的场景。
第四阶段是内容编辑的核心环节。在 slide{N}.xml 中完成所有占位内容的替换，涵盖文本段落、内嵌图片、数据图表、图标样式与标注文案。此环节可委托子代理并行编辑多张幻灯片文件——每张幻灯片的 XML 文件相互独立，具备天然的并行编辑条件。子代理在接收到包含文件路径与格式化规则的任务描述后，即可独立完成对应幻灯片的 XML 替换工作。XML 编辑须遵守三项格式化约束：所有标题、副标题和内联标签须使用 b="1" 属性强制加粗；禁止使用 Unicode 项目符号（·），须采用 <a:buChar> 或 <a:buAutoNum> 实现列表格式化，且列表样式优先从版式继承而非在每张幻灯片中重复指定；当来源内容条目数少于模板预留槽位时，须将多余槽位的完整元素组（包括图片、形状、文本框）一并删除而非仅清空文本内容，避免出现孤立图片或空文本框残留。替换内容中的引号须使用 XML 实体编码：左双引号为 “，右双引号为 ”。
第五阶段，运行 clean.py 移除未在幻灯片顺序列表注册的幻灯片文件、未引用媒体资源与孤立关系描述文档。第六阶段，运行 pack.py 重新打包为经过验证的有效 PPTX 文件，该脚本自动完成 XML 格式验证、文件结构修复、XML 标签压缩与智能引号重编码。打包时须传入原始模板文件作为 --original 参数，以确保主题色彩、字体配置与母版版式等资源完整继承。最终输出的 PPTX 文件在 WPS Office 或 Microsoft PowerPoint 中打开时，视觉呈现与原始模板高度一致。六阶段流程结束后，建议对输出文件执行一次快速的 markitdown 验证以确认内容完整性，再进入视觉 QA 环节。
二、设计原则体系
2.1 色彩设计框架
技能内置 10 组经工业验证的主题调色板，每组由三种角色构成：主色占视觉比重的 60%-70%，辅助色（一至两种支持色调）与强调色（高对比度点缀色）各司其职，禁止等权使用多个色彩导致视觉重心分散。调色板完整清单如下：Midnight Executive（海军蓝 1E2761、冰蓝 CADCFC、白 FFFFFF）；Forest Moss（森林绿 2C5F2D、苔藓绿 97BC62、奶油色 F5F5F5）；Coral Energy（珊瑚红 F96167、金色 F9E795、海军蓝 2F3C7E）；Warm Terracotta（陶土红 B85042、沙色 E7E8D1、鼠尾绿 A7BEAE）；Ocean Gradient（深蓝 065A82、青色 1C7293、午夜蓝 21295C）；Charcoal Minimal（炭灰 36454F、米白 F2F2F2、纯黑 212121）；Teal Trust（青绿 028090、海沫 00A896、薄荷 02C39A）；Berry Cream（浆果红 6D2E46、灰玫瑰 A26769、奶油色 ECE2D0）；Sage Calm（鼠尾绿 84B59F、桉树绿 69A297、灰蓝 50808E）；Cherry Bold（樱桃红 990011、米白 FCF6F5、海军蓝 2F3C7E）。每组色值以六位十六进制格式给出，不含井号前缀。
暗亮对比结构采用"三明治"布局：暗色背景用于标题页与总结页，亮色背景用于内容页；亦可通篇使用暗色背景以获得高端质感。色彩选择须与主题内容深度关联——若将所选调色板套用到另一无关主题后依然"适用"，说明色彩设计未达到针对性要求。实践中建议在正式定稿前将选定的调色板在至少三张不同版式的幻灯片上渲染预览，以验证色彩在不同布局条件下的表现一致性。
2.2 字体排印规范
技能提供 8 组标题-正文字体配对方案：Georgia/Calibri、Arial Black/Arial、Calibri/Calibri Light、Cambria/Calibri、Trebuchet MS/Calibri、Impact/Arial、Palatino/Garamond、Consolas/Calibri。标题字体应选具有鲜明个性的字体，正文字体则以清晰易读为优先标准。字号规范严格分级：幻灯片标题 36-44pt 粗体、段落标题 20-24pt 粗体、正文 14-16pt、标注文字 10-12pt 柔和色调。字体选择不宜过多，一套演示文稿中建议不超过两种字体族——一种用于标题层级，一种用于正文层级。
2.3 布局范式
每张幻灯片必须包含至少一个视觉元素——图片、图表、图标或形状——纯文字型幻灯片被归类为不可接受的产出。可用布局类型包括：两栏图文布局（左侧文字、右侧插图）；图标加文本行布局（图标置于彩色圆形衬底内，配粗体标题与描述文本）；2x2 或 2x3 信息网格布局（一侧配置大图，另一侧排列矩阵式内容区块）；半出血图片布局（图片占满横轴半侧，内容文字叠加其上）。数据显示类幻灯片采用三种呈现形态：大号数字标注（60-72pt 数值配合下方小号标签）、对比列（前后对比或方案优劣对比）、时间线或流程步骤。规范要求全演示文稿的布局类型须保持变化，正文段落内容禁止居中对齐。
2.4 视觉动机与间距
规范强调为每个演示文稿选择一个标志性视觉元素并在全部幻灯片中持续复用，可选元素包括圆角图片框、图标加彩色圆形衬底、单侧粗边框等。该元素须贯穿演示文稿始终以形成统一的视觉语言体系。间距规范要求：最小边缘留白 0.5 英寸、内容块间距 0.3-0.5 英寸、避免填满每一寸可用空间。间距值须在全演示文稿中保持一致，不得在不同位置随机混用不同间距。
2.5 反模式清单
技能明确列出以下禁止的设计模式：在标题下方使用装饰性线条——此项被标注为 AI 生成幻灯片的标志性特征，应使用留白或背景色替代；使用低对比度元素导致阅读困难；随机混合间距数值；为长文本选择过窄文本框导致不必要的过度换行；为单一系列数据显示本不必要的图例；仅完成首张幻灯片样式后即告知系统其余幻灯片保持原样不做处理。此外，同一演示文稿内不应将部分幻灯片精细设计而其余保持默认样式，视觉一致性是专业演示文稿的基本要求。
三、Python 脚本工具链与依赖管理
3.1 脚本工具链详解
技能附带五个 Python 脚本，分别服务于模板编辑工作流的各关键阶段。thumbnail.py 位于 scripts/ 根目录，生成缩略图网格供版式分析——默认 3 列排列，每网格最多展示 12 张幻灯片，画面标注幻灯片文件名。unpack.py 位于 scripts/office/unpack.py，完成 PPTX 解包与 XML 预处理，使用 defusedxml.minidom 解析引擎而非 xml.etree.ElementTree，避免命名空间污染导致的 XML 结构异常。add_slide.py 位于 scripts/add_slide.py，复制幻灯片或从布局创建新幻灯片，自动处理关系 ID 分配、备注引用与内容类型注册表更新。clean.py 位于 scripts/clean.py，清理所有孤立资源——移除未在幻灯片顺序列表中注册的幻灯片文件、未引用的媒体文件与孤立的关系描述文档。pack.py 位于 scripts/office/pack.py，将编辑后的文件树重新打包为 validated PPTX 格式，自动完成 XML 格式验证、文件结构修复与智能引号重编码。
3.2 运行依赖链
模板编辑路径依赖两层工具链。Python 层包含 markitdown[pptx] 用于 PPTX 文本提取与分析，以及 Pillow 用于缩略图生成。系统工具层包含 LibreOffice 的 soffice 命令行引擎用于 PPTX 至 PDF 转换，以及 Poppler 套件中的 pdftoppm 工具用于 PDF 至 JPEG 图像渲染，默认 150 DPI 分辨率，渲染结果用于视觉 QA 环节的幻灯片逐张检查。建议在首次运行前确认 soffice 与 pdftoppm 已正确安装并可通过命令行直接调用，避免在生成流程中因系统工具缺失而中断。
四、质量保障机制
4.1 内容完整性检查
内容 QA 通过 markitdown 完成两阶段检查。首阶段提取幻灯片全文本内容，逐张核实文字序列、拼写正确性与条目顺序；次阶段针对模板编辑场景以 grep -iE "xxxx|lorem|ipsum" 扫描所有提取文本，检查是否残存未替换的占位符内容。若 grep 返回任何匹配结果，须在声明完成前修正并重新验证。
4.2 视觉检查机制
视觉 QA 采用子代理机制以规避编码者的"视觉盲区"——编写者在审视自身产出时倾向于看到预期内容而非实际渲染结果，因此委派独立子代理以全新视角检查渲染图像。子代理在读取每张幻灯片的 XML 文件后，同步获取 soffice 加 pdftoppm 管线生成的 JPEG 图像，逐项核对 12 个检查维度：元素重叠（文字穿透图形、线条穿过文字、堆叠元素位置冲突）、文本溢出或截断、装饰线与多行标题位置冲突、来源引用或页脚注释与正文内容碰撞、元素间距不足导致卡片接近触碰、局部区域内不均匀留白、幻灯片边缘留白不足、并列元素对齐不一致、低对比度文字或图标、过窄文本框导致的额外换行、残留占位符内容。每个维度的问题均记录到结构化清单中，注明所在幻灯片编号与具体位置坐标，供后续修复时精准定位。
4.3 验证循环迭代
验证循环要求至少完成一轮"生成-检查-修复-再验证"的完整迭代方可声明成功。修复动作完成后须对受影响幻灯片重新渲染并执行再次检查——单次修复往往引入新的合成问题，例如调整文本框高度可能导致与相邻元素位置重叠。技能前置假定首批渲染结果存在缺陷，视觉 QA 的定位是 Bug 排查而非符合性确认。若首轮检查未发现任何问题，部署策略要求以更严格标准重新审视每张幻灯片。迭代循环持续直至全部幻灯片无新增问题出现。
