前言¶
做完一套 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。
