前言¶
在 IDE 里让模型「做个 PPT」，常见结果是泛泛的 Markdown 大纲，或者版式雷同、装饰元素堆叠的 .pptx，后续还要自己打开 PowerPoint 或写脚本补全。若你希望 Agent 直接产出可编辑的 Office 格式文件，并在生成阶段就约束配色与排版，需要一套把 python-pptx 能力与设计规范写进 Skill 的约定。下面介绍 SkillHub 上的 PPT 演示文稿生成（坐标 @user_24e9cdd5/pptx-generator-pro）如何承担这件事。
这是什么¶
PPT 演示文稿生成 是面向办公效率（分类 office-efficiency）的社区 Skill，当前版本 1.0.0，发布者为 user_24e9cdd5，来源为 community。标签标明 requires_api_key=false，安装后无需额外 API Key。
技能定位：基于 python-pptx 从零生成、编辑、分析 .pptx 文件，并在 Skill 内内置配色、排版与「反 AI 味」规则，减少机器套模板常见的强调线、装饰色条等问题。官方页面与 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_24e9cdd5/pptx-generator-pro
- API：https://api.skillhub.cn/user_24e9cdd5/pptx-generator-pro
核心功能¶
以下能力均来自官方简介，可按场景组合使用。
- 创建演示文稿：支持普通汇报、融资 deck、课件等从零搭建幻灯片结构。
- 读取与分析：从已有
.pptx提取文字，便于摘要、改写或迁移内容。 - 编辑与套模板：在现有文件上增删改页、套用模板再出一版。
- 富媒体与备注：可加入图表、图片、图标，以及每页演讲者备注。
- 设计约束：内置 10 套配色、排版规范、版式灵感，以及「AI 味避坑清单」（例如：绝不在标题下加强调线、绝不加装饰色条等），用于约束 Agent 的版式选择。
自然语言触发示例（官方列出）：「做个 PPT」「生成演示文稿」「把这份大纲做成 slides」「读取这个 pptx 的文字」「套用这个模板改一版」「给每页加演讲者备注」。
安装与启用¶
安装流程遵循 SkillHub 通用说明（https://skillhub.cn/install/skillhub.md）。先确认本机是否已有 skillhub CLI：
command -v skillhub && skillhub --version
若未安装，可使用官方一键脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。官方页面给出的坐标为：
skillhub install @user_24e9cdd5/pptx-generator-pro --dir <skills 目录>
常用客户端的 skills 目录（来自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
以 Cursor 为例，完整命令形如：
skillhub install @user_24e9cdd5/pptx-generator-pro --dir ~/.cursor/skills/
安装后按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。Skill 本体为通用 SKILL.md 格式，由 Agent 读取后指导调用 python-pptx 相关流程；运行环境需能安装并使用 python-pptx（具体依赖以 Skill 包内说明为准）。
典型用法¶
官方资料未提供固定代码片段，典型用法是通过对话描述目标，由 Skill 约束生成路径。可按下面几类组织请求：
- 从零生成：说明受众、页数或大纲，并点名 deck 类型（如融资 deck、课件），让 Agent 输出
.pptx文件路径。 - 大纲转 slides：粘贴 Markdown 或条目列表，使用「把这份大纲做成 slides」类表述。
- 读已有文件：提供本地
xxx.pptx路径，要求提取各页文字或结构摘要。 - 改稿与模板：给出原文件与模板路径，说明要保留/替换的版式或品牌色。
- 备注与素材：指定某页插入图表或图片，或「给每页加演讲者备注」。
经过上面的步骤，Agent 应在工作区内写出或更新 .pptx，而不是只返回纯文本大纲。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code 等环境里直接落盘
.pptx的开发者或内容作者。 - 希望减少「AI 幻灯片」常见版式毛病，愿意让 Skill 内置规则参与排版决策的团队。
- 已有模板或旧 deck，需要批量改字、套版、补备注的场景。
限制与注意
- 能力边界由
python-pptx决定，复杂动画、部分 SmartArt 或重度母版特性可能无法与手工在 PowerPoint 中编辑的效果完全一致，生成后仍建议在 Office/WPS 中打开验收。 - 图表、图片、图标依赖你提供的素材路径或 Skill 内约定；大文件或嵌入字体需自行确认授权与体积。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 12047；安装量等以 SkillHub 实时展示为准。
- 无需 API Key，但本机 Python 环境与写文件权限需正常，且
--dir必须指向当前 Agent 的 skills 目录。
结尾¶
PPT 演示文稿生成 把 python-pptx 的操作面与一套可复用的设计、避坑规则写进 Agent Skill，适合从对话直接走到可编辑幻灯片文件。若你要在 Cursor 等工具里统一处理「生成 / 读取 / 改模板 / 加备注」类需求，可从官方页安装 @user_24e9cdd5/pptx-generator-pro：https://www.skillhub.cn/skills/user_24e9cdd5/pptx-generator-pro。
