video-shortform

短视频技能

短视频（≤ 10s）是当前文生视频模型的最佳应用场景—— 它们擅长用一个镜头表达一个想法，但不擅长多镜头剪辑 叙事。每次调用规划一个镜头。

特殊情况：hyperframes-html 不是写实文生视频 模型，而是本地 HTML 转 MP4 渲染器。对于该模型，不要扮演 电影摄影师，也不要模拟“真实世界”的摄像机物理效果。将需求 视为动态设计卡片／标题画面／产品过场，最多提出一个 澄清问题，然后立即开始生成。

资源映射

video-shortform/
├── SKILL.md
└── example.html

工作流

步骤 0 — 读取项目元数据

videoModel、videoLength（秒）、videoAspect。这些是 硬性限制——将提示词限制在所选模型支持的范围内 （Seedance 2 上限为 10s；Kling 4 支持最长 10s 和图生视频； Veo 3 支持 8s 并带音频）。

步骤 1 — 规划镜头

调用模型前先写好镜头列表：

项目	内容
主体	画面中有什么？
摄像机	固定／摇摄／推进／环绕？
光线	主光方向和色温
动作	什么在动，节奏如何？主体运动还是摄像机运动？
声音	环境音底？（仅当模型支持音频时）

通常，在开始生成前，用一句话向用户展示计划——这样他们可以 轻松调整。

对于 hyperframes-html，用户回答完需求表后，跳过额外的 生成前说明。将计划整合进实际生成提示词，并立即开始生成。

步骤 2 — 编写提示词

使用上游模型偏好的格式（Seedance：运动 + 摄像机 + 氛围；Kling：主体 + 摄像机 + 风格；Veo：主体 + 电影摄影 + 声音）。将项目的 videoAspect 和 videoLength 直接绑定到 API 参数中；不要将它们写进正文。

对于 hyperframes-html，应编写简洁的动态设计需求，而不是 强调摄像机真实感的提示词。聚焦主体、布局、配色、动态 特征和整体基调。不要花时间描述环境检查、缺失的旁置文件 或“我即将开始生成”之类的状态更新。

步骤 3 — 通过媒体契约开始生成

使用统一分发器——不要手动调用服务商 API：

node "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface video \
  --model "<videoModel from metadata>" \
  --aspect "<videoAspect from metadata>" \
  --length <videoLength seconds> \
  --output "<short-slug>-<seconds>s.mp4" \
  --prompt "<assembled shot prompt from Step 2>"

该命令会输出一行 JSON：{"file": {"name": "...", ...}}。 文件会写入项目；FileViewer 会自动播放。

步骤 4 — 交付

回复中包含：镜头概要、分发器返回的文件名，以及一句说明用户 想要不同版本时可以尝试什么。

对于 hyperframes-html，回复要尤其简短：渲染内容、文件名， 以及一个具体的变体创意。

硬性规则

• 每轮只生成一个镜头。多镜头时间线应使用 hyperframes／ 交互式视频技能，而非此技能。
• 严格匹配 videoAspect——重新渲染很慢。
• 视频必须保存到文件后才能交付——用户期望能在文件查看器中 播放。
• 底层模型失败时（NSFW 过滤器、内容政策、超时），逐字报告 错误。不要悄悄重试。
• 尚未调用 od media generate 时，不要声称渲染已“发送”、 “开始”或“正在运行”。