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 获取完整详细信息。
- 使用
thumbnail.py分析模板 - 解包 → 操作幻灯片 → 编辑内容 → 清理 → 打包
从零开始创建#
阅读 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(预期: [简要描述])
验证循环#
- 生成幻灯片 → 转换为图像 → 检查
- 列出发现的问题(如果未找到,更批判地再次查看)
- 修复问题
- 重新验证受影响的幻灯片——一个修复经常创建另一个问题
- 重复直到完整遍未显示新问题
在至少完成一次修复和验证循环之前,不要宣布成功。
转换为图像#
将演示文稿转换为单独的图像文件以进行视觉检查:
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 到图像