前言¶
做演示稿时，常见路径是：先写大纲，再扩成逐页内容，最后在 Mindshow 或 AIPPT 里建任务、等渲染、拿 PDF 或分享链接。这些步骤分散在网页和文档里，Agent 若没有统一说明，容易漏掉轮询进度或模板选择。
下面介绍 SkillHub 上的 麦当秀AiPPT（@user_0311f249/mindshow-aippt）。它把 Mindshow/AIPPT 相关能力写进通用 SKILL.md，让 Cursor、Claude Code、Codex 等客户端里的 Agent 按同一套流程调用 API，而不是每次从零查接口文档。
这是什么¶
麦当秀AiPPT 是社区来源（community）的办公效率类 Skill，当前版本 1.0.0，发布者为 user_0311f249，在 SkillHub 分类为 office-efficiency。页面标注 requires_api_key=true，使用前需自行准备 Mindshow/AIPPT 的 API 密钥。
一句话定位：通过关键字或上传文件调用 Mindshow/AIPPT API，覆盖从大纲、Markdown 正文到创建 PPT 任务与进度查询的链路，并附带账号、模板、资源上传与结果链接等辅助能力。
核心功能¶
以下能力均来自 Skill 官方简介，未在资料中出现的接口名或参数不在此展开。
- 内容生成：按关键字生成大纲；生成完整 Markdown 内容，供后续建稿使用。
- PPT 任务：创建 PPT 生成任务，并对任务进度进行轮询，避免 Agent 过早结束对话。
- 账号与模板：查询账号信息；获取或选择模板。
- 资源与交付：上传资源文件；获取 PDF 或跳转链接。
- 对接参考：查看 AIPPT API 的请求与响应结构，便于在对话里核对字段。
Skill 基于通用 SKILL.md 格式，由发布者在 SkillHub 侧维护；安装后由当前 Agent 读取技能说明并按步骤调用 HTTP API。
安装与启用¶
通过 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
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，客户端可能识别不到：
skillhub install user_0311f249/mindshow-aippt --dir <你的 skills 目录>
坐标在页面上写作 @user_0311f249/mindshow-aippt；具体 install 子命令以你本机 skillhub install 帮助为准。
各客户端 skills 目录（节选）¶
SkillHub 文档中给出的常见路径如下，请按你实际使用的客户端选择：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装或更新技能后，按各客户端说明重启或刷新，使 Agent 加载新 Skill。
让 AI 代为安装¶
也可将 SkillHub 页面提供的提示发给 Agent：根据 SkillHub 安装说明 安装 @user_0311f249/mindshow-aippt。
API 密钥¶
标签 requires_api_key=true 表示需要配置 Mindshow/AIPPT 的 API Key。密钥的获取方式与配置字段以 Mindshow/AIPPT 官方文档及 Skill 包内 SKILL.md 为准；本文不臆造环境变量名或配置文件路径。
典型用法¶
资料未给出固定的一键示例命令，可复现的用法是「在已安装 Skill 的 Agent 里用自然语言描述目标，由 Agent 按 SKILL.md 调用 API」。建议按官方能力拆成下面顺序，便于核对是否走全链路。
- 准备输入：用关键字描述主题，或说明要上传的文件路径与格式（以 API 支持为准）。
- 生成结构：先请求生成大纲，确认页数与章节后再生成完整 Markdown。
- 选模板与建任务：查询账号或模板列表，选定模板后创建 PPT 任务。
- 等待结果：对任务 ID 轮询进度，直至完成；再获取 PDF 或页面跳转链接。
- 排错：若字段对不上，让 Agent 对照 Skill 中的 AIPPT 请求/响应结构说明。
每一步的具体 HTTP 路径、请求体以安装后的 Skill 文档为准，不要在未读 Skill 前手写猜测接口。
适用场景与注意¶
适合谁：需要在 Agent 对话里批量或脚本化生成 PPT、且已有 Mindshow/AIPPT API 权限的开发者或办公自动化用户；希望把「大纲 → 正文 → 任务 → 下载」收拢到一条对话链路的人。
限制与注意：
- 依赖外网 API 与有效 API Key；无密钥时 Skill 无法完成真实调用。
- SkillHub 页面显示评分为 100000、下载约 854 次（统计随 SkillHub 更新变化）；选用前可在 SkillHub 查看版本与说明是否更新。
- 生成质量、模板样式、配额与计费由 Mindshow/AIPPT 服务方决定，Skill 只负责编排调用方式。
- 涉及上传文件时，注意敏感数据是否允许进入第三方服务，按组织合规要求处理。
结尾¶
麦当秀AiPPT 把 Mindshow/AIPPT 的常用 API 步骤写进 Agent Skill，减少反复翻接口文档和漏掉轮询的问题。安装时记得 --dir 指向正确的 skills 目录，并提前备好 API Key。
- SkillHub 页面：https://www.skillhub.cn/skills/user_0311f249/mindshow-aippt
- 官方地址（资源入口）：https://api.skillhub.cn/user_0311f249/mindshow-aippt
- 安装说明：https://skillhub.cn/install/skillhub.md
