---
title: "生成汇报幻灯片"
description: "说明如何让 Codex 用 slides 和 imagegen skills 创建或修改 PowerPoint deck。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

Codex 可以用 `$slides` 系统 skill 直接操作 PowerPoint deck，通过 PptxGenJS 创建和编辑 `.pptx`，再用 `$imagegen` 生成封面、插图、图解和 slide visuals。适合从已有 deck 修改，也适合从结构化 notes 创建新 deck。

> [!WARNING]
> Deck 任务交付物不是“能打开的 PPTX”就结束。必须渲染逐页图片，检查溢出、字体替换、布局漂移和生成素材是否可复用。

官方页面：[https://developers.openai.com/codex/use-cases/generate-slide-decks](https://developers.openai.com/codex/use-cases/generate-slide-decks)

## 适合什么任务

| 场景 | Codex 应该做什么 |
|---|---|
| notes 或 structured inputs 需要变成 repeatable slide decks | 按 slide-by-slide 规则生成 deck，并保留可编辑结构 |
| 从零创建视觉化 presentation | 用 `$slides` 生成 `.pptx`，用 `$imagegen` 生成视觉素材 |
| 从 screenshots、PDFs 或 reference presentations 重建/扩展 deck | 先 inspect 或 render 参考，再按 source aspect ratio 重建 |
| 现有 deck 有 spacing、alignment、font 或 overflow 问题 | render 每页、检查溢出和字体替换，再修布局 |

## 使用的能力

| 能力 | 用法 | 链接 |
|---|---|---|
| `$slides` | 用 JavaScript、PptxGenJS、bundled helpers、render/validation scripts 创建和编辑 `.pptx` deck | [https://developers.openai.com/codex/skills](https://developers.openai.com/codex/skills) |
| `$imagegen` | 生成 illustrations、cover art、diagrams 和 slide visuals，并保持统一视觉方向 | [https://developers.openai.com/api/docs/guides/image-generation](https://developers.openai.com/api/docs/guides/image-generation) |

相关官方说明：

- Image generation guide：[https://developers.openai.com/api/docs/guides/image-generation](https://developers.openai.com/api/docs/guides/image-generation)
- Codex skills：[https://developers.openai.com/codex/skills](https://developers.openai.com/codex/skills)

## 起始提示词

```text
请使用 $slides 和 $imagegen skills，按下面方式编辑这个 slide deck：

- 如果存在 logo.png，请把它添加到每页 slide 的右下角
- 在 slides X、Y 和 Z 上，把文字移到左侧，并用 image generation 在右侧生成 illustration（style：abstract, digital art）
- 只要可行，保留 text 为 text，simple charts 保留为 native PowerPoint charts
- 添加这些 slides：[describe new slides here]
- 新 slides 和新 text 使用现有 branding，包括 colors、fonts、layout 等
- 交付前，把更新后的 deck 渲染成 slide images，review 输出，并修复 layout issues
- 交付前运行 overflow 和 font-substitution checks；如果 deck 很密集，尤其要检查
- 创建一批 related images 时，保存可复用 prompts 或 generation notes

输出：
- 一份已应用改动的 slide deck 副本
- 说明哪些 slides 是生成的、重写的，哪些保持不变
```

这个 prompt 的关键是保持 deck editable，并要求 Codex 在交付前 render、review、修 layout、跑 overflow 和 font-substitution checks。

## 从 Source Deck 和 References 开始

如果已有 deck，先让 Codex inspect，再修改。`$slides` 对这个流程有明确偏好：

- 先匹配 source aspect ratio。
- 只有 source material 没定义 deck size 时，才默认 16:9。
- 如果 references 是 screenshots 或 PDF，先 render 或 inspect，视觉比较 slide geometry，而不是猜。

从已有品牌 deck 开始，通常比从零描述颜色和版式更稳。

## 保持 Deck 可编辑

新 slide 不要整页 rasterize。能保持 PowerPoint-native 的内容尽量保持：

- text 仍然是 text。
- simple bar / line / pie / histogram 尽量用 native charts。
- 简单 layout elements 用 slide objects。
- 复杂 illustration 或 custom diagram 才放 SVG / image assets。

例如要做复杂 timeline，不要生成一张完整图片。让 Codex 分别生成插图，用 native lines 连接，日期和文字保留为 text objects。

## 有意识地生成视觉素材

`$imagegen` 适合 cover image、concept illustration 或 lightweight diagram。先让 Codex 定义 visual direction，再在整套 deck 中复用。

如果多页需要同一风格素材，让 Codex 保存 prompts 或 generation notes。这样后续扩展 deck 时，不用重新摸索视觉风格。

## 明确每页逻辑

Deck automation 适合 slide-by-slide 决策：

- 哪些 slide 要保留原文。
- 哪些 slide 需要更强 headline 和更清晰结构。
- 哪些 slide 只做 asset cleanup 或 formatting fixes。

`$slides` 也带有 layout helpers。让 Codex 把这些 helpers 复制到工作目录并复用，不要每页重新写 spacing、text-sizing 和 image-placement 逻辑。

## 交付前验证

deck 很容易“几乎正确”，但导出后出现 clipped text、substituted fonts 或 layout drift。

交付前要求 Codex：

- render deck 为逐页 PNG。
- 生成 quick montage 供 review。
- 检测 overflow beyond slide canvas。
- 报告 missing 或 substituted fonts。
- 对 dense slides 和 tight margins 做重点检查。

## 可尝试的任务

### 从零生成新幻灯片

逐页描述你要的内容和整体 vibe。如果有 logo 或图片，把它们放在同一目录，方便 Codex 访问。

### 更新幻灯片模板

定期更新 weekly、monthly 或 quarterly deck。高频更新时，创建 `guidelines.md` 定义内容结构和更新方式，并结合其他 skills 拉取数据源。

### 调整已有幻灯片

已有 deck 但 spacing、misaligned text 或 layout 有问题时，让 Codex render 后逐页修复。

## 接下来去哪

<Cards>
  <Card title="用 Codex 学新概念" description="先把论文、课程或复杂材料变成结构化 report，再转 deck。" href="/docs/codex/official/08-scenarios/104-learn-concepts" />
  <Card title="从数据到报告" description="需要图表、数据结论和分析叙事时，先完成报告再做幻灯片。" href="/docs/codex/official/08-scenarios/92-data-to-report" />
  <Card title="Skills 复用" description="高频 deck 更新要沉淀模板、检查脚本和品牌规则。" href="/docs/codex/official/03-extensions/09-skills-reuse" />
  <Card title="官方 Generate slide decks" description="最新 skill 和 use case 说明以官方页面为准。" href="https://developers.openai.com/codex/use-cases/generate-slide-decks" />
</Cards>
