PPTX 技能

快速参考

读取内容

# 文本提取python -m markitdown presentation.pptx# 视觉概览python scripts/thumbnail.py presentation.pptx# 原始 XMLpython scripts/office/unpack.py presentation.pptx unpacked/

编辑工作流

阅读 editing.md 获取完整详情。

1. 使用 thumbnail.py 分析模板
2. 解包 → 操作幻灯片 → 编辑内容 → 清理 → 打包

从零开始创建

阅读 pptxgenjs.md 获取完整详情。

当没有模板或参考演示文稿可用时使用。

设计理念

不要创建无聊的幻灯片。 白底黑字的普通项目符号不会给任何人留下深刻印象。为每张幻灯片考虑以下列表中的想法。

开始之前

• 选择大胆的、与内容相关的调色板
  ：调色板应该感觉是为这个主题设计的。如果你的颜色换到一个完全不同的演示文稿中仍然“可行”，说明你的选择不够具体。
• 主导色优于平等
  ：一种颜色应占主导地位（60-70% 的视觉权重），搭配 1-2 种辅助色调和一种鲜明的强调色。切勿让所有颜色权重相等。
• 明暗对比
  ：标题页和总结页用深色背景，内容页用浅色背景（“三明治”结构）。或者全程使用深色以获得高级感。
• 坚持一个视觉主题
  ：选择一个独特的元素并重复使用——圆角图片框、彩色圆圈中的图标、单侧粗边框。在每张幻灯片中贯穿使用。

调色板

选择与主题匹配的颜色——不要默认使用通用的蓝色。使用这些调色板作为灵感：

对于每张幻灯片

每张幻灯片都需要一个视觉元素——图片、图表、图标或形状。纯文本幻灯片容易被遗忘。

布局选项：

• 两栏式（文本在左，插图在右）
• 图标 + 文本行（图标在彩色圆圈内，粗体标题，下方描述）
• 2x2 或 2x3 网格（一侧是图片，另一侧是内容块网格）
• 半出血图片（左侧或右侧全出血）叠加内容

数据显示：

• 大型数据突出显示（大号数字 60-72pt，下方小标签）
• 对比栏（前后对比、优缺点、并排选项）
• 时间线或流程图（编号步骤、箭头）

视觉润色：

• 章节标题旁的小彩色圆圈中的图标
• 关键数据或标语使用斜体强调文本

排版

选择有趣的字体组合——不要默认使用 Arial。选择有个性的标题字体，并搭配简洁的正文字体。

间距

• 最小 0.5 英寸边距
• 内容块之间 0.3-0.5 英寸
• 留出呼吸空间——不要填满每一寸

避免（常见错误）

• 不要重复相同的布局
  ——在幻灯片之间变换栏、卡片和突出显示
• 不要居中对齐正文文本
  ——段落和列表左对齐；仅标题居中
• 不要吝啬大小对比
  ——标题需要 36pt 以上才能与 14-16pt 的正文区分开
• 不要默认使用蓝色
  ——选择反映特定主题的颜色
• 不要随机混合间距
  ——选择 0.3 英寸或 0.5 英寸的间隙并保持一致
• 不要只设计一张幻灯片而让其余部分保持朴素
  ——要么完全投入，要么全程保持简洁
• 不要创建纯文本幻灯片
  ——添加图片、图标、图表或视觉元素；避免纯标题 + 项目符号
• 不要忘记文本框内边距
  ——当将线条或形状与文本边缘对齐时，在文本框上设置 margin: 0 或偏移形状以考虑内边距
• 不要使用低对比度元素
  ——图标和文本都需要与背景形成强烈对比；避免浅色背景上的浅色文字或深色背景上的深色文字
• 切勿在标题下使用强调线
  ——这是 AI 生成幻灯片的标志；改用空白或背景色

质量保证（必需）

假设存在问题。你的工作是找出它们。

你的第一次渲染几乎从来都不正确。将质量保证视为错误排查，而不是确认步骤。如果你在第一次检查中没有发现任何问题，说明你检查得不够仔细。

内容质量保证

python -m markitdown output.pptx

检查缺失的内容、拼写错误、顺序错误。

使用模板时，检查残留的占位符文本：

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

如果 grep 返回结果，请在宣布成功之前修复它们。

视觉质量保证

使用子代理——即使是 2-3 张幻灯片。你一直盯着代码，会看到你期望看到的，而不是实际存在的。子代理有全新的视角。

将幻灯片转换为图片（参见转换为图片），然后使用此提示：

视觉检查这些幻灯片。假设存在问题——找出它们。检查：- 重叠元素（文字穿过形状、线条穿过单词、堆叠的元素）- 文本溢出或在边缘/框边界处被截断- 为单行文本定位但标题换行到两行的装饰线- 来源引用或页脚与上方内容冲突- 元素距离太近（< 0.3 英寸间隙）或卡片/部分几乎接触- 不均匀的间隙（一处大面积空白，另一处拥挤）- 距离幻灯片边缘的边距不足（< 0.5 英寸）- 栏或相似元素未保持一致对齐- 低对比度文本（例如，奶油色背景上的浅灰色文字）- 低对比度图标（例如，深色背景上的深色图标，没有对比色圆圈）- 文本框太窄导致过度换行- 残留的占位符内容对于每张幻灯片，列出问题或关注区域，即使是次要的。读取并分析这些图片：1. /path/to/slide-01.jpg (预期：[简要描述])2. /path/to/slide-02.jpg (预期：[简要描述])报告发现的所有问题，包括次要问题。

验证循环

1. 生成幻灯片 → 转换为图片 → 检查
2. 列出发现的问题
   （如果未发现问题，则更严格地再次检查）
3. 修复问题
4. 重新验证受影响的幻灯片
   ——一个修复常常会引发另一个问题
5. 重复直到完整检查未发现新问题

在完成至少一个修复-验证循环之前，不要宣布成功。

转换为图片

将演示文稿转换为单独的幻灯片图片以进行视觉检查：

python scripts/office/soffice.py --headless --convert-to pdf output.pptxpdftoppm -jpeg -r 150 output.pdf slide

这将创建 slide-01.jpg、slide-02.jpg 等。

修复后重新渲染特定幻灯片：

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

依赖项

• pip install "markitdown[pptx]"
•  - 文本提取
• pip install Pillow
•  - 缩略图网格
• npm install -g pptxgenjs
•  - 从零开始创建
• LibreOffice (soffice) - PDF 转换（通过 scripts/office/soffice.py 为沙盒环境自动配置）
• Poppler (pdftoppm) - PDF 转图片

安装命令

npx skills add https://github.com/anthropics/skills --skill pptx

每周安装量

43.8K

仓库

https://github.com/anthropics/skills

GitHub 星标

101.0K

首次出现

2026年1月20日

安全审计

Gen Agent Trust HubPass SocketPass SnykPass

安装于

opencode35.7K

gemini-cli34.2K

codex34.1K

github-copilot31.9K

cursor31.3K

amp29.5K