PowerPoint 技能#

Harness-agent 工具#

本技能从 Octop 移植。使用以下 harness/deepagents 工具：

概念	工具
Shell	execute
读/写/编辑文件	read_file, write_file, edit_file
查找文件/搜索内容	glob, grep
获取 URL	web_fetch
浏览器自动化	browser_use
子代理工作	task
记忆	memory_store, memory_recall, memory_search

内置技能文件位于 /_builtin_skills/<name>/。用户安装的技能位于 /skills/<name>/。

脚本： 在 init_workspace 后的工作区根目录，使用类似 python _builtin_skills/powerpoint/scripts/thumbnail.py deck.pptx 的路径。

何时使用#

当 .pptx 文件以任何方式涉及——作为输入、输出或两者时，都使用此技能。这包括：创建幻灯片、宣传幻灯片或演示文稿；读取、解析或提取任何 .pptx 文件中的文本（即使提取的内容将在其他地方使用，如电子邮件或摘要中）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；使用模板、布局、演讲者备注或注释。每当用户提到 "deck"、"slides"、"presentation" 或引用 .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 (sage)
海洋渐变	065A82 (深蓝)	1C7293 (teal)	21295C (午夜)
炭黑极简	36454F (炭黑)	F2F2F2 (偏白)	212121 (黑色)
Teal 信任	028090 (teal)	00A896 (海泡)	02C39A (薄荷)
Berry & Cream	6D2E46 (berry)	A26769 (尘土玫瑰)	ECE2D0 (奶油)
Sage 平静	84B59F (sage)	69A297 (桉树)	50808E (板岩)
Cherry Bold	990011 (cherry)	FCF6F5 (偏白)	2F3C7E (海军蓝)

每张幻灯片#

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

布局选项：

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

数据显示：

• 大统计数字（60-72pt 带下方小标签）
• 比较列（之前/之后、优点/缺点、并排选项）
• 时间线或流程（编号步骤、箭头）
• 图表（条形图、饼图、折线图）

视觉润色：

• 章节标题旁的彩色圆圈中的图标
• 关键统计或标签的斜体强调文本
• 形状或图像旁边的装饰性线条

排版#

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

标题字体	正文字体
Georgia	Calibri
Arial Black	Arial
Calibri	Calibri
Cambria	Calibri
Trebuchet MS	Calibri
Impact	Arial
Palatino	Garamond
Consolas	Calibri

元素	大小
幻灯片标题	36-44pt 粗体
章节标题	20-24pt 粗体
正文文本	14-16pt
说明文字	10-12pt 柔和

间距#

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

避免（常见错误）#

• 不要重复相同布局——在幻灯片之间变化列、卡片和标注
• 不要居中正文文本——左对齐段落和列表；仅居中标题
• 不要在尺寸对比上偷懒——标题需要 36pt+ 才能从正文中脱颖而出
• 不要默认使用蓝色——选择与特定主题匹配的颜色
• 不要随机混合间距——选择 0.3" 或 0.5" 间隙并一致使用
• 不要只设置一张幻灯片的样式而将其余部分留空——全面承诺或全程保持简单
• 不要创建仅文本的幻灯片——添加图像、图标、图表或视觉元素；避免纯标题 + 项目符号
• 不要忘记文本框架填充——将线条或形状与文本边缘对齐时，设置 margin: 0 或偏移形状以考虑填充
• 不要使用低对比度元素——图标 AND 文本需要对背景有强对比度；避免浅色文本在浅色背景上或深色文本在深色背景上
• 绝不使用标题下划线——这些是 AI 生成幻灯片的标志；改用空白或背景颜色
• 永远、永远、永远不要使用默认的 PowerPoint 过渡——使用无过渡、淡入或精美微妙的东西

---

质量保证（必需）#

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

你的首次渲染几乎永远不会正确。将 QA 视为错误搜寻，而不是确认步骤。如果你在首次检查时发现零问题，说明你检查得不够努力。

内容 QA#

python -m markitdown output.pptx

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

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

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

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

视觉 QA#

⚠️ 使用子代理——即使对于 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.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 到图像