product-video

プロダクト動画

プロダクトとゴールから、完全なプロダクト動画制作仕様を作成します — 選定された1つの動画コンセプト、タイミング付きのビート単位のショットリスト、アニメーションとペース配分の計画、そして生成可能なキーフレームプロンプトです。支配的な原則は、1本の動画で伝えることは1つ。すべてのビートは、その単一のメッセージ(お披露目、ベネフィット、変化)に向かって積み上がるか、さもなければカットされます。あなたは計画とキーフレームを制作し、モーションのレンダリングは後工程で行われます。

使うべきとき / 使うべきでないとき

• プロダクト中心のモーションコンテンツに使用します: お披露目、機能紹介、使用中の製品、変化、360度スピン。
• 動画の前面に人物が立つ場合(プレゼンター、体験談、UGC)→ skills/creative/talking-head を使用してください。
• 動画を Remotion でプログラム的にレンダリングする場合(UI デモ、コードチュートリアル、データビジュアライゼーション)→ skills/creative/remotion-script-writer を使用してください。それでも先にこのスキルを実行してコンセプトとビートを定義し、その後ビートシートを引き渡すことができます。
• ユーザーが静的な素材(投稿、バナー)を必要としている場合 → skills/creative/social-graphics。
• ブランドスタイルガイドがまだなく、ユーザーがブランドの一貫性を重視する場合 → 先に skills/creative/creative-strategist を実行してください。そのスタイルガイドがこのスキルに反映されます。

ヒアリング

足りないものだけを、1回の簡潔なまとまりで質問してください:

1. プロダクト — それは何で、動画が伝えるべき1つのことは何か(新発売? ある機能? あるベネフィット? ビフォーアフター?)。
2. どこで流れるか — TikTok/Reels/Shorts、プロダクトページ、YouTube プレロール、展示会のループ? (これによりアスペクト比、尺、ペース配分が決まります。)
3. 視聴者にその後どうしてほしいか — CTA。
4. ブランドスタイル — 合わせるべき skills/creative/creative-strategist のスタイルガイドや既存のブランド素材はありますか?

質問せずに文脈から推測してください: プラットフォームからアスペクト比、プロダクトカテゴリからムード、プロジェクト内の既存のブランド素材からスタイル。立ち止まらないでください: プロダクトとゴールが明確なら、残りについては前提を述べて進めてください(「Reels、12秒、縦型、エネルギッシュと仮定します — 異なる場合はお知らせください」)。

ワークフロー

1. 動画タイプを選ぶ(メニューではなく判断ルール)

メッセージが…	タイプ	尺	ビート構成
「これが存在する / 新しい」	お披露目	5〜15秒	隠れている/覆われている → お披露目アニメーション(フェード、スライド、回転)→ ヒーローショット
「これには2〜4の機能がある」	機能紹介	15〜30秒	機能1のハイライト → 機能2 → 機能3 → 製品全体
「使用時のベネフィットはこれ」	使用中	10〜20秒	環境内の製品 → 使用されている製品 → 結果の提示
「変化を見て」	変化	10〜15秒	変化前の状態 → モーフ → 変化後の状態
「ただ物体を見せて」(Eコマース、出品)	360度スピン	5〜10秒	連続した滑らかな回転、クリーンな背景

1つのタイプを、一行の理由とともに確定してください。2つが本当に当てはまる場合にのみ、1つの代替案を提示してください。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. アニメーションスタイルを 1 つ選ぶ

ブランドの個性に合わせて、必ず 1 つだけ選び、そのフレーズをすべてのキーフレームプロンプトにそのまま使用することで、フレームの一貫性を保ちます：

ブランドの印象	スタイル	プロンプトフレーズ
エレガント、落ち着き	スムーズフェード	"smooth fade transitions, gentle pacing, elegant"
モダン、エネルギッシュ	ダイナミックスライド	"dynamic slide transitions, elements slide in, energetic pacing"
シネマティック、大胆	ズーム＆ローテート	"zoom and rotate moves, dynamic pacing, cinematic"
洗練、流動的	モーフィング	"smooth morphing transitions, fluid animation, sophisticated"
ハイテク	パーティクルエフェクト	"particle effects, product materializes/dissolves, high-tech"

4. ビートシートを書く

再生時間を 3～6 のビートに分割します。各ビートについて、時間範囲、画面に表示される内容、カメラ／モーション、そして次のビートへのトランジションを記述します。すべてのビートは単一のメッセージを前進させなければならず、最後のビートでは常に製品＋CTA を 2 秒以上保持します。

5. キーフレームプロンプトを書く

1 ビートにつき 1 つのキーフレーム（トランスフォーメーションのビフォー／アフターの場合は 2 つ）。各プロンプト = 被写体＋そのビートでの状態＋アニメーションスタイルのフレーズ＋ライティング＋すべてのフレームで同一のスタイル／ライティング記述子（一貫性こそが、フレームを 1 つの動画として読ませる鍵です）。ビートが明示的に場所を変更しない限り、すべてのキーフレームで同一の背景とライティングの記述を使用します。

FAL_API_KEY（または FAL_KEY）が設定されている場合は、リポジトリの CLI を使って今すぐキーフレームを生成します — モデル fal-ai/nano-banana-pro を docs/fal_api.py 経由で：

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 つ。1 文で言い表せない場合は、ステップ 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 → 消費：補助的な静止投稿のソース画像としてのヒーローキーフレーム。