{/* 本页面由 website/scripts/generate-skill-docs.py 从技能 SKILL.md 自动生成。请编辑源 SKILL.md 而非本页面。 */}

Powerpoint

创建、读取、编辑 .pptx 演示文稿、幻灯片、备注、模板。

技能元数据

来源内置(默认安装)
路径skills/productivity/powerpoint
许可证Proprietary。LICENSE.txt 包含完整条款
平台linux, macos, windows

参考:完整 SKILL.md

:::info 以下是此技能被触发时 Hermes 加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

Powerpoint 技能

使用时机

只要涉及 .pptx 文件(作为输入、输出或两者兼有),就使用此技能。这包括:创建幻灯片组、推介 deck 或演示文稿;读取、解析或从任何 .pptx 文件提取文本(即使提取的内容将在其他地方使用,如邮件或摘要);编辑、修改或更新现有演示文稿;组合或拆分幻灯片文件;使用模板、布局、演讲者备注或评论。当用户提及”deck”、“幻灯片”、“演示文稿”或引用 .pptx 文件名时触发,无论他们之后如何处理内容。如果需要打开、创建或接触 .pptx 文件,请使用此技能。

快速参考

任务指南
读取/分析内容python -m markitdown presentation.pptx
编辑或从模板创建阅读 editing.md
从头创建阅读 pptxgenjs.md

读取内容

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

编辑工作流程

阅读 editing.md 了解完整详情。

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

从头创建

阅读 pptxgenjs.md 了解完整详情。

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


设计思路

不要创建无聊的幻灯片。 白色背景上的纯项目符号不会给任何人留下印象。考虑每张幻灯片使用此列表中的思路。

开始之前

  • 选择大胆的、内容相关的配色方案:配色方案应感觉是为主题设计的。如果你的颜色换到完全不同的演示文稿中看起来仍然”可行”,那说明你的选择还不够具体。
  • 主次分明:一种颜色应占主导(60-70% 视觉权重),配以 1-2 种辅助色调和一种锐利强调色。切勿让所有颜色权重相等。
  • 深色/浅色对比:标题和结束幻灯片使用深色背景,内容使用浅色背景(“三明治”结构)。或者全程使用深色以获得高级感。
  • 确定视觉主题:选择一个独特的元素并重复使用——圆角图片框、彩色圆圈中的图标、粗体单侧边框。在每张幻灯片上保持一致。

配色方案

选择与主题相匹配的颜色——不要默认使用通用的蓝色。将这些配色方案作为灵感:

主题主色辅色强调色
午夜行政1E2761(深蓝)CADCFC(冰蓝)FFFFFF(白色)
森林与苔藓2C5F2D(森林绿)97BC62(苔藓绿)F5F5F5(奶油色)
珊瑚能量F96167(珊瑚红)F9E795(金色)2F3C7E(深蓝)
暖赤陶B85042(赤陶)E7E8D1(沙色)A7BEAE(鼠尾绿)
海洋渐变065A82(深蓝)1C7293(青蓝)21295C(午夜蓝)
炭灰极简36454F(炭灰)F2F2F2(米白)212121(黑色)
青色信任028090(青色)00A896(海沫绿)02C39A(薄荷)
莓果与奶油6D2E46(莓果)A26769(灰玫瑰)ECE2D0(奶油色)
鼠尾草宁静84B59F(鼠尾草)69A297(桉树)50808E(石板)
樱桃大胆990011(樱桃红)FCF6F5(米白)2F3C7E(深蓝)

每张幻灯片

每张幻灯片都需要一个视觉元素——图片、图表、图标或形状。纯文本幻灯片令人难忘。

布局选项:

  • 双栏(文字在左,插图在右)
  • 图标 + 文字行(彩色圆圈中的图标,粗体标题,下方描述)
  • 2x2 或 2x3 网格(一侧图片,另一侧内容块网格)
  • 半出血图片(整左或右侧)带内容叠加

数据显示:

  • 大数字标注(60-72pt 大数字,下方小标签)
  • 比较列(之前/之后、优点/缺点、并排选项)
  • 时间线或流程(编号步骤、箭头)

视觉润色:

  • 部分标题旁的小彩色圆圈中的图标
  • 关键统计信息或标语的斜体强调文本

字体

选择一个有趣的字体搭配——不要默认使用 Arial。选择一个有个性的标题字体,配以干净的正文字体。

标题字体正文字体
GeorgiaCalibri
Arial BlackArial
CalibriCalibri Light
CambriaCalibri
Trebuchet MSCalibri
ImpactArial
PalatinoGaramond
ConsolasCalibri
元素字号
幻灯片标题36-44pt 粗体
部分标题20-24pt 粗体
正文14-16pt
说明文字10-12pt 柔和

间距

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

避免(常见错误)

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

质量检查(必需)

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

你的首次渲染几乎从不正确。将 QA 视为除虫(bug hunt),而非确认步骤。如果首次检查发现零问题,说明你检查得不够仔细。

内容质量检查

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.pptx
pdftoppm -jpeg -r 150 output.pdf slide

这将创建 slide-01.jpgslide-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 转图片