media-use: オーディオ/画像を調達する前に、
/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を取得してください。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。
general-video — 汎用ビデオワークフロー
ビルドを開始する前にルートを確認してください。 これはカスタムコンポジション作成のためのフォールバックです。入力が特定のワークフローに明確に適合する場合は、そちらを優先してください:製品販売 →
/product-launch-video;一般的なサイト →/website-to-video;トピック解説 →/faceless-explainer;GitHub PR →/pr-to-video;既存映像 →/embedded-captions·/talking-head-recut;短いナレーションなしモーショングラフィック →/motion-graphics;Remotionポート →/remotion-to-hyperframes。対象外:ライブ/レンダリング時データ、完成したビデオのNLEスタイル編集、またはHyperFramesがキャプチャできない映像の制作。不明な場合は、最初に/hyperframesを読んでください。
要求されたものを正確に構築します。 タイトルカードはタイトルカードです — タイトルカード+3つの補助シーン+環境音楽+キャプションではありません。追加のシーンや要素が作品を真に向上させる場合は、それらを_提案_してください。黙って追加しないでください。小さな編集(色の修正、1つの長さの調整、1つの要素の追加)の場合は、計画ステップをスキップして直接ビルドに進みます。
アプローチ
ディスカバリー — オープンエンドのリクエストのみ
漠然とした探索的なリクエスト(「ブランドのための何かを作って」「かっこいいイントロ」)の場合 — 色を選ぶ前に意図を理解します:
- オーディエンス — 誰が見るのか? 開発者 / 経営者 / 一般消費者?
- プラットフォーム — どこで再生されるのか? ソーシャル(15秒) / ウェブサイトヒーロー / 製品デモ / 社内用?
- 優先順位 — 何が最も重要か? モーション品質 / コンテンツの正確さ / ブランドの忠実度 / 速度?
- バリエーション — 1つのベストショットか、または意味のある異なる2〜3のオプション(単なる色の変更ではなく、異なるペース、エネルギー、または構造)か?
具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、ディスカバリーをスキップします。
ステップ 1 — デザインシステム → hyperframes-creative
まず視覚的アイデンティティを確立します。プロジェクトにデザイン仕様がある場合は、それを読みます(優先順位 frame.md → design.md → DESIGN.md;それをブランドの真実として扱います — 正確な色、フォント、制約)。
仕様がない場合、色やフォントを選択する前に、hyperframes-creative/references/house-style.md と hyperframes-creative/references/video-composition.md の両方を読む必要があります。 house-style.md は「プロンプトを解釈して実際のコンテンツを生成する」オープナー、遅延デフォルトリスト、レイヤーレシピを提供します。video-composition.md は、「プロデュースされた」出力と「生成された」出力を区別するビデオメディアの密度/スケール/前景ディテール(データバー、登録マーク、等幅メタデータ、「ユーザーが要求していない2つの要素を含む8〜10要素」)を提供します。片方だけを読むことは最も一般的なミスです — video-composition.md はエージェントがスキップするものであり、まさに平らで中央揃えのウェブページ的な出力を防ぐものです。パレットを自己発明してこれらをスキップしないでください。hyperframes-creative に入ることはここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.md も取得します。仕様/スタイルはブランドを定義し、コンポジションルールを定義するものではありません。
アングルを見つける(漠然とした概要、仕様なし): 色を選ぶ前に、1文を書きます — この名前/単語/トピックは何を呼び起こし、どのような視覚的_世界_(比喩、設定、楽器、モチーフ)がそれを表現するのか? 例:サイバーセキュリティツール → 金庫のドア / 境界スキャンライン / ロックタンブラー;瞑想アプリ → 潮の満ち引き、呼吸、ゆっくりとした光の広がり。対象の_意味_を読み、単なる文字ではありません。文字通りのリスタイルではなく、具体的なアングルを選びます。これは、シングルシーン作品でプロンプト拡張(ステップ2)の代わりとなる安価な代替手段であり、拡張が正しくスキップされる場合に使用します — これが、デザインされたコンセプトとグラデーション上の一般的なロゴとの違いです。
ステップ 2 — プロンプト拡張 → hyperframes-creative
すべてのマルチシーンコンポジションで実行します(シングルシーン作品と些細な編集ではスキップします)。リクエストをデザイン仕様+ハウススタイルに基づいて、ダウンストリームの作業が同じ方法で読み取る一貫した中間形式に変換します。hyperframes-creative/references/prompt-expansion.md を参照してください。
ステップ 3 — 計画
HTMLを記述する前に、高いレベルで考えます:
- 何を — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
- 構造 — いくつのコンポジションか、サブコンポ vs インラインか、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシックな単一ファイル vs モジュラーサブコンポの判断については、
hyperframes-core/references/composition-patterns.md§ 2つのアーキテクチャを参照してください(経験則:≥3のハードシーンカット、または再利用されるシーンがある場合 → モジュール化;短いシングルシーン作品は1ファイルのまま)。 - リズム — 実装する前にパターンに名前を付けます(例:
fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.mdを参照してください。 - タイミング — どのクリップが長さを決定するか、トランジションがどこに配置されるか、ペーシング。
- レイアウト — 最初に最終状態を構築します(以下を参照)。
- アニメーション — その後、
hyperframes-animationを介してモーションを追加します。
アニメーションの前にレイアウト
すべての要素を、最も見える瞬間に配置します — 完全に入力され、正しく配置され、まだ終了していない状態。まずそれを静的HTML + CSSとして記述します。GSAPはまだ使用しません。
理由: アニメーションの開始状態(画面外、スケール0、不透明度0)で要素を配置し、_着地する_と思われる場所にトゥイーンすると、最終的なレイアウトを推測していることになります — 重なりはレンダリングまで見えません。最初に最終状態を構築すると、モーションを追加する前にレイアウトの問題を確認して修正できます。
- 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に見える瞬間。それが構築するレイアウトです。
- そのフレームの静的CSSを記述します。コンテンツコンテナは、絶対オフセットではなくパディングでシーンを埋める必要があります:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* パディングがコンテンツを配置します;任意のシーンサイズにフィット */
gap: 24px;
box-sizing: border-box;
}
コンテンツコンテナに position: absolute; top: Npx を使用しないでください — コンテンツがスペースより高い場合にオーバーフローします。絶対配置は装飾用に予約します。
⚠ 上記の
width/height: 100%は、すべての祖先が解決された高さを持っている場合にのみ機能します。 ルート<div data-composition-id>とそれと.scene-contentの間のラッパーはサイズ設定が必要です(ルートにposition: relative; width: 1920px; height: 1080px—hyperframes-core→ 「ルートはサイズ設定が必要」を参照)。これをスキップすると、フレックスコンテナは約0にcollapseし、コンテンツは左上隅に山積みになり、最初のグリフはx=0でクリップされます — その間lint/inspectは0問題を報告します。そして、.scene-content にpadding(≥80px)を常に保持します:それはタイトルセーフマージンです。決して単なるgapに置き換えないでください。
- エントランスを追加します — 画面外/非表示からCSS位置へ
gsap.from()でアニメーションします(サブコンポジションでは、開始状態が明示されるようにgsap.fromTo()を優先します;hyperframes-core/references/sub-compositions.mdを参照)。CSS位置がグラウンドトゥルースであり、トゥイーンはそこへの旅です。 - 終了はトランジションで処理されます —
hyperframes-animation/transitions/のシーントランジションルールに従い、最終シーンのみが要素をアニメーションアウトします;シーン間ではトランジション自体が終了です。
時間を超えた共有スペース: 要素Aが同じエリアで要素Bが入る前に終了する場合でも、それぞれのヒーローフレームに対して正しいCSS位置が必要です — タイムラインの順序付けによりそれらが共存するのを防ぎ、レイアウトステップが偶発的な重なりをキャッチします。レイヤードグロー/シャドウとzスタックの深さは_意図的な_重なりです;ステップは_意図しない_衝突(2つの見出しが互いに重なる、コンテンツがフレームからはみ出す)をキャッチすることです。
ビルド — ドメインスキルに委譲する
これは、スキルの全表面(description を参照)をその参照にマッピングします — 網羅的ではありません;意図がリストされていない場合は、hyperframes-creative(外観/コンセプト)、hyperframes-animation(モーション)、hyperframes-core(契約)、hyperframes-media(オーディオ/キャプション)を経由します。最初の行は追加です — それと意図行の両方を読み、どちらか一方だけではありません。
| 構築するもの… | 最初に読むもの(順序順) |
|---|---|
| 常に — すべての非自明な作品で、以下の意図行に加えて | hyperframes-creative/references/house-style.md + references/video-composition.md(ステップ1 / HARD-GATEでもゲートされています;「プロデュースされ、生成されていない」前景ディテール) |
| キネティックタイポグラフィ / テキスト主体 | hyperframes-animation/techniques.md(キネティックタイプ)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| タイトルカード / ローワーサード / オーバーレイ / PiP / テキストビハインドサブジェクト | hyperframes-creative/references/composition-patterns.md + (中央揃え/サイズ調整フレームの場合) hyperframes-core → 「ルートはサイズ設定が必要」 |
| ロゴ / ブランドマークリビール | hyperframes-animation/rules/svg-path-draw.md(描画)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| データ / 統計 / 数字 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 製品 / アプリ / UIデモ | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| オーディオリアクティブ / 音楽駆動 | hyperframes-creative/references/audio-reactive.md(事前バンド抽出;モーションにマッピング) |
| ナレーション / ボイスオーバー / 音楽 / SFX / キャプション | hyperframes-media → 共有オーディオエンジン scripts/audio.mjs(1回の呼び出しでTTS + BGM + SFX → audio_meta.json);キャプション作成 + アセット配置は hyperframes-core を経由。以下のオーディオを参照してください。 |
| マルチシーン / トランジション | hyperframes-animation/transitions/overview.md その後 transitions/catalog.md(概要だけでは終わりではありません — GSAPレシピはカタログにあります) |
| モジュラー / サブコンポジション | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
オーディオ:1つのエンジン(TTS · BGM · SFX)
作品が必要とする場合のみ(「要求されたものを正確に構築する」に従い — タイトルカードに環境音楽は不要)。TTSを手動で実装したり、コピーをベンダー調達したりしないでください:ニュートラルな audio_request.json を書き、hyperframes-media の共有エンジンを呼び出します。1つのスイッチで自動的にグレードダウンします — HeyGen認証情報あり → HeyGen TTS + 音楽/SFX 取得;なし → ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成、およびバンドルされたSFXライブラリ。完全なフラグリスト + リクエスト/メタスキーマ:hyperframes-media/scripts/audio.mjs のヘッダーコメントを参照してください。
// audio_request.json — ナレーションセグメントごとに1行;`id` はあなたのもの(audio_metaを結合)
{
"lines": [
{ "id": "s1", "text": "オープニングライン。", "sfx": ["whoosh"] },
{ "id": "s2", "text": "次のビート。" },
],
"bgm": { "query": "穏やかなシネマティックアンダースコア" }, // "mode" を省略 → 自動(HeyGenの場合は取得、それ以外は生成);無効にするには "none"
}
# <MEDIA_DIR> = インストールされたhyperframes-mediaスキルディレクトリ(このスキルの兄弟)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
その後、audio_meta.json を読み取ります:各 voices[].path +(bgm.path、sfx[])を <audio> トラックとしてマウントし、voices[].words をキャプションに使用します。すべて hyperframes-core に従います(オーディオトラック + キャプション作成)。BGMが生成パスをたどった場合(bgm_pending: true)、最終レンダリングの前に hyperframes-media/scripts/wait-bgm.mjs を実行します。