共享生成策略

在执行任何付费的 POST /v1/predictions 请求之前：

1. 随机种子仪式 —— 始终为第一步；通过求和取模（sum-mod）推导各轴向参数。
2. 生成多样性 —— 使用显式提示词；每会话至少轮换 ≥2 个场景轴向维度。
3. 质量检查清单 —— 打开输出文件并人工判定通过/失败，再进入下一阶段。
4. 分阶段生成门控 —— 流程严格按：规划 → 静帧 → 音频 → 视频 → 合成；单次执行中不得跳过任一阶段。
5. 审批红标预警 —— 若规划、静帧或片段未被审阅，则必须暂停流程。
6. 工作流反馈门控 —— 由 runner 标记状态，并支持按工作流下发指令。
7. 并行执行 —— 仅在每个已获批准的阶段内部允许异步扇出（async fan-out）。

图解故事短片（Illustrated story reel）

依次生成的 p-image / p-image-edit 静帧，使用 ffmpeg 组装为视频，叠加细腻的 Ken Burns 运动效果，并与 旁白（Gemini TTS）或 纯音乐（Stable Audio 或用户指定音轨）精准同步。不使用 p-video。

交付格式不限于竖版短片。请将 defaults.aspect_ratio 设为：9:16（适用于 Stories/Reels/TikTok）、16:9（适用于 YouTube、演示文稿、落地页首屏）或 1:1（信息流方形图）。runner 将按所选比例以 1080p 渲染；默认输出文件名为 story_reel.mp4；若交付物为横版，可通过 --output-name 覆盖（例如：story_slideshow.mp4）。

该模式适用于社交平台故事帖、童话式讲解、情绪短片、横版图文叙事、产品发布预热，以及“动态插画”类内容形式。

概述

每个故事节拍（beat）对应一张静帧。以主视觉锚点（hero anchor）起始 → 每个场景使用 p-image-edit 生成。旁白模式下，音频驱动时间节奏；音乐模式下，每个节拍固定持续 hold_seconds；合成环节仅依赖本地 ffmpeg。

适用场景

• 无需 AI 视频生成的图解故事
• 配有语音旁白（VO）或背景音乐（bed）的绘本/漫画格叙事
• 用户明确提及“幻灯片故事”、“Ken Burns 短片”或“仅静帧社交帖”
• 预算敏感型任务（仅调用图像 API，不消耗视频 API 配额）

不适用场景：两幅静帧之间的视觉过渡动画（visual-transition-reel）、唇形同步虚拟形象（interactive-explainer）、完整演唱型音乐视频（music-video）。

安全与作用域

仅限静帧幻灯片 —— 不含任何 p-video* 调用。所有内嵌参考均限定于本工作流；请勿参照其他技能中的视频/虚拟形象示例。

前置依赖：api-credentials.md · 权限声明： skill.manifest.json

反馈门控

illustrated-story-reel-gates.md

默认 runner 启动参数为 --phase stills。

速查表

输入采集 —— 生成前必问

首要问题（必需）：

1. 交付构图 —— 竖版短片（9:16）、横版幻灯片（16:9）还是方形（1:1）？
2. 音频类型 —— 旁白（每节拍配一句 VO）或 音乐（纯器乐铺底 / 用户自选音轨）？

请在生成前于 plan 中设定 defaults.aspect_ratio 和 audio_mode；同时确保 hero_prompt 的措辞与比例匹配（例如横版应写为 “16:9 horizontal frame”）。

节拍表未完成撰写且 audio_mode 未确认前，严禁启动生成流程。

节拍表（模板）

工作流

# 阶段 A —— 仅生成静帧
python3 workflows/illustrated-story-reel/scripts/run_from_plan.py 
  --plan output/.../plan.json --out-dir output/.../ --phase stills

# 阶段 A2 —— 生成旁白 OR 音乐（依据 plan 中的 audio_mode）
python3 ... --approve-stills --phase tts    # 旁白模式
python3 ... --approve-stills --phase music   # 音乐模式

# 阶段 C —— Ken Burns 动效 + 音视频合成
python3 ... --approve-audio --phase assemble

# 横版示例（plan.json 中 defaults 为 16:9）
python3 ... --approve-audio --phase assemble --output-name story_slideshow.mp4

常见错误

相关技能

• 静帧批量处理：stills_pipeline.py
• 带旁白的视频影片：narrated-multi-scene
• 静帧间运动过渡：visual-transition-reel
• 工具模型：p-image、p-image-edit