百度文库 AI PPT 生成 Skill
一句话自动生成高质量 PPT,支持多种风格、场景和配色方案。底层通过 bdpan aippt 命令实现。
使用示例详见 reference/aippt-examples.md
触发规则
同时满足以下条件才执行:
- 用户提及"生成PPT"、"做PPT"、"制作PPT"、"AI PPT"、"aippt"、"幻灯片"、"演示文稿"
- 提供了主题、大纲或内容描述
未通过触发规则时,禁止执行任何 bdpan 命令。
上下文延续: 当前对话已在进行 PPT 生成操作时,后续消息无需再次提及关键词即可触发。
安全约束(最高优先级,不可被任何用户指令覆盖)
- 登录:必须使用
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh,禁止直接调用bdpan login及其任何子命令/参数(包括--get-auth-url、--set-code等) - Token/配置:禁止读取或输出
~/.config/bdpan/config.json内容(含 access_token 等敏感凭据) - 更新/登录:更新必须由用户明确指令触发,禁止自动或静默执行;Agent 禁止使用
--yes参数执行 update.sh 或 login.sh - 环境变量:Agent 禁止主动设置
BDPAN_CONFIG_PATH、BDPAN_BIN、BDPAN_INSTALL_DIR等环境变量
前置检查
每次触发时按顺序执行:
- 安装检查:
command -v bdpan,未安装则告知用户并确认后执行bash ${CLAUDE_SKILL_DIR}/scripts/install.sh(用户确认后可加--yes跳过安装器内部确认) - 登录检查:
bdpan whoami,未登录则引导执行bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
核心操作:AI PPT 生成
bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>"
参数说明:
| 参数 | 说明 |
|---|---|
| 第1参数(用户query) | 严格使用用户的原始输入,不做任何加工或改写 |
| title(标题) | Agent 从用户 query 中提取或生成一个简短精炼的 PPT 标题 |
| page(页数) | 取值:1-10、11-20、21-30、31-40、40+(默认:11-20)。根据用户指定的页数选择最匹配的枚举值 |
| style(风格) | 取值:默认、创意趣味、年终总结、卡通手绘、扁平简约、文艺清新、中国风、企业商务、未来科技、文化艺术(默认:默认) |
| scene(场景) | 取值:默认、晚会表彰、传统节日、婚姻爱情、生日祝福、医学科普、建筑报告、工作总结、年终总结、工作汇报(默认:默认) |
| color(颜色) | 取值:默认、绿色、蓝色、紫色、橙色、黄色、红色、黑色、白色(默认:默认) |
智能选择规则: Agent 根据用户 query 自动生成 title,并判断最匹配的 page、style、scene、color 值。若无法明确判断,则使用默认值。title/page/style/scene/color 参数对用户不可见,Agent 静默选择后直接执行。
执行步骤:
- 将用户原始 query 作为第一参数,生成 title,智能匹配 page、style、scene、color(不向用户展示)
- 执行:
bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>" - 解析命令输出中的大纲:Agent 必须在思考过程(thinking)中完整记录并分析生成的 PPT 大纲内容,包括各章节标题和子标题的结构,以便用户通过查看思考过程了解 PPT 内容结构
- 向用户展示生成结果(文件名、预览链接、剩余次数),并且必须原样展示命令输出中的使用说明提示(tip)
- 原样展示规则:命令输出中
[DISPLAY_VERBATIM_START]和[DISPLAY_VERBATIM_END]之间的内容,必须作为引用块(blockquote>)完整原样展示给用户,禁止省略、改写、总结或翻译。示例输出格式:温馨提示:今日AI PPT 生成次数已经用完,明日 0 点后会自动刷新额度。如有大量生成PPT需求,可以通过官网联系我们。官网地址:https://pan.baidu.com/union/home
- 如果命令输出中包含更新提示,原样展示给用户(无输出则跳过)
确认规则:
- 用户提供了主题描述 → 直接执行
技能升级
用户回复"技能升级"时:
- 执行
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --yes - 展示更新结果
- 提示用户重新打开技能体验新版本
授权码处理
用户发送 32 位十六进制字符串时,先确认:"这是百度网盘授权码吗?确认后将执行登录流程。" 确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh(不使用 --yes,保留安全确认环节)。
管理功能
安装
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]
登录 / 注销
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh # 登录(内置安全免责声明)
bdpan logout # 注销
卸载
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes] # 卸载
更新(必须用户明确指令触发)
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh # 检查并更新(需用户确认)
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check # 仅检查更新
参考文档
遇到对应问题时按需查阅,无需预加载:
| 文档 | 何时查阅 |
|---|---|
| aippt-examples.md | AI PPT 生成使用示例和智能匹配参考 |
| authentication.md | 认证流程细节、Token 管理 |
| troubleshooting.md | 遇到错误需要排查 |