前言¶
在 Agent 里做 PPT，常见问题是生成过程不透明：用户只能等最终结果，大纲和版式一旦偏离预期，就要整份重来。把「主题一句话」交给模型时，页数、受众、语气往往也没有统一入口。AiPPT 是 SkillHub 上分类为 office-efficiency 的社区 Skill（坐标 @user_14eee471/aippt-generator，当前版本 4.0.2），面向「智能生成 + 可配置 + 合成前可改大纲」这一类需求，下面按定位、能力、安装和注意点说明。
这是什么¶
AiPPT Skill 是一个 PPT 生成 Skill，支持智能生成、文档上传、导入 PPT、链接生成和 AI 单页生成，并提供高阶配置、大纲修改、模板选择、过程感知和安全鉴权托管。
- 维护方：SkillHub 社区发布者
user_14eee471，来源标注为 community。 - 解决的问题：把多种 PPT 产出路径收敛到同一套 Skill 流程里，并在合成前暴露大纲与阶段进度，减少「黑盒一次生成」带来的返工。
官方入口：
- API 坐标页：https://api.skillhub.cn/user_14eee471/aippt-generator
- SkillHub 展示页：https://www.skillhub.cn/skills/user_14eee471/aippt-generator
核心功能¶
以下能力均来自 SkillHub 页面与预抓取说明，未单独列出的细节不作延伸。
过程感知，而非黑盒生成¶
生成过程中会展示大纲、内容、模板、合成等关键阶段，便于判断当前进行到哪一步，而不是只返回最终文件。
五类生成场景¶
- 主题 / 智能生成：按主题与参数生成整套 PPT。
- 资料生成：基于上传文档生成。
- 导入 PPT 再生成：在已有 PPT 基础上再生成。
- 链接生成：通过链接作为输入来源生成。
- AI 单页生成：单独生成单页内容。
大纲可修改¶
在 PPT 合成之前，可以确认并调整结构，降低「一次性结构不对」的概率。
高阶配置¶
- 智能生成：支持页数、受众、语气、语言、模型、联网搜索等配置。
- 文档上传：支持保持原文、适当扩写、润色美化、切换模型等处理方式。
模板数量可配置¶
首次配置即可指定每次返回几个模板，避免候选模板过多或过少。
API Key 与安全¶
Skill 标签包含 requires_api_key=true，并说明提供安全鉴权托管。使用前需按 Skill 内指引配置 API Key，具体字段以安装后的 SKILL.md 为准。
安装与启用¶
SkillHub 官方安装说明见：https://skillhub.cn/install/skillhub.md
安装本 Skill 时，页面给出的提示为：根据上述文档安装 @user_14eee471/aippt-generator。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 文档执行完整安装（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
2、安装 AiPPT 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被 Agent 加载。
skillhub install user_14eee471/aippt-generator --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
Cursor、Codex、Claude Code 的差异主要体现在 --dir 目标路径；安装命令本身一致。安装后按各客户端要求重启或刷新 Agent，并阅读 Skill 包内的 SKILL.md 完成 API Key 等配置。
典型用法¶
公开页面未提供逐条复制的对话示例，可复现的流程可按能力拆分理解：
- 在 Agent 中启用 AiPPT Skill（安装完成且 API Key 已配置）。
- 选择场景：说明是主题生成、上传文档、导入现有 PPT、提供链接，或单页生成。
- 补充高阶参数（按需）：例如页数、受众、语气、语言、模型、是否联网搜索；文档场景下选择保持原文、扩写或润色等。
- 查看过程阶段：关注大纲、内容、模板、合成等阶段输出。
- 在大纲阶段修改结构，确认后再进入合成。
- 在模板步骤按配置的返回数量选择模板，得到最终 PPT。
具体触发话术与返回格式以安装后的 Skill 文档为准。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code、Codex 等支持 Skills 的环境里，用统一流程做演示稿、汇报稿、培训材料。
- 希望在大纲和模板环节介入，而不是只接受一次性成稿的用户。
注意
- 必须配置 API Key（
requires_api_key=true）；未配置时无法按设计完成鉴权与生成。 - 联网搜索、模型选择等能力依赖 Skill 与后端服务实现，以实际 Skill 版本（4.0.2）文档为准。
- 社区来源（community）Skill，升级与问题反馈以 SkillHub 发布页与发布者说明为准。
结尾¶
AiPPT 把 PPT 生成的多条路径（主题、文档、导入、链接、单页）放在同一 Skill 里，并通过阶段展示与合成前大纲修改，把「黑盒等待」改成可检查的流程。若你在 office-efficiency 类 Skill 里找 PPT 能力，可从 SkillHub 安装 @user_14eee471/aippt-generator，并打开官方页核对版本与说明：https://www.skillhub.cn/skills/user_14eee471/aippt-generator
