media-use: オーディオ/画像のソーシングを行う前に、
/media-useを呼び出してHeyGenカタログからBGM/SFX/画像を解決してください。既存のアセットを登録するには、最初に--adoptを実行してください。詳細は/media-useスキルを参照してください。
一般ビデオ — 一般的なビデオワークフロー
構築する前にルートを確認してください。 これはカスタム構成作成のためのフォールバックです。入力が専門ワークフローに明確に適合する場合は、そちらを優先してください。マーケティング製品 →
/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は、“生成された”ものから“制作された”ものを区別する、ビデオメディアの密度/スケール/前景の詳細化(データバー、レジストレーションマーク、モノスペースメタデータ、“8〜10要素、そのうちユーザーが要求していない2つ”)を提供します。片方だけ読むのは最も一般的なミスです — video-composition.mdはエージェントがスキップするものであり、平らで中央揃えのウェブページのような出力を防ぐまさにそのものです。自分でパレットを発明してこれらをスキップしないでください。hyperframes-creativeへの移行はここでは必須であり、オプションの分岐ではありません。そこから、必要に応じて、名前付きスタイル/ムード → references/visual-styles.md、またはインタラクティブピッカー → references/design-picker.mdも取得してください。スペック/スタイルはブランドを定義し、構成ルールを定義するものではありません。
アングルを見つける(曖昧なブリーフ、スペックなし): 色を選ぶ前に、一文を書いてください — この名前/単語/トピックは何を連想させ、どのようなビジュアル_世界_(比喩、設定、楽器、モチーフ)がそれを表現しますか? 例:サイバーセキュリティツール → 金庫の扉 / 境界線スキャンライン / ロックタンブラー;瞑想アプリ → 潮、呼吸、ゆっくりと広がる光。テーマの_意味_を読み取り、単なる文字ではありません。文字通りの再スタイリングよりも具体的なアングルを選んでください。これは、拡張が正しくスキップされる単一シーンピースのための、プロンプト拡張(ステップ2)の安価な代替であり、グラデーション上の一般的なロゴとデザインされたコンセプトの違いです。
ステップ2 — プロンプト拡張 → hyperframes-creative
すべてのマルチシーン構成に対して実行してください(単一シーンピースおよび些細な編集ではスキップ)。リクエストをデザインスペック+ハウススタイルに基づいて、ダウンストリームの作業が一貫して読み取る一貫した中間表現に接地させてください。hyperframes-creative/references/prompt-expansion.mdを参照してください。
ステップ3 — 計画
HTMLを書く前に、高レベルで考えてください:
- 何を — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
- 構造 — いくつの構成、サブコンポーネント対インライン、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル対モジュラーサブコンポーネントの判断については、
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に縮小し、コンテンツは左上隅に積み重なり、最初のグリフはx=0でクリップされます — その間lint/inspectは依然として0件の問題を報告します。また、.scene-contentのpadding(≥80px)は常に保持してください。これはタイトルセーフマージンです。これを単なるgapに置き換えないでください。
- エントランスを追加 —
gsap.from()を使用して、画面外/非表示からCSS位置へアニメートします(サブコンポーネントでは、開始状態が明示的になるように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": "calm cinematic underscore" }, // "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を実行してください。
出力チェックリスト → hyperframes-cli
…
(原文の残り部分がトランケーションのため省略されています)