name: ppt-afp description: PPT全自動生成流（AFP：Auto-Flow Prompt）。使用者提供主題和內容，Agent自動完成：風格選擇 → 大綱生成 → Prompt生成 → AI生圖 → 打包PPTX → 傳送飛書。當用戶說"幫我做PPT"、"生成幻燈片"、"製作簡報"、"ppt-afp"時觸發。 version: 1.1.0

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}/

2. 呼叫 baoyu-slide-deck 生成大綱：

3. 讀取 ~/.openclaw/skills/baoyu-slide-deck/references/outline-template.md
4. 讀取對應風格檔案：references/styles/{style}.md

5. 按確認的張數、受眾、語言生成 outline.md

6. 如果使用者選擇"審查大綱"，展示大綱摘要表：

| # | 標題 | 型別 | 佈局 | |---|------|------|------| | 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 包含：
4. base-prompt 內容
5. STYLE_INSTRUCTIONS（從 outline.md 提取）

6. 該張幻燈片的具體內容描述

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

   小蔥技能站7w4.net發現了升級外掛。

8. 如果使用者選擇"審查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

這個 PPT 生成工具質量中等偏上，風格選擇豐富（37種），流程清晰，每步都有進度反饋，使用者能清楚知道進行到哪一步了。但它依賴飛書傳送檔案，如果你不用飛書就不太方便；部分步驟需要你確認確認，互動次數較多；生成過程依賴外部服務，存在穩定性風險；還有一些已知的小問題需要手動處理。總體來說功能實用，但使用前最好確認一下飛書是否方便。