# Ppt Afp

> PPT全自动生成流（AFP：Auto-Flow Prompt）。用户提供主题和内容，Agent自动完成：风格选择 → 大纲生成 → Prompt生成 → AI生图 → 打包PPTX → 发送飞书。当用户说"帮我做PPT"、"生成幻灯片"、"制作演示文稿"、"ppt-afp"时触发。

- Skill: `augustscl/ppt-afp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add augustscl/ppt-afp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/augustscl/ppt-afp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: augustscl (https://skillmd.com/u/augustscl)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/augustscl/ppt-afp

---


# PPT AFP — 全自动幻灯片生成流

> **角色**：你是顶级视觉设计师 + PPT产品经理，擅长将内容转化为震撼的演示文稿。

---

## ⛔ 执行前必读（三条铁律）

1. **每次执行前必须重新 read 本 SKILL.md**，不能凭印象走
2. **每完成一个阶段，显式报告**：说出"P阶段完成"再进入下一阶段
3. **每阶段结束对照下方 Phase Gate 逐条核查**，全部打勾才能继续

---

## 📊 进度仪表盘（每阶段更新）

```
PPT AFP 进度
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
P0 参数收集     [⬜/🔄/✅]
P1 风格确认     [⬜/🔄/✅]  风格：___  张数：___  受众：___
P2 大纲生成     [⬜/🔄/✅]  共___张已确认
P3 Prompt生成   [⬜/🔄/✅]  ___个prompt已确认
P4 AI生图       [⬜/🔄/✅]  ___/___张完成
P5 打包发送     [⬜/🔄/✅]  PPTX已发送
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## P0：参数收集

**收集以下信息（未提供则主动询问）：**

| 参数 | 说明 |
|------|------|
| 主题 | PPT的核心主题（必须） |
| 内容来源 | 已有大纲/文档路径，或从零开始 |
| 目标用途 | 直播/演讲/分享/内部汇报 |
| 张数偏好 | 不填则根据内容自动推荐（8-15张） |
| 是否发飞书 | 默认是 |

**Phase Gate P0：**
- [ ] 主题明确
- [ ] 内容来源确认
- [ ] 用途清晰

---

## P1：风格确认（⚠️ 必须让用户选，不能自行决定）

### Step 1：发送风格图鉴

**发送飞书预览文档链接，让用户直观浏览37种风格：**

> 📎 **风格图鉴文档**：https://sgl0nnj5ev.feishu.cn/docx/YV09dH7KHoKUGgxZKGVcm4MHnkf
>
> 打开后可以看到所有37种风格的预览图，按场景分类，每个风格都有编号和说明。

**发送话术示例（直接发给用户）：**
```
我为你准备了37种PPT风格预览 👉 https://sgl0nnj5ev.feishu.cn/docx/YV09dH7KHoKUGgxZKGVcm4MHnkf

打开看看，选一个你喜欢的编号（1-37）告诉我就行！
```

### Step 2：等待用户选择 + 确认参数

用户选择风格后，同时确认：
- **受众**：一般读者 / 初学者 / 专家 / 高管
- **张数**：推荐N张（基于内容量），用户可调整
- **是否审查大纲**：是/否（建议是）
- **是否审查Prompt**：是/否（建议否，节省时间）

### 风格编号速查表

| # | 风格名 | 分类 |
|---|--------|------|
| 1 | bold-editorial | 🔥 演讲 |
| 2 | dark-atmospheric | 🔥 演讲 |
| 3 | minimal | 🔥 演讲 |
| 4 | magazine-editorial-light | 🔥 演讲 |
| 5 | gradient-aurora | 🔥 演讲 |
| 6 | warm-gradient | 🔥 演讲 |
| 7 | corporate | 💼 商务 |
| 8 | notion | 💼 商务 |
| 9 | data-dashboard | 💼 商务 |
| 10 | isometric-3d | 💼 商务 |
| 11 | chalkboard | 📚 教育 |
| 12 | sketch-notes | 📚 教育 |
| 13 | scientific | 📚 教育 |
| 14 | blueprint | 📚 教育 |
| 15 | intuition-machine | 📚 教育 |
| 16 | storybook | 📚 教育 |
| 17 | watercolor | 🎨 创意 |
| 18 | vector-illustration | 🎨 创意 |
| 19 | fantasy-animation | 🎨 创意 |
| 20 | paper-cut | 🎨 创意 |
| 21 | bauhaus | 🎨 创意 |
| 22 | neon-pop | 🎨 创意 |
| 23 | candy-pastel | 🎨 创意 |
| 24 | neon-cyberpunk | 🔮 科技 |
| 25 | retro-synthwave | 🔮 科技 |
| 26 | terminal-hacker | 🔮 科技 |
| 27 | glassmorphism | 🔮 科技 |
| 28 | pixel-art | 🔮 科技 |
| 29 | ink-wash | 🏛 文化 |
| 30 | chinese-national-tide | 🏛 文化 |
| 31 | japanese-zen | 🏛 文化 |
| 32 | vintage | 🏛 文化 |
| 33 | earth-organic | 🏛 文化 |
| 34 | newspaper | ⚔️ 特殊 |
| 35 | military-tactical | ⚔️ 特殊 |
| 36 | brutalist | ⚔️ 特殊 |
| 37 | editorial-infographic | ⚔️ 特殊 |

**Phase Gate P1：**
- [ ] 已发送风格图鉴链接
- [ ] 用户已选择风格
- [ ] 受众已确认
- [ ] 张数已确认

---

## P2：大纲生成

**执行步骤：**

1. 创建工作目录：
   ```
   ~/.openclaw/workspace/slide-deck/{topic-slug}/
   ```

2. 调用 `baoyu-slide-deck` 生成大纲：
   - 读取 `~/.openclaw/workspace/skills/baoyu-slide-deck/references/outline-template.md`
   - 读取对应风格文件：`references/styles/{style}.md`
   - 按确认的张数、受众、语言生成 `outline.md`

3. **如果用户选择"审查大纲"**，展示大纲摘要表：

   ```
   | # | 标题 | 类型 | 布局 |
   |---|------|------|------|
   | 1 | xxx  | 封面 | title-hero |
   | 2 | xxx  | 内容 | ... |
   ```
   等待用户确认后继续。

**Phase Gate P2：**
- [ ] outline.md 已生成
- [ ] 用户已确认大纲结构（或跳过审查）

---

## P3：Prompt生成

**执行步骤：**

1. 读取 `~/.openclaw/workspace/skills/baoyu-slide-deck/references/base-prompt.md`
2. 为每张幻灯片生成 prompt 文件，保存到 `prompts/` 目录
3. 每个 prompt 包含：
   - base-prompt 内容
   - STYLE_INSTRUCTIONS（从 outline.md 提取）
   - 该张幻灯片的具体内容描述

4. **生成 batch.json**，格式：
   ```json
   {
     "jobs": 3,
     "tasks": [
       {
         "id": "01-slide-cover",
         "promptFiles": ["prompts/01-slide-cover.md"],
         "image": "01-slide-cover.png",
         "provider": "google",
         "ar": "16:9",
         "quality": "2k"
       }
     ]
   }
   ```

5. 如果用户选择"审查Prompt"，展示 prompt 列表等待确认

**Phase Gate P3：**
- [ ] 所有 prompt 文件已生成（数量 = 张数）
- [ ] batch.json 已生成
- [ ] 用户已确认（或跳过审查）

---

## P4：AI生图

**默认模型配置（按 2026-03-21 实测修正）：**

```bash
# 显式注入，避免环境里旧配置/错误分组继续生效
GOOGLE_API_KEY=<your-key>
GOOGLE_BASE_URL=https://work.poloapi.com/
MODEL=gemini-3.1-flash-image-preview
```

**执行命令（逐张调用，`baoyu-image-gen` 当前版不支持 `--batchfile`）：**
```bash
cd {工作目录} && \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
GOOGLE_API_KEY="$GOOGLE_API_KEY" GOOGLE_BASE_URL="$GOOGLE_BASE_URL" \
npx -y bun ~/.openclaw/workspace/skills/baoyu-image-gen/scripts/main.ts \
  --promptfiles prompts/01-slide-cover.md \
  --image 01-slide-cover.png \
  --provider google --model gemini-3.1-flash-image-preview \
  --ar 16:9 --quality 2k
```

**批量执行原则：** 用脚本循环逐张生成，而不是 `--batchfile batch.json`。

**实时报告进度：** 每完成3张报告一次 "已完成 X/N 张"

**Phase Gate P4：**
- [ ] 所有图片生成成功（Succeeded: N，Failed: 0）
- [ ] 图片分辨率正确（应为约 2752×1536）

---

## P5：打包 & 发送

**步骤1：用 merge-to-pptx.ts 打包**
```bash
cd {工作目录} && \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npx -y bun ~/.openclaw/workspace/skills/baoyu-slide-deck/scripts/merge-to-pptx.ts .
```

**步骤2：移动到标准目录**
```
~/.openclaw/workspace/output/{主题名称}.pptx
```

**步骤3：发送飞书**（使用标准飞书API发送脚本）
```python
# 见 TOOLS.md 中的飞书发文件脚本
# USER = ou_0eb8fd7529b5669c0a2de183a76a760f
```

**步骤4：确认本地路径**

**Phase Gate P5：**
- [ ] PPTX 已生成（文件存在，大小 > 1MB）
- [ ] 已发送飞书（返回 code=0）
- [ ] 本地路径已告知用户

---

## 关键经验（血泪教训）

### ✅ 已验证可用的配置
- **生图模型**：`gemini-3.1-flash-image-preview`（2026-03-21 在 `https://work.poloapi.com/` 显式注入后实测跑通）
- **API**：显式注入 `GOOGLE_API_KEY` + `GOOGLE_BASE_URL=https://work.poloapi.com/`，不要只依赖环境里旧值
- **调用方式**：逐张 `--promptfiles ... --image ...`，不要再用失效的 `--batchfile`
- **merge-to-pptx.ts**：有时输出文件名为 `..pptx`（需要手动 cp 重命名），有时也会正常命名，必须先检查实际产物路径

### ❌ 已知问题
- `--batchfile batch.json`：当前版 `baoyu-image-gen` 不支持，会直接报 `Unknown option: --batchfile`
- `gemini-3-pro-image-preview` / `gemini-3.1-flash-image-preview` 如果没显式吃到正确 `GOOGLE_BASE_URL`，可能报 `model_not_found / No available channel ... under group nano`
- 66MB 级别 PPTX 会被飞书文件上限拦截（`234006 The file size exceed the max value.`），需要额外生成轻量版
- merge-to-pptx.ts 输出路径不稳定 → 用 `find` 或直接检查当前目录确认

### 📐 一定要让用户选风格
- P1 是强制步骤，不能自行决定风格
- 展示风格对比表，让用户做选择

---

## 触发关键词

- "帮我做PPT"、"做个幻灯片"、"制作演示"
- "ppt-afp"、"启动PPT流程"
- 提供了内容/大纲并希望转成PPT