---
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="/zh-Hant/docs/codex/official/08-scenarios/104-learn-concepts" />
  <Card title="從資料到報告" description="需要圖表、資料結論和分析敘事時，先完成報告再做幻燈片。" href="/zh-Hant/docs/codex/official/08-scenarios/92-data-to-report" />
  <Card title="Skills 複用" description="高頻 deck 更新要沉澱模板、檢查指令碼和品牌規則。" href="/zh-Hant/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>
