基于 Felo PPT Task API 自动生成专业演示文稿，支持主题定制、任务轮询与断点续传，适合快速将大纲转化为可分享 PPT。
说明：
## 核心用法
`felo-slides` 是 Claude Code 生态中专用于生成 PPT/Slides 的技能，底层对接 Felo PPT Task API（v2）。用户通过自然语言或显式命令（如 `/felo-slides`）触发后，系统自动完成 API Key 校验、任务创建、状态轮询及结果输出全流程。
**执行流程**：
1. **预检**：验证 `FELO_API_KEY` 环境变量，缺失则终止并返回配置指引；
2. **任务创建**：调用 `POST /v2/ppts` 提交用户 prompt，可选 `ppt_config.ai_theme_id` 指定主题；
3. **轮询追踪**：通过 `GET /v2/tasks/{task_id}/historical` 每 10 秒查询状态，最大等待 30 分钟；
4. **结果交付**：终端状态为 `COMPLETED`/`SUCCESS` 时输出 `ppt_url`（或 `live_doc_url` 兜底），失败则返回错误码与建议操作。
**特色功能**：
– **主题系统**：先执行 `felo ppt-themes` 列出可用主题，再通过 `–theme` 参数应用；
– **断点续传**：超时或中断后可用 `–task-id` 恢复轮询，避免重复创建；
– **结构化调试**：`–json –verbose` 输出完整元数据（task_id、status、livedoc_short_id 等）。
## 显著优点
– **端到端自动化**：单命令完成”Prompt → PPT 链接”，无需人工介入 API 调用链；
– **容错设计**：区分临时超时与终态失败，支持任务级重试而非重复提交；
– **零依赖脚本**：Node.js 单文件实现，不依赖 `jq` 等外部工具，跨平台兼容；
– **双输出保障**：主链路返回 `ppt_url`，失败时自动降级 `live_doc_url`，确保可用性。
## 潜在缺点与局限性
– **外部 API 依赖**：全流程受 Felo 服务端稳定性制约，502/下游故障会导致 `PPT_TASK_CREATE_FAILED`；
– **异步延迟**：生成耗时随页数与复杂度增长，30 分钟上限可能不足以处理超长 deck；
– **主题前置依赖**：主题 ID 需额外查询，非所见即所得，增加一步交互成本；
– **内容可控性有限**：AI 生成大纲后自动排版，对单页细节（动画、图表样式）干预能力弱。
## 适合人群
– 需快速将文字大纲、会议纪要转化为标准 PPT 的知识工作者；
– 追求”一句话生成幻灯片”效率、对设计细节要求不高的商务/教育场景用户；
– 已有 Felo 账号并愿意配置 API Key 的 Claude Code 深度用户。
## 常规风险
– **API Key 泄露**：`FELO_API_KEY` 以环境变量形式存在，多用户共享终端时有暴露风险，建议配合 secret manager；
– **内容合规性**：AI 生成内容可能含版权素材或事实错误，商用前需人工审核；
– **服务连续性**：Felo 平台策略变更（定价、速率限制、API 下线）可能导致技能突然不可用，需关注官方公告。
会员专属
