Comic Drama Generate

使用此技能，通过确定性、角色一致的流水线生成短篇漫剧（comic-drama）剧集。

必需的前置技能

使用本技能前，需先具备以下技能：

• video-prompt-generator
• nano-banana-pro
• sora-2-generate

若任一技能缺失，请先安装。安装方式如下：

npx clawhub@latest install video-prompt-generator
npx clawhub@latest install nano-banana-pro
npx clawhub@latest install sora-2-generate

开始制作前，请确认以下事项均已满足：

• 上述三项前置技能的文件夹均存在
• 前置技能所需的 API 凭据已正确配置
• 本地环境已安装并可调用 ffmpeg
• 脚本生成、图像生成与视频生成均有充足的信用额度（credit）或配额（quota）

关于凭据的重要说明：

• comic-drama-generate 仅负责编排其他技能，自身不引入独立的 API 密钥。
• 各前置技能通过其约定的环境变量获取凭据，通常为 NANOPHOTO_API_KEY。
• 优先采用标准子技能执行方式，即依赖前置技能已配置好的环境变量。
• 如确需直接运行脚本，请确保当前 shell 中已设置 NANOPHOTO_API_KEY，以维持相同的环境变量契约。
• 仅当 shell 无法继承预期环境变量时，才作为兜底方案显式传入 --api-key 参数。
• 请勿将直接读取配置文件（如 openclaw.json）视为主流程；该方式仅限调试或恢复场景使用。

强制执行的制作顺序

必须严格遵循以下顺序执行。

1. 首先向用户确认风格

   • 在任何内容生成前，须先征询用户对视觉风格的偏好。
   • 同时确认剧集基调、目标受众、总集数、发布平台、画面宽高比及单集大致时长。
   • 首要锁定“系列设定集”（series bible）：包括故事前提（premise）、角色名单（roster）、风格关键词（style keywords）及制作约束条件（production constraints）。

2. 使用 video-prompt-generator 构建剧本基础

   • 生成故事前提、戏剧性叙事弧线（dramatic arc）、单集情节节点（episode beats）及分场写作基础。
   • 确保剧集结构适配短格式连载漫剧（short-form serialized 漫剧）的节奏与体量。
   • 保持整体节奏与下游 15 秒单镜头生成能力兼容。

3. 使用 nano-banana-pro 生成角色三视图（turnarounds）

   • 为所有核心常驻角色生成标准三视图（正面、侧面、背面）素材。
   • 将三视图作为角色身份的权威依据，涵盖面部特征、发型、剪影轮廓、服饰搭配与配色方案（palette）。
   • 当角色一致性至关重要时，严禁跳过此步骤。

4. 使用 nano-banana-pro 生成关键帧（keyframes）

   • 基于三视图图片 URL 作为参考输入，为每个预设镜头生成关键帧。
   • 多人物同框镜头中，需包含所有相关角色的三视图 URL。
   • 利用关键帧锁定构图、服装连贯性、环境提示信息及情绪化舞台调度（emotional staging）。

5. 使用 video-prompt-generator 编写分镜脚本 / 镜头脚本

   • 将每集内容转化为镜头级提示词（shot-level prompts）与镜头清单（shot list）。
   • 编写时应面向单镜头生成，确保与视频提示词（video prompts）无缝衔接。
   • 每集结尾须预留钩子（hook）。

6. 使用 sora-2-generate 生成 15 秒单镜头视频

   • 默认采用 15 秒镜头；仅当用户明确要求其他受支持时长时，方可调整。
   • 人物主导镜头优先使用 imageToVideo 模式。
   • 将关键帧 URL 作为图像输入参数传入。
   • 仅在人物一致性无关紧要的镜头中（如氛围空镜、环境转场）使用 textToVideo 模式。

7. 使用本地 ffmpeg 进行剪辑、排序与合成

   • 将每个完成的镜头下载并本地保存。
   • 如有需要，可在本地对镜头进行裁剪或标准化处理。
   • 按确定性顺序，使用 ffmpeg 合成全部镜头。
   • 最终成片导出至独立的项目目录下。

不可协商的工作准则

• 始终优先遵循以下一致性链条：
  • 角色三视图 → 关键帧 → 图像转视频（image-to-video）
• 在以下环节间传递资产时，必须使用 公开 URL，禁止使用本地文件路径：
  • 角色三视图 → 关键帧
  • 关键帧 → 视频生成
• 在上述交接环节中，严禁将本地文件直接传入 nano-banana-pro 或 sora-2-generate 的 API。
• 严禁跳过三视图与关键帧环节，直接由文本提示生成主角镜头视频——除非用户明确接受一致性下降的风险。
• 务必在项目文档中精确记录三视图与关键帧的 URL，因下游生成环节高度依赖这些链接。
• 若受模型时长限制、配额不足或速率限制影响，导致原定时间规划不可行，须在生成前重写分镜时间节点（storyboard timing）。

剧情与节奏指导原则

• 镜头设计须围绕当前所用视频模型支持的输出时长展开。
• 本工作流推荐采用适配 15 秒单镜头的“镜头语法”（shot grammar）。
• 若单集所需时长超出单镜头容量，应拆分为更多镜头，而非强行在单个提示中堆砌内容。
• 确保每集结尾包含钩子（hook）、揭示（reveal）、反转（reversal）、疑问（question）或情绪化断点（emotional cliffhanger）。

推荐的项目结构

project/
  docs/
    series-bible.md
    episodes.md
    shot-list.md
    asset-urls.md
  assets/
    characters/
    keyframes/
  shots/
    ep01/
    ep02/
  edits/
  final/

执行注意事项

• 必要时，可两次调用 video-prompt-generator：
  • 首次用于构建前提与剧集内容
  • 第二次用于细化镜头级提示词
• nano-banana-pro 用于两类任务：
  • 角色三视图生成
  • 关键帧生成
• sora-2-generate 主要以 imageToVideo 模式处理以角色为核心的镜头。
• 最终剪辑组装工作必须使用本地 ffmpeg 完成，不得依赖远程编辑工具。

预期交付成果

产出结构清晰、便于后续恢复工作的成果：

• docs/series-bible.md —— 故事前提、视觉风格、角色设定、世界观规则
• docs/episodes.md —— 各集剧情摘要及结尾钩子设计
• docs/shot-list.md —— 每集镜头级结构明细
• docs/asset-urls.md —— 三视图 URL、关键帧 URL 与视频 URL 清单
• shots/ 目录下的本地镜头文件
• edits/ 目录下的本地剪辑中间产物
• final/ 目录下的最终剧集成片

必要时请查阅以下参考资料

• references/workflow.md —— 端到端制作工作流
• references/install-checklist.md —— 前置技能验证与安装检查清单
• references/asset-rules.md —— 角色三视图、关键帧与图像转视频的一致性规范