Skill: sky-lv/ai-slide-generator (version 1.0.0)

--- name: aippt description: "当用户明确要求使用 AI 智能设计生成 PPT 演示文稿时使用本技能（智绘高迪/AIPPT）。本技能调用远程 Design Agent API，根据文字描述自动生成专业 PPT 演示文稿，支持指定模板和自定义模型。当用户说'AI生成PPT'、'智绘PPT'、'自动生成演示文稿'、'帮我做个PPT'时触发。注意：本技能仅用于生成全新的 PPT，不用于读取、解析或编辑已有的 .pptx 文件——编辑已有文件请使用 pptx 技能。" --- # AIPPT Skill — AI 智能 PPT 生成 通过智绘高迪 Design Agent API，根据用户的文字描述自动生成专业 PPT。 ## 使用方式 > **Windows 用户**：所有 `bash` 命令请替换为对应的 `powershell -ExecutionPolicy Bypass -File` 版本，详见下方双版本示例。 > Windows 下使用 `python` 而非 `python3`。 ### ⚠️ 调用前必须输出提示（MANDATORY） **在执行脚本之前**，必须先向用户输出以下温馨提示： ```markdown > 💡 **温馨提示** > PPT 后台生成过程会持续消耗积分；如需终止任务，请点击下方链接进入智绘高迪平台操作。每张PPT平均消耗约0.5积分。 ``` ### 生成 PPT **macOS / Linux：** ```bash # 用法 — 只需 prompt PROMPT="制作一个关于人工智能发展趋势的商业演示" bash __SKILL_DIR__/scripts/generate.sh ``` **Windows (PowerShell)：** ```powershell # 用法 — 只需 prompt $env:PROMPT="制作一个关于人工智能发展趋势的商业演示"; chcp 65001 >nul; powershell -ExecutionPolicy Bypass -File "__SKILL_DIR__/scripts/generate.ps1" ``` ### 参数说明 | 环境变量 | 必填 | 说明 | |----------|------|------| | `PROMPT` | ✅ | PPT 内容描述，越详细越好 | ### 输出格式 脚本调用 Gateway 代理，Gateway 等待智绘 API 返回 `started` 事件后立即返回 JSON 结果： ``` 📝 开始生成 PPT... 🚀 任务已启动，PPT 正在后台生成中 ✅ PPT 生成任务已提交！ 结果： { "projectId": "69def187a7e1519b00d4708e", "workspaceUrl": "https://goatdee.qq.com/ppt/69def187a7e1519b00d4708e", "message": "PPT 任务已启动，正在后台生成中。你可以通过以下链接查看和编辑：..." } 📊 编辑地址: https://goatdee.qq.com/ppt/69def187a7e1519b00d4708e ``` ### 结果展示 将生成结果以 Markdown 格式展示给用户： ```markdown ✅ **PPT 生成任务已提交！** PPT 正在后台生成中，预计需要 5-15 分钟。 📊 **在线编辑地址**: [点击打开智绘高迪](https://goatdee.qq.com/ppt/{projectId}) 你可以点击链接查看生成进度，完成后直接在编辑器中修改。如需终止任务，也请在该页面中操作。 ``` ## 工作原理 1. Skill 脚本发送 POST 请求到 Auth Gateway 的 `/proxy/aippt/agent/run` 2. Gateway 注入模型凭证，转发到智绘高迪 Design Agent API（SSE 协议） 3. Gateway 等待上游返回 `started` 事件，提取 `projectId` 拼接编辑地址 4. Gateway 立即返回 JSON 结果给脚本，**不等待 PPT 生成完成** 5. PPT 在后台异步生成，用户通过编辑地址查看进度和结果 ## ⚠️ 编码要求（MANDATORY） **所有传递给接口的数据必须确保是 UTF-8 编码。** 这是强制要求，违反将导致服务端收到乱码。 - `PROMPT` 环境变量中的中文内容必须是 UTF-8 编码 - Windows 下必须在脚本执行前通过 `chcp 65001` 切换控制台代码页为 UTF-8 - HTTP 请求 body 必须以 UTF-8 编码发送，Content-Type 必须声明 `charset=utf-8` - **禁止**使用系统默认编码（如 GBK/GB2312）传递任何包含非 ASCII 字符的数据 ## ⚠️ 输出链接地址的严格规则（MANDATORY） **展示给用户的编辑地址必须严格使用完整的 URL 前缀，一个字母都不能少：** ``` https://goatdee.qq.com/ppt/{projectId} ``` - 基础域名路径为 `https://goatdee.qq.com/ppt/`，后接 `projectId` - ❌ 绝对禁止：输出为 `/pt/xxx`、`/pp/xxx`、`goatdee.qq.com/pt/xxx` 或任何缺少字母的变体 - ✅ 唯一正确格式：`https://goatdee.qq.com/ppt/{projectId}` - 请直接使用脚本返回的 `workspaceUrl` 字段值，不要自行拼接或截断 ## ⚠️ 关于页数的严格规则（MANDATORY） **除非用户在描述中明确指定了页数（如"生成10页PPT"、"做一个5页的演示"），否则绝对不要在 PROMPT 中自行添加、编造或暗示任何页数相关的内容。** - ❌ 错误做法：用户说"帮我做个关于AI的PPT"，你在 PROMPT 里写"生成一个15页的AI主题PPT" - ✅ 正确做法：用户说"帮我做个关于AI的PPT"，PROMPT 直接写"制作一个关于AI的演示文稿"，不提及页数 - ✅ 正确做法：用户说"帮我做一个8页的AI PPT"，PROMPT 写"制作一个8页的关于AI的演示文稿" 页数由智绘高迪平台根据内容自动决定，不需要你来指定。擅自添加页数要求可能导致生成效果不符合预期。 ## 注意事项 1. 该 skill 调用远程 API，需要网络连接 2. Gateway 只等待 `started` 事件（通常几秒），不会因 PPT 生成耗时而超时 3. PPT 生成过程在后台进行，可能需要 5-15 分钟 4. 如果用户需要**编辑已有的 .pptx 文件**，请使用 `pptx` skill 而非本 skill 5. 如果 API 返回错误，检查网络连接并提示用户稍后重试 ## 依赖 | 依赖 | macOS / Linux | Windows | |------|--------------|---------| | HTTP 请求 | `curl`（系统自带） | PowerShell `Invoke-RestMethod`（内置） | | JSON 解析 | `python3`（系统自带） | PowerShell `ConvertFrom-Json`（内置） |


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)