pptx

name	pptx
description	只要 PowerPoint 演示文稿或模板（.pptx、.potx、旧版 .ppt）是任务的输入或输出，或者需要 被打开、读取、创建、修改，就使用本 Skill。用户提到幻灯片、deck、演示文稿或 PowerPoint 文件时也应触发，包括内容提取、模板套用、页面增删、图表、图片和演讲者备注。
metadata	{"title":"PowerPoint 演示文稿","version":"2.0.0","category_key":"content-docs","category_name":"内容与文档","recommendation":"适合读取、创建和编辑 PowerPoint，并延续模板、母版与页面结构。","tags":["powerpoint","pptx","presentation-reading","presentation-creation","presentation-editing"]}

PowerPoint 演示文稿

任务	路径
读取、总结、问答	运行自带读取脚本；视觉信息再看逐页预览
新建演示文稿	用 python-pptx 生成可编辑 PPTX
编辑现有演示文稿或套模板	先检查全部页面和模板结构，再局部修改
复杂母版、动画、SmartArt、媒体	优先保留现有 OOXML；只做已验证的定点修改
旧版 .ppt	用 LibreOffice 转为 .pptx，保留原件

工作契约

• 只读问题不重新保存或导出演示文稿。
• 写操作默认另存新文件，不覆盖源稿或模板。
• 用户提供的模板是视觉和结构权威；不要擅自换母版、主题、字体或配色。
• 先直接使用当前环境。import pptx 失败且任务需要写文件时，取得用户同意后在隔离环境安装 ${CLAUDE_SKILL_DIR}/requirements.txt，不要静默修改系统 Python。

读取

python3 "${CLAUDE_SKILL_DIR}/scripts/read_presentation.py" "<input.pptx>"
python3 "${CLAUDE_SKILL_DIR}/scripts/read_presentation.py" "<input.pptx>" --output "<new-output.md>"

脚本按演示顺序提取正文、表格和演讲者备注。图表、图片、SmartArt、构图和只含图片的页面仍要 查看渲染结果；未提取到文字不等于页面为空。

创建与编辑

在 workspace 或临时目录写一个可重复运行的短 Python 脚本，再用 python-pptx 输出文件。

• 新建前确定受众、场景和主结论；信息足够时自行选择页数和叙事，不为装饰性偏好阻塞任务。
• 有模板时复用其母版、版式和占位符；编辑局部元素，不在每页重造共同结构。
• 每页表达一个清晰结论。内容过多时先精简或换布局，不靠缩小字号硬塞。
• 编辑现有文本时修改目标 run；给 text_frame.text 整体赋值会清除段落和字符格式。
• 图表尽量保持 PowerPoint 原生可编辑；图片保持纵横比并检查裁切，详细说明放演讲者备注。
• python-pptx 不能安全保留的动画、SmartArt、媒体或特殊母版结构，不得静默重建或丢弃。

完成条件

1. 用读取脚本回读最终文件，确认页序、正文、表格和备注完整，并搜索残留占位文字。
2. 用 LibreOffice 转成 PDF，再用 pdftoppm 渲染全部页面：

soffice --headless --convert-to pdf --outdir "<empty-qa-dir>" "<output.pptx>"
pdftoppm -png -r 144 "<empty-qa-dir>/<output.pdf>" "<empty-qa-dir>/slide"

3. 逐页检查标题换行、文字溢出、裁切、重叠、对齐、对比度、图表标签、页脚和图片清晰度。
4. 缺少 LibreOffice 或 Poppler 时可以继续内容读取；写任务要说明未完成视觉检查。
5. 最终只交付 PPTX，不附带构建脚本、提取文本和预览图片。