核心用法
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 下线）可能导致技能突然不可用，需关注官方公告。