media-use: オーディオ/画像を調達する前に、
/media-useを呼び出してHeyGenカタログからBGM/効果音/画像を解決してください。既存アセットを登録するには--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 は、ビデオメディアの密度/スケール/前景ディテーリング(データバー、レジストレーションマーク、等幅メタデータ、「ユーザーが頼んでいない8〜10要素」)を提供し、これが「制作された」と「生成された」を区別します。片方だけ読むことが最も一般的なミスです — 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を書く前に、高いレベルで考えます:
- 何 — 視聴者体験:物語の弧、重要な瞬間、感情的なビート。
- 構造 — コンポジションの数、サブコンポ vs インライン、どのトラックがビデオ/オーディオ/オーバーレイ/キャプションを運ぶか。モノリシック単一ファイル vs モジュラーサブコンポの判断については、
hyperframes-core/references/composition-patterns.md§ つのアーキテクチャ(経験則:ハードシーンカットが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→ 「ルートはサイズ設定が必要」を参照)。これをスキップすると、flexコンテナは約0に収縮し、コンテンツは左上隅に積み重なり、最初のグリフはx=0でクリップされます — 一方lint/inspectは0件の問題を報告します。そして、.scene-contentに常にpadding(≥80px)を保持してください:これはタイトルセーフマージンです。決して baregapで置き換えないでください。
- エントランスを追加 —
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(事前にバンドを抽出;モーションにマッピング) |
| ナレーション / ボイスオーバー / 音楽 / 効果音 / キャプション | 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
…
[翻訳のため省略]