PPTX 演示文稿技能
让 AI 助手直接创建、编辑和分析 PowerPoint（.pptx）文件，覆盖从零构建、套用模板到修改现有幻灯片的全流程。
证据显示：脚本全部本地运行，无网络请求、无凭据访问，XML 解析使用 defusedxml 防注入，unpack.py 输出到指定目录，pack.py 在临时目录工作并默认校验、失败时删除损坏文件，具备一定回滚与安全意识。扣分项：SKILL.md 前言声明 'Proprietary. LICENSE.txt has complete terms'，被再发布于 MiniMax 仓库，第三方许可条款未随证据提供，来源归属存疑；html2pptx 流程要求全局安装 playwright/sharp/pptxgenjs，权限与依赖面较宽但未说明理由。
证据显示：文档对关键路径（读取、无模板创建、OOXML 编辑、模板创建）给出完整工作流，validate.py/pack.py 有明确的校验与可读错误输出（如 shape 不存在、溢出量），html2pptx 声称集中收集校验错误。扣分项：声称 pptxgenjs/playwright/sharp '已全局安装'属隐藏环境假设；SKILL.md 末尾被截断（soffice 转换命令不完整）；thumbnail.py、rearrange.py、inventory.py、replace.py、html2pptx.js 等关键脚本未随证据提供，无法静态核验；无测试证据。
证据显示：description 明确列出创建/编辑/布局/批注/备注等触发场景，工作流按任务类型分支清晰，输入输出（.pptx、HTML、JSON 清单）定义具体。扣分项：对非适配场景（如无 Node 环境、无 soffice、中文 Web 字体受限——web-safe 字体列表不含中文字体，中文演示文稿可能渲染异常）未声明边界；核心依赖（playwright、soffice）在部分环境可达性差，文档未提示。
证据显示：文档分层良好（SKILL.md → html2pptx.md → ooxml.md → 脚本），示例丰富，参数与索引约定（0-based）一致。扣分项：许可证为 'Proprietary' 且 LICENSE.txt 未随附证据，再发布权利不明；无版本号、变更日志、维护责任与更新路径说明；SKILL.md 文件本身截断，信息架构不完整。
证据显示：该技能覆盖演示文稿读、建、改、模板套用全流程，产出为可直接打开的 .pptx，且设计指引（配色、版式、图表规范）具体，边际价值高于手写 OOXML。扣分项：静态审阅无法验证产出可用性；效果依赖多个外部依赖与多步代理执行，任一环节缺失即不可用；html2pptx.md 中技能描述与依赖（'已全局安装'）与实际部署条件可能不符。
证据显示：主材料（文档、脚本源码）可审计，脚本内部逻辑可静态核验。扣分项：无测试套件、无 CI 执行证据、无第三方执行佐证；多个被引用脚本不在证据内，关键路径不可独立复现；来源（疑似源自某专有技能库）无法交叉证实。
- 许可证声明为专有（Proprietary），仓库再发布的权利来源不明，企业使用前应核实 LICENSE.txt 与上游授权。
- SKILL.md 文件在 soffice 转换命令处被截断，说明文件不完整，实际仓库内容可能与此不一致。
- 依赖 pptxgenjs、playwright、sharp、soffice、markitdown 等多个外部组件，但文档假设其'已全局安装'，部署前需自行安装并验证。
- 推荐字体列表不含中文字体，中文演示文稿可能出现渲染或缺字问题。
- 无测试套件或 CI 证据，静态审阅未执行任何脚本，实际效果需用户自行验证。
这个 Skill 能做什么，适合哪些场景？
这是一个针对 PowerPoint 文件的 Agent 技能，捆绑在 MiniMax Mini-Agent 的技能集合（共 15 个技能）中，位于 mini_agent/skills/document-skills/pptx/。它为三类任务提供完整工作流：从头新建演示文稿（通过 html2pptx 将 HTML 转换为 PPTX）、套用现有模板生成演示文稿、以及直接编辑现有文件的 OOXML 内容。同时支持文本提取、缩略图网格生成、幻灯片转图片等分析能力。技能自带 unpack/pack/validate/rearrange/inventory/replace 等一系列 Python 脚本。注意：SKILL.md 声明其许可为专有（以 LICENSE.txt 为准），与仓库整体的 MIT 许可不同。
读取 .pptx 文件并用 markitdown 提取文本为 Markdown；用 unpack.py 解包为 OOXML 后直接读取/编辑 XML（幻灯片、备注、批注、版式、主题、媒体），支持 comments、speaker notes、animations、layout 操作；新建演示文稿时走 html2pptx 工作流：为每张幻灯片编写 HTML（720pt × 405pt 等），用 html2pptx.js 转换，通过 PptxGenJS 添加图表和表格，再用 thumbnail.py 生成缩略图做视觉校验并迭代修正；套用模板时用 thumbnail.py 分析版式、rearrange.py 复制/排序/删除幻灯片、inventory.py 提取文本形状清单、replace.py 写入替换文本（含项目符号、对齐、字体、颜色属性）并校验溢出；编辑现有文件时按 OOXML 工作流修改 XML 并用 validate.py 逐步校验，最后用 pack.py 重新打包；还可用 soffice 转 PDF、pdftoppm 转图片进行视觉分析。
- 需要机器可验证、精确定位的幻灯片的用户：从零生成产品汇报、课程讲义等新演示文稿，html2pptx 保证元素位置准确。
- 有企业模板的职场人士：把品牌模板交给技能分析，自动挑选合适版式并批量替换占位文本，产出符合模板设计的新 PPT。
- 拿到他人 PPT 需要小改的用户：直接解包编辑 OOXML，修改文字、备注、批注而不破坏原格式，每步有校验。
- 需要快速了解一份陌生 PPT 内容的人：用 markitdown 提取全部文本，或生成缩略图网格快速浏览整体设计。
- 需要提取演讲者备注、批注或分析动画/主题配色的用户：通过原始 XML 访问这些普通文本提取拿不到的内容。
这个 Skill 有哪些优点和局限？
- 覆盖 PPT 全生命周期：新建、套模板、编辑、分析四条工作流各有明确的分步指令和配套脚本
- 内置质量保障机制：每步 XML 编辑后有 validate.py 校验，生成后有 thumbnail.py 视觉检查并要求迭代修正，replace.py 能检测文本溢出
- html2pptx 工作流附带详细设计指导（配色、字体、版式、图表样式），产出质量有章可循
- replace.py 的清单/校验/自动清理机制降低了模板替换时引用不存在形状或破坏格式的风险
- 依赖面很重：需要 Python、Node.js 全局包、LibreOffice、Poppler 多套运行时，环境搭建成本高
- SKILL.md 自身许可为专有（以 LICENSE.txt 为准），与仓库 MIT 许可不一致，商用前需查看该许可文件
- SKILL.md 未提供针对单技能的独立安装说明；README 安装的是整个 Mini-Agent 项目并依赖 MiniMax 模型
- SKILL.md 中未包含该技能自身的测试证据；仓库测试针对 agent 核心，未表明覆盖 pptx 脚本
- 视觉校验依赖模型读取缩略图判断，且部分脚本行为（如字体可用性、playwright 渲染）依赖环境，失败模式文档着墨有限
如何安装这个 Skill？
本技能不单独安装，随 Mini-Agent 技能集合分发，路径为 mini_agent/skills/document-skills/pptx/。安装 Mini-Agent 有两种方式（来源：仓库 README）：快速模式 uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git，随后运行 setup-config 脚本并配置 MiniMax API Key；开发模式 git clone https://github.com/MiniMax-AI/Mini-Agent.git 后 uv sync，并执行 git submodule update --init --recursive 初始化技能（README 技能目录初始化标注为可选）。另需按 SKILL.md 依赖清单安装：Python 侧 markitdown[pptx]、defusedxml；Node 侧 pptxgenjs、playwright、sharp、react-icons（全局 npm 安装）；系统级 LibreOffice 和 Poppler。SKILL.md 称这些依赖“应已安装”，但在自建环境中需自行确认。若只想在其他支持 Agent Skills 的客户端使用该技能，源材料未提供独立的移植安装步骤。
如何使用这个 Skill？
技能由 SKILL.md 的 description 触发：当任务涉及创建、修改或分析 .pptx 文件时自动选用。典型用法：向运行 Mini-Agent 的代理发出请求，例如“根据这份大纲做一份 16:9 的产品介绍 PPT”（走 html2pptx 工作流）、“把 template.pptx 的设计套用到这些内容上”（走模板工作流）、“把第 3 页标题改成 X 并加一页备注”（走 OOXML 编辑工作流）。也可以在支持读取 SKILL.md 的客户端中手动按其流程调用各脚本，如 python scripts/thumbnail.py out.pptx、python ooxml/scripts/unpack.py file.pptx out_dir。SKILL.md 强制要求在开始前完整阅读 html2pptx.md 和 ooxml.md 参考文档，不可设读取范围限制。
这个 Skill 与同类方案有什么区别？
SKILL.md 引用了 Claude Skills 项目（anthropics/skills），本技能即属于该体系的 PPTX 技能，随 Mini-Agent 重新分发；仓库 README 同时演示了 PDF/DOCX 等兄弟技能，但那些能力不属于本技能。