| 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、媒体或特殊母版结构，不得静默重建或丢弃。
完成条件
- 用读取脚本回读最终文件，确认页序、正文、表格和备注完整，并搜索残留占位文字。
- 用 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"
- 逐页检查标题换行、文字溢出、裁切、重叠、对齐、对比度、图表标签、页脚和图片清晰度。
- 缺少 LibreOffice 或 Poppler 时可以继续内容读取；写任务要说明未完成视觉检查。
- 最终只交付 PPTX，不附带构建脚本、提取文本和预览图片。
