OliviaPp8/minara-video-skills

/minara-videoscript — Minara 動画スクリプト

スクリプトのみ。アニメーションは含みません。出力は、1つのマークダウンスクリプトドキュメントと、静止キーフレーム画像のフォルダです。オペレーターが承認した後、下流の工程に進みます。

動画タイプ	下流スキル
マーケティング/ローンチ/デモ動画（コードで構築された画像、UIは再描画される場合あり）	minara-video
ユースケース/初心者チュートリアル（UIを忠実に再構築）	minara-usecase-video
オペレーター自身の画面録画にキャプションとナレーションを追加	minara-guide-video
録音されたナレーションをカットしてナレーショントラックに配置	minara-voiceover（キーフレームシートのVoiceover列とTime列を読み取る）
音楽/効果音	minara-music（このドキュメントの音楽セクションと効果音の手がかりを読み取る）

構造：単一シーンの補足は、1つの source.html から抽出した5～8個のキーフレームで構成されます。フル動画は通常6～10シーンです。新しいスクリプトは英語のみで作成します。

コアユニット：キーフレーム

スクリプトは一連のキーフレームです。キーフレームは、視聴者が見るべき瞬間の静止画像1枚であり、その周辺で起こるすべてのことがその横に記述されます。すべてのキーフレームには、同じ7つのフィールドがあります。

フィールド	内容
画像	. ソースタグ：UI code / Figma / AIGC.
時間	静止画像が表すタイムコード（40.5s）と、その範囲（39.8–41.6s）.
持続時間	その範囲の長さ（秒単位）。ホールド＋そこへの動きを含む。
ピクチャー	画面上の内容と動きを順に記述。カメラワークがあればそれも（「ワークフローカードにプッシュイン」）。
ナレーション	この範囲で話されるセリフ、または —.
オン画面テキスト（花字）	正確なテキスト、スタイル、位置、イン/アウト時間。または —. ルールは下記。
音楽	この範囲のBGMのエネルギー + 効果音の手がかりとその正確な時間。

目安：動画の2～4秒あたり1つのキーフレーム、最小でも1シーンに1つ。何かが確定した瞬間（プロンプトが入力された、チャートが描画された、通知が届いたなど）のフレームを選び、モーションブラーの途中は避ける。

言語：英語のみ（オペレーター、2026-10-19）

• スクリプトドキュメント内のすべては英語：タイトル、注釈、フローテーブル、キーフレームフィールド、ナレーション、オン画面テキスト、UIコピー、音楽ノート、未確定の疑問点。中国語の翻訳行や「中文对照」列、その他の言語はありません。キーフレーム画像内のテキストも同様です。
• UIコピーは、英語版プロダクトUIに表示されている通りに正確に引用します。
• オペレーターが中国語でブリーフィングする場合があります。その意味を英語のスクリプトに翻訳します。チャットで中国語で書かれた場合は、チャットでは中国語で応答します。ドキュメントのみが英語です。

語り口：落ち着いて、ニュートラルに、自然に

スクリプトは、モデルが書いたのではなく、人間が書いたように読める必要があります。落ち着いてニュートラルに：何が起こるかを述べ、プロダクトに語らせます。

• すべてのナレーションラインを声に出して読んでください。 広告、スローガンジェネレーター、プレスリリースのように聞こえる場合は、書き直します。同僚に言わないようなフレーズは削除します。
• 平易な動詞、短い文、現在形。短縮形は問題ありません（it's、you'll）。文体の例：Just ask. / Backtest it. / Minara builds the workflow. / Then it keeps watching.
• ニュートラルで、興奮させない：煽るような形容詞、感嘆符、すべて大文字、絵文字は禁止。
• 禁止ワード：exciting、powerful、seamless(ly)、effortless(ly)、revolutionary、game-changing、unlock、unleash、elevate、supercharge、empower、cutting-edge、next-level、robust、leverage、harness、journey、landscape、delve、transform(ative)、"at your fingertips"。
• 禁止AIパターン：
  • "Not just X, but Y" / "It's not X. It's Y."
  • リズムのための3つのリスト（"faster, smarter, safer"）
  • "Imagine…"、"What if…"、"In a world where…"、"Say goodbye to…"、"Meet your new…"
  • フックとしての修辞疑問
  • コロンやダッシュによる啓示（"One thing changed: everything."）
  • 偽の深みを追加する末尾の-ing節（"…, giving you full control."）
  • 重要性の水増し（"a pivotal moment"、"redefines how…"）
• 完全なパターンリスト：AIライティングパターンリスト（例：Wikipedia「Signs of AI writing」）。引き渡す前に、すべてのナレーションラインとオン画面テキストをそれと照合します。
• 利益の約束は禁止（"guaranteed"、"risk-free"）。バックテストやリターンが表示される場合は、リスクに関する文言を記載します（例：Past performance does not guarantee future results.）。
• ソース資料にない事実は⚠️を付け、「未確定の疑問点」に移動します。捏造しないでください。

ワークフロー

1. 入力を収集：ブリーフ、スクリーンショット、フロントエンドコードのパス、Figmaリンク、機能ノート、既存のカット、音楽リファレンス（あれば）。一度に、推測できないものだけを1つの複合質問で尋ねます：長さ、横/縦、プラットフォーム（X / Discord / ウェブサイト）、ナレーションの有無、動画内での位置、オペレーターがイメージしている音楽のムード。
2. プレゼンテーションの選択をドキュメントの先頭で固定して、ぶれないようにする：使用するケース、画面（Desktop / App / Web）、タイムゾーン、表示しないもの。以下のトピックルールに従ってケースを選択します。
3. 最初にテキストをドラフト：セクション1（伝えるべきこと）、ユーザーフローとUIコピー、タイミング付きのシーンリスト、キーフレームリスト（ID、時間、ピクチャー、ナレーション、オン画面テキスト、音楽）。画像はまだ作成しません。これにより、画像作業がストーリーを歪めるのを防ぎます。
4. 以下のルートでキーフレーム画像を作成し、docs/keyframes/<topic>/K1.png … に保存します。UIフレームを優先（無料で正確）；クレジットを消費するAIGCフレームの前には必ず許可を求めます。
5. ドキュメントをプロジェクトの docs/ に書き込みます（単一シーンの場合：NN-script-scene-N-<topic>.md、フル動画の場合：NN-script-<slug>.md）。docs/ がない場合はプロジェクトルート。リンクする前に、すべてのキーフレームPNGを開き、Pictureフィールドと照合します。
6. 以下のチェックリストでセルフチェックを実行します。ナレーションの単語数とタイミングを計算し、推定は行いません。
7. オペレーターに送信：ファイルパスと3～5行の概要（長さ、シーン数、ソース別キーフレーム数、ナレーション単語数/再生時間の割合、音楽の方向性を1行で、未確定の疑問点の数）。オペレーターがスクリプトを編集し、キーフレームをマークします。コードは編集しません。承認前はアニメーションなし。 承認前は静止画像は許可されますが、動きは許可されません。
8. 承認後：引き継ぎます。下流の秒単位スクリプトは、このドキュメントのキーフレーム時間から展開されます。何も書き直されません。minara-music は Music セクションから cues.json を構築します。レビューボード用に、minara-video の assets/storyboard-template.html から storyboard.html を生成します。AIGCキーフレームは、そのAIGC行にマッピングされます。

キーフレーム画像の作成

3つのルート。最初に該当するものを使ってください。スクリプト内で混在してもかまいません。各キーフレームはどれを使用したかを示します。

ルートA — UIコード（プロダクトUIのデフォルト）

フレームはHTMLで描画されるため、コピーは正確で、後でアニメーションで再利用できます。

1. assets/keyframes-source-template.html を docs/keyframes/<topic>/source.html にコピーします。キーフレームごとに1つの <section class="k" id="K1">；?k=K1 でそのフレームを表示します。
2. 実際のUIから各フレームを埋めます：フロントエンドコード（コンポーネント、i18n文字列）または既存のHyperFrames構成からコピー、データ、構造を取得します。大きく描き直します（動画ルールに従う）：body ≥28px、タイトル ≥48px、キーナンバー 80～140px、画面あたり3～5要素、Geistのみ、Minaraパレット（#F2F2F2 ステージ、#15171A / #222222 / #FFFFFF UI、#B0B0B0 セカンダリ、緑 #07B56A 上昇/成功のみ、赤 #F75D5F 下降のみ）、グラデーションなし、右下に「Illustrative data」。
3. オン画面テキスト（花字）を、それが配置されるフレーム内に描画し、オペレーターが実際のレイアウトを確認できるようにします。
4. 撮影：

   ~/.claude/skills/minara-videoscript/scripts/shoot_keyframes.sh \
     docs/keyframes/<topic>/source.html docs/keyframes/<topic> landscape K1 K2 K3
   

   出力は 2560×1440（portrait：1440×2560）、2Kデリバリーに一致します。このスクリプトは #k1 も渡すため、古いV2ソースページ（ハッシュ選択）でも機能します。
5. アニメーションが既に存在する場合、キーフレームがその中の瞬間である場合：再描画せずにコンポジションをシークします。プロジェクトのテストページで ?t=<seconds> または npm run snapshot -- <t1>,<t2> を使用し、PNGを K<n>.png としてコピーします。

ルートB — Figma

デザインがFigmaにフレームを持っている場合（コード化されていない新しい画面、キャンペーンレイアウト）。

1. リンクから fileKey と nodeId を取得します（node-id=1-2 → 1:2）。get_design_context の前にFigmaデザインからコードへのガイダンスを読み込みます。
2. maxDimension: 2560 で get_screenshot を実行し、curlでURLをダウンロードして docs/keyframes/<topic>/K<n>.png に保存します。
3. get_design_context / get_variable_defs を使用して、UIコピーテーブル用の正確なコピーとトークンを取得します。
4. Figmaフレームが高密度のデスクトップ画面の場合、それは参照のみです。ルートAで大きく再構築し、ソースを Figma → UI code と注記します。

ルートC — スクリーンショットからのAIGC

プロダクトUIではないフレーム用：オープニング画像、メタファー、電話を使用している人、環境、ムードショット。プロダクトUIや実際のコピーや数字を含むものには決して使用しません。これらはルートAまたはBを使用します。

1. 最初に許可を求めます。 画像生成はクレジットを消費します（Figma generate_image はFigma AIクレジットを使用；Weaveモデルは見積もりコストと明示的な承認が必要）。どのフレーム、どのモデル、コストを伝え、待ちます。
2. ツールがそれを許可する場合は、スクリーンショットまたはルートAフレームを参照としてモデルに与えます。そうでない場合は、プロンプト内で参照を説明します。
3. プロンプトルール：16:9（または9:16）、Minaraパレットを言葉で指定（薄い灰色のステージ、ほぼ黒のUI、白、成功のみ緑）、清潔でミニマル、柔らかな日光、グラデーションなし、紫ピンクオレンジなし、画像内にテキスト、文字、数字、ロゴはなし（モデルはそれらを歪めます；テキストはコードで追加）、ミーム画像なし、実在の人物の肖像や他のブランドはなし。
4. K<n>.png として保存し、正確なプロンプト、モデル、参照画像、日付を docs/keyframes/<topic>/prompts.md に書き込みます。これにより、フレームを再生成したり、AIGCショットを作成する同僚に引き継いだりできます。
5. 結果を開きます。不適切なテキスト、間違った手、間違った色、ストックAIアートのように見えるものは拒否し、再生成するかルートAレイアウトにフォールバックします。

オン画面テキスト（花字）

オン画面テキストとは、UI自体の一部ではない、画像上に配置されるテキストのことです：キャプション行、タイトル、キーナンバー、エンドCTA。

• 許可されるもの：(1) ナレーション行またはその一部（キャプションまたは強調として）；(2) 実際のUIコピーを抽出して拡大したもの；(3) オペレーターが依頼したタイトル、キーナンバー、CTA。その他は不可。注釈ワード、ラベルの壁、浮遊キーワード、機能タグは禁止。概念の説明が必要な場合は、画像と動きで示します。

• ナレーションルールが適用されます：落ち着いて、平易に、禁止ワードなし、感嘆符なし、文頭大文字。

• 各項目を次のように記述します："Just ask." · 64px / 700 · #15171A · ウィンドウの左上 · イン 12.4s、アウト 14.0s · minaraSnapで24px上昇。

• 選択するスタイル（1つの動画内で一貫性を保つ）：

  スタイル	用途	仕様
  Caption	ナレーション行をテキストとして表示	40～48px / 500、下部中央、暗い背景に白または明るい背景に #15171A、ボックスなし
  Headline	タイトルまたはシーンの1つの主張	64～96px / 700、トラッキング −0.02em、左揃え
  Key number	ショットの要点となる数字	120～200px / 700、表形式数字；緑/赤は利益/損失の場合のみ
  CTA	エンドカード	56～72px / 700 ＋ 製品名またはURL

• 動き：minaraSnapでイン（0.6～0.9秒、小さな上昇または0.96からのスケール）、アウトは≤0.3秒のフェード。各アイテムは、読み上げるのに必要な時間以上表示されます（1単語0.4秒、最小1.2秒）。

• 絵文字、グラデーション塗りつぶし、グロー、アウトラインまたは3Dテキスト、すべて大文字は禁止。

音楽（BGMスタイルと効果音の手がかり）

ドキュメントは minara-music に必要なすべてを提供するため、音楽はスクリプトと同時に決定され、後からではありません。

• 動画レベルのブリーフ（1ブロック）：テンポ（BPM、デフォルト120）、キー（デフォルトAマイナー；明るい曲はCメジャー）、1～2行の平易な言葉でのフィーリング（Soft electronic, warm pads, light plucked arpeggio, no vocals.）、避けるもの（EDMドロップなし、トレーラーヒットなし、ローファイのパチパチ音なし、ボーカルチョップなし）、オペレーターが指定した場合はリファレンストラック。ライセンストラックはオペレーターからのみ提供されます。
• キーフレームごとのエネルギー：silent / intro / light / build / full / breakdown / climax / outro のいずれか（minara-music の語彙）、および数語のムード。エネルギーはストーリーに従います：製品名やローンチの主張は climax；プライバシーやセキュリティのビートは breakdown；エンドカードは outro。
• 効果音の手がかり：可視アクションのみ、それぞれ正確な時間を指定：tap 35.0s、typing 32.1–34.6s (cps 18)、success 45.0s、notify 45.2s、whoosh 47.3s、thud 43.2s、bell 0.4s。タイプは minara-music のSFXリストに従います。
• ナレーションがある場合、音楽はダックされます。ブリーフに duck under VO と記載します。

スクリプトドキュメントテンプレート

# Script | <Topic>: <one-line summary>            ← フル動画："Script | <Film name>"

> <シーンN / フル動画> の現在の単一スクリプト。
> 目的：<シーンNを置き換え、XX～XX秒 / 新規動画>。このスクリプトが承認されるまで、既存のカットは変更されません。
> ソース：<フロントエンドコードパス / Figmaリンク / スクリーンショットパス / プロダクトドキュメント>。⚠️ が付いた項目はソースになく、プロダクトの確認が必要です。
> **プレゼンテーション（固定済み）**：<ケース；画面；タイムゾーン；表示しないもの；フォローアップ質問ステップの有無>。
> **出力**：<2560×1440 または 1440×2560>、60fps。キーフレーム：`docs/keyframes/<topic>/`（ソース：`source.html`、AIGCプロンプト：`prompts.md`）。

## 1. これで伝えるべきこと
1. <視聴者が最初に覚えるべきこと>
2. …（最大4つ。それぞれが少なくとも1つのキーフレームに対応）

## 2. ユーザーフローとUIコピー
| ステップ | ユーザーアクション | UIコピー（正確） | ソース |
（ソース = コードパス / Figmaノード / スクリーンショット；デモプロンプトは "(demo)" とマーク）

## 3. キーフレームシート（<合計>秒<、XX～XX秒を置き換え>）
| キー | 時間 | 持続時間 | シーン | ピクチャー（簡略） | ナレーション | オン画面テキスト | 音楽 | 画像ソース |
|---|---|---|---|---|---|---|---|---|
| K1 | 0.0–2.4s | 2.4s | S1 | アバターが中央に着地 | — | — | intro · bell 0.4s | UI code |
（1行に1キーフレーム。範囲は連続し、合計に等しい。これは下流スキルが読み取るテーブルです。）

## 4. シーンとキーフレーム
### <Scene id> | <…

（注：テンプレートは意図的に途中で切られています。実際の使用時は、元のテンプレート構造に従って完全なドキュメントを生成してください。）