前言¶
做完一套 PPT，往往還要再寫一套能對着講的口播稿，並拷進每頁備註。手工做時，容易變成「念標題加要點」，頁與頁之間也接不上。下面介紹 SkillHub 上的社區 Skill「自動生成PPT演講稿」（座標 @user_c3227de9/ppt-speech-skill）：在 Agent 或支持該工作流的平臺上，上傳 .pptx，按聽衆與風格生成逐頁講稿，寫回 PowerPoint 備註區，並輸出可編輯的全文稿。
這是什麼¶
「自動生成PPT演講稿」是 SkillHub 分類 office-efficiency 下的社區 Skill，發佈者爲 user_c3227de9，當前商店頁標註版本爲 1.0.0，來源爲 community。SkillHub 元數據標明 requires_api_key=false，即安裝 Skill 本身不強制單獨配置 API Key（實際生成仍依賴宿主環境裏的模型與工作流運行時）。
它面向已有 PPT 的彙報、路演、培訓等場景：解析每頁標題與正文，用 LLM 按頁生成講解稿（帶上一頁摘要作上下文），再把講稿寫入備註，並彙總、優化全文講稿文本。
核心功能¶
根據已安裝的 SKILL.md、skill.yaml 與 workflow.yaml，可覈實的能力如下。
- 逐頁生成講稿：讀取每頁形狀中的文本，以標題與內容爲依據生成口播稿；提示詞要求「講解而非複述」，並約束約 30～50 秒一頁的節奏。
- 寫入 PPT 備註：用
python-pptx打開上傳文件，將每頁講稿寫入對應頁的notes_text_frame，保存爲ppt_with_notes.pptx（工作流中默認路徑爲/tmp/ppt_with_notes.pptx）。 - 跨頁上下文：循環中對每一頁先根據
prev_summary生成講稿，再 LLM 提取一句話摘要，供下一頁使用，減輕「逐頁拼接」感。 - 風格與聽衆參數：對外輸入包括
audience（聽衆類型，默認「客戶」）、style（演講風格，默認「銷售型」）、total_duration（總時長，默認「10分鐘」）。文檔中說明的銷售型、彙報型、培訓型差異寫在生成提示詞裏。 - 雙輸出：工作流輸出
ppt_file（帶備註的 PPTX）與speech_text（經全局 LLM 優化後的完整講稿文本）。
工作流節點順序爲：解析 PPT → 初始化上下文 → 逐頁 LLM 生成與摘要 → 寫回備註 → 合併文本 → 全文優化。
安裝與啓用¶
通過 SkillHub CLI（Cursor 等 Agent）¶
先確認本機是否已有 skillhub CLI；若無，可按 SkillHub 官方安裝說明安裝（完整安裝或僅 CLI）。安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。
Cursor 常用 skills 目錄爲 ~/.cursor/skills/。安裝本 Skill 的命令如下：
skillhub install @user_c3227de9/ppt-speech-skill --dir ~/.cursor/skills/
也可將提示詞交給 AI，讓其按 SkillHub 安裝說明 執行同等安裝。
OpenClaw / ArkClaw 類平臺¶
SKILL.md 中另給了一種路徑：將技能目錄打成 zip，在平臺的「技能管理」中導入並啓用；若環境提供 OpenClaw CLI，文檔示例爲：
zip -r ppt-speech-skill.zip ppt-speech-skill/
openclaw skill install ppt-speech-skill.zip
openclaw skill enable ppt_speech_generator_pro_v2
具體平臺名稱、菜單與 enable 的 ID 以你使用的宿主爲準；工作流定義裏的 id 爲 ppt_speech_generator_pro_v2，skill.yaml 中的 id 爲 ppt_speech_generator。
運行依賴¶
工作流中的 Python 節點依賴 python-pptx：
pip install python-pptx
寫回文件時需要對 /tmp（或工作流配置的輸出路徑）具備寫權限。
典型用法¶
在支持該 Skill 工作流的界面中，一般流程爲：
- 打開或啓用「自動生成PPT演講稿」。
- 上傳
.pptx文件（skill.yaml中file爲必填）。 - 設置
audience、style，必要時調整total_duration。 - 運行工作流，等待解析、逐頁生成、寫備註與全文優化完成。
輸出側可預期：
- PPT 文件：默認文件名爲
ppt_with_notes.pptx；在 PowerPoint 中通過「查看 → 備註」查看每頁講稿。 - 演講稿文本：按「第 N 頁」分段的全文，經
optimize_text節點做連貫性優化後的結果。
若僅在 Cursor 等環境中安裝了 SKILL.md 而未掛載完整工作流運行時，Agent 會按文檔描述理解能力邊界；真正自動寫備註需宿主能執行 workflow.yaml 中的 Python 與 LLM 節點。
適用場景與注意¶
適合誰：需要快速把已有幻燈片變成可演講版本的人——商務彙報、產品路演、內訓課件等；文檔建議 PPT 有明確標題與清晰要點，頁數建議不超過約 20 頁，以降低質量與耗時風險。
能力邊界：當前解析邏輯主要遍歷 slide.shapes 上帶 text 的形狀，按先出現的文本作標題、其餘作內容；複雜圖表、圖片內文字、SmartArt 等不會單獨做視覺或 OCR 解析。若頁內信息主要在圖裏，生成質量可能不足。
版本與包內文件：商店頁版本爲 1.0.0；下載包內 skill.yaml 的 version 字段爲 1.1.0，以你實際安裝包爲準。更新後若平臺不生效，文檔建議修改版本號、重新導入並重啓服務。
規劃能力：SKILL.md 的 Roadmap 列出語音朗讀、演講視頻、Word 導出、多語言等項，均爲未勾選狀態，不應視爲當前已交付功能。
SkillHub 頁面顯示該 Skill 評分 100000、下載 16337 次、安裝 147 次（數據隨商店更新變化）。
結尾¶
「自動生成PPT演講稿」把「寫口播 + 填備註」收成一條可配置的工作流：上傳 PPT、選聽衆與風格，得到帶備註的 ppt_with_notes.pptx 與可編輯全文稿。官方 SkillHub 頁面：https://www.skillhub.cn/skills/user_c3227de9/ppt-speech-skill；API 資源地址：https://api.skillhub.cn/user_c3227de9/ppt-speech-skill。
