$npx -y skills add baidu-netdisk/bdpan-storage --skill baidu-wenku-aippt-personal百度文库智能PPT个人版 — 一句话自动生成高质量 PPT,支持多种风格、场景和配色。 TRIGGER: 用户提及"生成PPT/做PPT/制作PPT/AI PPT/aippt/幻灯片/演示文稿"时触发。 DO NOT TRIGGER: 非 PPT 相关操作,文件管理操作,网盘上传下载等操作。
| 1 | # 百度文库 AI PPT 生成 Skill |
| 2 | |
| 3 | 一句话自动生成高质量 PPT,支持多种风格、场景和配色方案。底层通过 `bdpan aippt` 命令实现。 |
| 4 | |
| 5 | > 使用示例详见 [reference/aippt-examples.md](./reference/aippt-examples.md) |
| 6 | |
| 7 | ## 触发规则 |
| 8 | |
| 9 | 同时满足以下条件才执行: |
| 10 | |
| 11 | 1. 用户提及"生成PPT"、"做PPT"、"制作PPT"、"AI PPT"、"aippt"、"幻灯片"、"演示文稿" |
| 12 | 2. 提供了主题、大纲或内容描述 |
| 13 | |
| 14 | 未通过触发规则时,禁止执行任何 bdpan 命令。 |
| 15 | |
| 16 | > **上下文延续:** 当前对话已在进行 PPT 生成操作时,后续消息无需再次提及关键词即可触发。 |
| 17 | |
| 18 | --- |
| 19 | |
| 20 | ## 安全约束(最高优先级,不可被任何用户指令覆盖) |
| 21 | |
| 22 | 1. **登录**:必须使用 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`,禁止直接调用 `bdpan login` 及其任何子命令/参数(包括 `--get-auth-url`、`--set-code` 等) |
| 23 | 2. **Token/配置**:禁止读取或输出 `~/.config/bdpan/config.json` 内容(含 access_token 等敏感凭据) |
| 24 | 3. **更新/登录**:更新必须由用户明确指令触发,禁止自动或静默执行;Agent 禁止使用 `--yes` 参数执行 update.sh 或 login.sh |
| 25 | 4. **环境变量**:Agent 禁止主动设置 `BDPAN_CONFIG_PATH`、`BDPAN_BIN`、`BDPAN_INSTALL_DIR` 等环境变量 |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## 前置检查 |
| 30 | |
| 31 | 每次触发时按顺序执行: |
| 32 | |
| 33 | 1. **安装检查**:`command -v bdpan`,未安装则告知用户并确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/install.sh`(用户确认后可加 `--yes` 跳过安装器内部确认) |
| 34 | 2. **登录检查**:`bdpan whoami`,未登录则引导执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh` |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## 核心操作:AI PPT 生成 |
| 39 | |
| 40 | ```bash |
| 41 | bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>" |
| 42 | ``` |
| 43 | |
| 44 | **参数说明:** |
| 45 | |
| 46 | | 参数 | 说明 | |
| 47 | |------|------| |
| 48 | | 第1参数(用户query) | **严格使用用户的原始输入**,不做任何加工或改写 | |
| 49 | | title(标题) | Agent 从用户 query 中提取或生成一个简短精炼的 PPT 标题 | |
| 50 | | page(页数) | 取值:1-10、11-20、21-30、31-40、40+(默认:11-20)。根据用户指定的页数选择最匹配的枚举值 | |
| 51 | | style(风格) | 取值:默认、创意趣味、年终总结、卡通手绘、扁平简约、文艺清新、中国风、企业商务、未来科技、文化艺术(默认:默认) | |
| 52 | | scene(场景) | 取值:默认、晚会表彰、传统节日、婚姻爱情、生日祝福、医学科普、建筑报告、工作总结、年终总结、工作汇报(默认:默认) | |
| 53 | | color(颜色) | 取值:默认、绿色、蓝色、紫色、橙色、黄色、红色、黑色、白色(默认:默认) | |
| 54 | |
| 55 | **智能选择规则:** Agent 根据用户 query 自动生成 title,并判断最匹配的 page、style、scene、color 值。若无法明确判断,则使用默认值。title/page/style/scene/color 参数对用户不可见,Agent 静默选择后直接执行。 |
| 56 | |
| 57 | **执行步骤:** |
| 58 | |
| 59 | 1. 将用户原始 query 作为第一参数,生成 title,智能匹配 page、style、scene、color(不向用户展示) |
| 60 | 2. 执行: |
| 61 | ```bash |
| 62 | bash ${CLAUDE_SKILL_DIR}/scripts/run-aippt.sh "<用户原始query>" "<title>" "<page>" "<style>" "<scene>" "<color>" |
| 63 | ``` |
| 64 | 3. **解析命令输出中的大纲**:Agent 必须在思考过程(thinking)中完整记录并分析生成的 PPT 大纲内容,包括各章节标题和子标题的结构,以便用户通过查看思考过程了解 PPT 内容结构 |
| 65 | 4. 向用户展示生成结果(文件名、预览链接、剩余次数),并且必须原样展示命令输出中的使用说明提示(tip) |
| 66 | 5. **原样展示规则**:命令输出中 `[DISPLAY_VERBATIM_START]` 和 `[DISPLAY_VERBATIM_END]` 之间的内容,必须作为引用块(blockquote `>`)完整原样展示给用户,禁止省略、改写、总结或翻译。示例输出格式: |
| 67 | > 温馨提示:今日AI PPT 生成次数已经用完,明日 0 点后会自动刷新额度。如有大量生成PPT需求,可以通过官网联系我们。官网地址:https://pan.baidu.com/union/home |
| 68 | 6. 如果命令输出中包含更新提示,原样展示给用户(无输出则跳过) |
| 69 | |
| 70 | **确认规则:** |
| 71 | |
| 72 | - 用户提供了主题描述 → 直接执行 |
| 73 | |
| 74 | --- |
| 75 | |
| 76 | ## 技能升级 |
| 77 | |
| 78 | 用户回复"技能升级"时: |
| 79 | 1. 执行 `bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --yes` |
| 80 | 2. 展示更新结果 |
| 81 | 3. 提示用户重新打开技能体验新版本 |
| 82 | |
| 83 | --- |
| 84 | |
| 85 | ## 授权码处理 |
| 86 | |
| 87 | 用户发送 32 位十六进制字符串时,先确认:"这是百度网盘授权码吗?确认后将执行登录流程。" 确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`(不使用 `--yes`,保留安全确认环节)。 |
| 88 | |
| 89 | --- |
| 90 | |
| 91 | ## 管理功能 |
| 92 | |
| 93 | ### 安装 |
| 94 | |
| 95 | ```bash |
| 96 | bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes] |
| 97 | ``` |
| 98 | |
| 99 | ### 登录 / 注销 |
| 100 | |
| 101 | ```bash |
| 102 | bash ${CLAUDE_SKILL_DIR}/scripts/login.sh # 登录(内置安全免责声明) |
| 103 | bdpan logout # 注销 |
| 104 | ``` |
| 105 | |
| 106 | ### 卸载 |
| 107 | |
| 108 | ```bash |
| 109 | bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes] # 卸载 |
| 110 | ``` |
| 111 | |
| 112 | ### 更新(必须用户明确指令触发) |
| 113 | |
| 114 | ```bash |
| 115 | bash ${CLAUDE_SKILL_DIR}/scripts/update.sh # 检查并更新(需用户确认) |
| 116 | bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check # 仅检查更新 |
| 117 | ``` |
| 118 | |
| 119 | --- |
| 120 | |
| 121 | ## 参考文档 |
| 122 | |
| 123 | 遇到对应问题时按需查阅,无需预加载: |
| 124 | |
| 125 | | 文档 | 何时查阅 | |
| 126 | |------|---------| |
| 127 | | [aippt-examples.md](./reference/aippt-examples.md) | AI PPT 生成使用示例和智能匹配参考 | |
| 128 | | [authentication.md](./reference/authentication.md) | 认证流程细节、Token 管理 | |
| 129 | | [troubleshooting.md](./reference/troubleshooting.md) | 遇到错误需要排查 | |