product-video

产品视频

将产品和目标转化为完整的产品视频制作规格——选定一个视频概念、按节拍划分并标注时长的镜头清单、动画与节奏方案，以及可直接用于生成的关键帧提示词。核心原则：**一个视频只传达一件事。**每个节拍都必须推进这条唯一的信息（揭晓、优势或转变），否则就删掉。你负责产出方案和关键帧；动态画面的渲染在后续环节完成。

何时使用 / 何时不使用

• 适用于以产品为核心的动态内容：产品揭晓、功能展示、产品使用场景、状态转变、360 度旋转。
• 如果视频以人物为主（主持人、用户评价、UGC）→ 使用 skills/creative/talking-head。
• 如果视频将通过 Remotion 以编程方式渲染（UI 演示、代码教程、数据可视化）→ 使用 skills/creative/remotion-script-writer；你仍可先运行此技能来确定概念和节拍，再将节拍表交给后续环节。
• 如果用户需要静态素材（帖子、横幅）→ 使用 skills/creative/social-graphics。
• 如果尚无品牌风格指南，且用户重视品牌一致性 → 先运行 skills/creative/creative-strategist；其风格指南可供此技能使用。

信息收集

只询问缺少的信息，并一次性简洁地提出：

1. 产品 — 产品是什么？视频必须传达的唯一信息是什么（新品发布？某项功能？某种优势？前后对比？）
2. 发布平台 — TikTok/Reels/Shorts、产品页面、YouTube 前贴片广告、展会循环播放？（这决定画幅比例、时长和节奏。）
3. 希望观众接下来做什么 — 行动号召（CTA）。
4. 品牌风格 — 是否有 skills/creative/creative-strategist 风格指南或可供参考的现有品牌素材？

根据上下文推断，而不是提问：根据平台推断画幅比例，根据产品类别推断氛围，根据项目中现有品牌材料推断风格。**不要停下来等待：**如果产品和目标已明确，就说明其余部分的假设（“假设用于 Reels，时长 12 秒，竖屏，活力十足——如有不同请告知”），然后继续。

工作流程

1. 选择视频类型（决策规则，而非选项列表）

如果要传达的信息是……	类型	时长	节拍结构
“它已经存在 / 它是新品”	揭晓	5–15 秒	隐藏/遮挡 → 揭晓动画（淡入、滑入、旋转）→ 主视觉镜头
“它有这些功能”	功能展示	15–30 秒	突出功能 1 → 功能 2 → 功能 3 → 完整产品
“看看使用时的优势”	实际使用	10–20 秒	产品置于环境中 → 产品被使用 → 展示效果
“看看发生了什么变化”	状态转变	10–15 秒	转变前状态 → 形变 → 转变后状态
“只展示产品” （电商、商品列表）	360 度旋转	5–10 秒	在干净背景上连续平滑旋转

确定一种类型，并用一句话说明理由。只有在确实有两种类型都适用时，才提供一个备选方案。展示的功能绝不超过 4 个——保留最有力的功能。

2. 根据平台设定节奏

• 快（5–10 秒，快速利落的剪辑）：社交信息流、广告及任何可跳过的内容。前 2 秒内吸引观众。
• 中（10–20 秒，平滑过渡）：产品页面、营销网站、邮件嵌入视频。
• 慢（20–30 秒，从容、优雅的镜头运动）：高端/奢侈品，讲故事的视频。只有当产品的价位足以让观众愿意耐心观看时，才选择慢节奏。

按展示位置选择画幅比例：9:16 竖屏（TikTok/Reels/Shorts/Stories）、16:9（YouTube、网页主视觉）、1:1 或 4:5（信息流帖子）。这些画幅比例可直接对应 CLI 中的 --aspect-ratio 值。

3. 选择一种动画风格

与品牌个性相匹配——恰好选择一种，并在每个关键帧提示词中原样使用其短语，以保持画面一致：

品牌感觉	风格	提示短语
优雅、沉静	Smooth Fade	"smooth fade transitions, gentle pacing, elegant"
现代、活力充沛	Dynamic Slide	"dynamic slide transitions, elements slide in, energetic pacing"
电影感、大胆	Zoom & Rotate	"zoom and rotate moves, dynamic pacing, cinematic"
精致、流畅	Morphing	"smooth morphing transitions, fluid animation, sophisticated"
高科技	Particle Effects	"particle effects, product materializes/dissolves, high-tech"

4. 编写节拍表

将时长拆分为 3–6 个节拍。每个节拍都要包含：时间范围、屏幕画面、镜头/运动，以及结束时的转场。每个节拍都必须推进同一条核心信息；最后一个节拍始终展示产品和 CTA，持续 ≥2 秒。

5. 编写关键帧提示词

每个节拍对应一个关键帧（变形过程需提供前后两个关键帧）。每条提示词 = 主体 + 该节拍中的状态 + 动画风格短语 + 光线 + 所有画面都一致的风格/光线描述（保持一致才能让画面看起来像同一段视频）。除非某个节拍明确切换场景，否则所有关键帧都使用相同的背景和光线描述。

如果已设置 FAL_API_KEY（或 FAL_KEY），现在就通过仓库 CLI 使用 docs/fal_api.py 生成关键帧，模型为 fal-ai/nano-banana-pro：

python docs/creative_cli.py custom \
  --category "video-keyframes" --name "beat-1-hero" \
  --prompt "<keyframe prompt>" --aspect-ratio 9:16 --resolution 2K

如果未设置密钥，请提供可直接运行的命令形式的提示词。注意：nano-banana-pro 只能生成静态关键帧——帧与帧之间的动态效果由后续流程生成（Remotion、视频生成工具或编辑器）。

6. 对照质量标准进行自检，然后交付规格。

必需的输出格式

始终按以下结构交付：

# Product Video Production Spec — [Product]

## Overview
- **Message (one sentence):** ...
- **Type:** Reveal | Feature Showcase | In Action | Transformation | 360 Spin — [one-line reason]
- **Platform / placement:** ... · **Aspect ratio:** ... · **Duration:** ...s · **Pacing:** Fast/Medium/Slow
- **Animation style:** [style + verbatim prompt phrase]
- **CTA:** ...

## Beat sheet
| # | Time | On screen | Camera / motion | Transition out |
|---|------|-----------|-----------------|----------------|
| 1 | 0–3s | ... | ... | ... |
| 2 | 3–7s | ... | ... | ... |
(final beat: product + CTA, held ≥2s)

## Keyframes
### KF-1 (beat 1) — [label]
> [full nano-banana-pro prompt]
`python docs/creative_cli.py custom --category "video-keyframes" --name "kf-1" --prompt "..." --aspect-ratio [ratio] --resolution 2K`
(repeat per beat; identical style/lighting descriptors across all)

## Audio direction
- Music: [genre/energy matched to pacing] · Sound design: [key moments] · VO: [none, or one line per beat]

## Production notes
- [render path: Remotion via skills/creative/remotion-script-writer / video gen tool / editor]
- [anything beat-specific: logo timing, text overlays, loop point for trade-show/spin videos]

质量标准（交付前检查）

• 只传达一条信息；如果无法用一句话表达，请从步骤 1 重新开始。
• Fast 节奏的钩子要在前 2 秒内出现；Medium 节奏则在 4 秒内出现。
• 节拍数为 3–6；每个节拍不得短于 1.5 秒；各段时间之和必须恰好等于所述时长。
• 每条关键帧提示词都必须包含相同的动画风格短语，以及相同的光线/背景描述（除非该节拍切换场景）——画面不一致是导致失败的首要原因。
• 提示词必须明确使用 “smooth”、“fluid” 等动态描述，不得含糊带过动态效果的质量。
• 最后一个节拍必须包含 CTA，并持续 ≥2 秒。
• 不要编造效果声明（例如“这种格式能提升 3 倍互动率”）——上述节奏/时长建议仅为经验法则，如用户询问，请标明这一点。

集成

• skills/creative/creative-strategist → 输入：所有关键帧提示词都必须遵循的风格指南（颜色、氛围、光线描述）。
• skills/creative/product-photography → 输入：可复用于视频主视觉帧、以保持一致性的现有主视觉照片提示词/布光方案。
• skills/creative/image-generation → 使用：关键帧提示词；当用户希望比 CLI 单行命令更精细地控制生成过程时使用。
• skills/creative/remotion-script-writer → 使用：节拍表 + 关键帧；适用于通过 Remotion 组合渲染视频的情况。
• skills/creative/social-graphics → 使用：主视觉关键帧作为辅助静态帖子的源图像。