ppt-afp（法新社 PPT）

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：参数收集

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

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：是/否（建议否，节省时间）

风格编号速查表

Phase Gate P1：

• [ ] 已发送风格图鉴链接
• [ ] 用户已选择风格
• [ ] 受众已确认
• [ ] 张数已确认

P2：大纲生成

执行步骤：

1. 创建工作目录：

   ~/Desktop/二饼文件夹/openclaw 二饼/slide-deck/{topic-slug}/

1. 调用 baoyu-slide-deck 生成大纲：

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

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

   | # | 标题 | 类型 | 布局 |
   |---|------|------|------|
   | 1 | xxx  | 封面 | title-hero |
   | 2 | xxx  | 内容 | ... |

等待用户确认后继续。

Phase Gate P2：

• [ ] outline.md 已生成
• [ ] 用户已确认大纲结构（或跳过审查）

P3：Prompt生成

执行步骤：

1. 读取 ~/.openclaw/skills/baoyu-slide-deck/references/base-prompt.md
2. 为每张幻灯片生成 prompt 文件，保存到 prompts/ 目录
3. 每个 prompt 包含：

- base-prompt 内容 - STYLE_INSTRUCTIONS（从 outline.md 提取） - 该张幻灯片的具体内容描述

1. 生成 batch.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"
       }
     ]
   }

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

Phase Gate P3：

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

P4：AI生图

默认模型配置（已验证中文渲染正确）：

# 从环境变量读取（已配置在 ~/.zshrc）
# GEMINI_API_KEY=<your-key>
# GOOGLE_BASE_URL=<your-url>
MODEL=gemini-3-pro-image-preview

执行命令：

cd {工作目录} && \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npx -y bun ~/.openclaw/skills/baoyu-image-gen/scripts/main.ts \
  --batchfile batch.json --jobs 3 \
  --provider google --model gemini-3-pro-image-preview

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

Phase Gate P4：

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

P5：打包 & 发送

步骤1：用 merge-to-pptx.ts 打包

cd {工作目录} && \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npx -y bun ~/.openclaw/skills/baoyu-slide-deck/scripts/merge-to-pptx.ts .

步骤2：移动到标准目录

~/Desktop/二饼文件夹/openclaw 二饼/PPT/{主题名称}.pptx

步骤3：发送飞书（使用标准飞书API发送脚本）

# 见 TOOLS.md 中的飞书发文件脚本
# USER = ou_74c5a7816fcb78172bfca68a7f7449e8

步骤4：确认本地路径

Phase Gate P5：

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

关键经验（血泪教训）

✅ 已验证可用的配置

• 生图模型：gemini-3-pro-image-preview（中文完全正确，2752×1536高分辨率）
• API：通过环境变量 GEMINI_API_KEY 和 GOOGLE_BASE_URL 配置（见 ~/.zshrc）
• merge-to-pptx.ts：输出文件名为 ..pptx（需要手动 cp 重命名）

❌ 已知问题

• gemini-2.5-flash-image 中文乱码 → 不要用
• ar=16:9 参数对某些模型无效 → gemini-3-pro 已解决
• merge-to-pptx.ts 输出路径是上一级目录的 ..pptx → 用 find 找到后 cp

📐 一定要让用户选风格

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

触发关键词

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