# PPTX

> Create, read, edit, render or validate .pptx files, including templates, layouts, notes and comments. Use when a presentation file is an input or deliverable, not for discussion of a talk without file work.

- Skill: `kangwang42/pptx` (Agent Skill, multi-file: 34 files)
- Install (CLI): `npx skillmds@latest add kangwang42/pptx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kangwang42/pptx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Proprietary. LICENSE.txt has complete terms
- Author: kangwang42 (https://skillmd.com/u/kangwang42)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kangwang42/pptx

---


# PPTX 文件处理

先完成 `academic-ppt`、`sysu-ppt` 或其它适用内容流程，再在确有 PPTX 输入或交付物时使用本 skill。

## 模板来源分流

新建或大幅重建前，确认模板来源：中大官方模板、其他学校/机构或特定汇报类型、用户提供的模板，还是无模板的中性设计。已有 PPTX 的读取和局部修改不重复询问；多个合理当前模板且无法判断时才询问。

| 来源 | 内容与文件路径 |
| --- | --- |
| 中大官方模板 | 加载 `sysu-ppt`，使用其已确认模板和工具，再由本 skill 做文件检查 |
| 其它机构/汇报类型 | 学术内容 load `academic-ppt` as the content workflow，沿用项目或用户确认的 PPTX |
| 用户模板 | 以该文件为权威，保留母版、版式、主题、品牌和固定组件 |
| 无模板 | 学术内容加载 `academic-ppt`；确认中性设计后读取 `design-reference.md` 和 `pptxgenjs.md` |

模板派生的全新或大幅重建文件必须先检查模板，再编辑内容；完成后确认模板仍可见、版式关系和品牌资源未丢失、没有占位文字。
使用模板编辑工作流（Use the template-editing workflow, not the from-scratch workflow），不把模板任务改走从零生成工作流。

## 范围、工具和版本

- Q 只读取所需文字、页面属性或包部件，不创建文件。
- L 锁定唯一输入、目标页面/对象、允许改动的包部件和保护范围；只检查目标、范围外差异、直接受影响的共享版式/主题、备注/媒体及改动页面的显示。L bounded edit does not trigger template remapping、整套页面重排或完整渲染。
- P 创建、重组或改变页面顺序、母版、版式、主题、字体、共享资源或多个页面；检查所有受影响页面和共享对象。
- R 用户明确投稿、外发、归档或正式质控时，执行完整演示内容与视觉检查。

文本提取可用 `python -m markitdown presentation.pptx`，缩略图可用 `python scripts/thumbnail.py presentation.pptx`，原始包编辑使用 `scripts/office/unpack.py`、`pack.py`、`validate.py`。这些脚本只处理 `.pptx`，输出默认不覆盖，失败不替换原文件。不要自行安装或升级运行时（do not install or upgrade it）；If any item is unavailable, explain the affected operation and state the未验证范围。

正式项目只保留一个稳定当前文件，旧版按项目规则归档；轻量任务保留输入并只写指定输出。

## 新建和重建

先确定内容结构，再读取 [中性设计参考](design-reference.md)（read [neutral design reference](design-reference.md) completely）；需要从零生成时再读取 [PptxGenJS 参考](pptxgenjs.md)。视觉系统由内容、读者、模板和显示条件决定；图、表、流程、图标或形状只有在实质改善理解时才使用，纯文字页可以是正确选择。

## 质量检查

### 内容检查

用 `markitdown` 提取输出文字，检查内容完整、顺序、术语、数字和题注；模板任务检查占位文字（`xxxx`、`lorem` 等）不存在。内容检查由内容 skill 决定科学含义，文件 skill 不重新决定统计方法或结论。

### 视觉检查

只在本次修改可能影响页面显示、任务为新建/重建或属于 R 时渲染。检查重叠、裁切、溢出、边距、对齐、对比度、题注/来源碰撞和占位内容；只报告实际观察到的问题。独立视觉检查不是所有 L 任务的前置条件；It is not a prerequisite for a bounded edit。没有可用渲染器时，完成适用的包结构与文字检查，并明确 visual QA remains incomplete，不把结构检查称为视觉验收。

### 验证循环

新建或重建：生成 → 按需要渲染 → 记录真实问题 → 修正 → 只重渲染受影响页面。首次检查没有问题是有效证据，不为通过流程而作无必要修改（without making a gratuitous edit）。L 只重渲染改动页面及实际使用已改变共享对象的页面；R 才做完整演示 QA。

## 依赖边界

使用环境中已经存在的 `markitdown[pptx]`、Pillow、PptxGenJS、Microsoft PowerPoint、LibreOffice 或 Poppler。优先使用已安装的 Microsoft PowerPoint（prefer Microsoft PowerPoint）；LibreOffice (`soffice`) is an optional renderer only when already available。缺少依赖时说明影响和用户可选准备方式，不静默安装。