小云雀短剧

要解决什么问题

短剧创作链路很长：从剧本、风格、场景与角色图，到分镜和最终合成视频，中间还有大量表单确认与产物文件。若只靠聊天里贴链接，Agent 很难稳定地完成「提交任务 → 跟进后端状态 → 把剧本设计、场景图、分集草稿、故事板、成片等资产落到本地」。本技能把用户侧 Agent 约束为传话与取文件角色：用 pippit-tool-cli short-drama 对接小云雀后端，而不是在本地代写剧情。

技能如何工作

核心能力可以概括为五条 CLI 路径：

• +submit-run：用 --message 发送用户原始需求；可选 --asset-ids 绑定已上传的剧本参考文件；返回 thread_id、run_id 与 web_thread_link。
• get-thread：按 thread_id（及可选 run_id）拉取 v2 readable_text，展示进展、提问与结果。
• +upload-file：上传本地 .doc / .docx / .txt，得到 asset_id；同一 thread_id 会话只绑定一个剧本文件。
• list-thread-file：列出会话产物元信息（含 file_path、download_url），与查进展同等重要。
• download-result：对重要资产立即按 URL 下载到本地路径；存在性由下载工具内部处理。

提交 Run 后应并行轮询 get-thread 与 list-thread-file（建议约 10 秒间隔）；后端若抛出表单或问卷，需按固定主流程（剧本 → 合并确认 → 分析 → 风格 → 场景图 → 角色图 → 分镜 → 视频）清洗选项，避免跳过必要阶段，并优先用宿主提供的结构化提问工具；涉及 credits 的生成步骤须征得明确确认。拿到 web_thread_link 后，在宿主支持时优先打开小云雀 WebUI 供视觉 review，CLI 轮询与下载不因此省略。

适用边界与注意点

• 需已安装 pippit-tool-cli；部分能力依赖 XYQ_ACCESS_KEY，缺失时须用户先在剪映小云雀侧创建 Access Key 后再继续。
• 用户侧不要扩写 prompt、自编分集大纲或把自写内容混入后端结果；创作与流程编排由后端 Agent 负责。
• 任务完成不以 readable_text 停更为准：须分页拉全文件列表，并对带 download_url 的重要资产完成本地下载或说明重试后仍失败的项。