メディア利用: 音声/画像をソーシングする前に、
/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 も取得してください。スペック/スタイルはブランドを定義するものであり、構成ルールを定義するものではありません。
アングルを見つける(漠然とした指示、スペックなし): 色を選ぶ前に、1文を書いてください — この名前/単語/トピックは何を連想させ、どのようなビジュアル_世界_(比喩、設定、楽器、モチーフ)がそれを表現するのか? 例:サイバーセキュリティツール → 金庫の扉 / 境界線スキャンライン / ロックタンブラー;瞑想アプリ → 潮の満ち引き、呼吸、ゆっくりとした光のブルーム。主題の 意味 を読み取り、単なる文字通りに再構成するのではなく、具体的なアングルを選んでください。これは、シングルシーン作品でプロンプト拡張(ステップ2)の安価な代替手段であり、拡張が正しくスキップされる場合であり、設計されたコンセプトとグラデーション上の汎用ロゴとの違いです。
<ハードゲート> 構成HTMLを記述する前に、以下の4つすべてを確認したか検証してください:
- ビジュアルアイデンティティ — スペックまたは
house-style.mdに基づいており、その場で発明されたものではないこと。(#333、#3b82f6、Robotoに手を伸ばしていますか? スキップしています。) - 1文のコンセプトアングル(「アングルを見つける」ステップ) — 些細な編集を超えるものについて、プロンプトの単語を文字通りに再構成したものではないこと。
- 埋め込みリストからのフォントペアリング(
hyperframes-creative/references/typography.md→ 「埋め込まれるフォント」) — 意図的に選択されていること。デフォルトでInter/Helvetica Neue/system-uiではなく、埋め込まれていない表示用フォントをレンダリングされることを期待して使用しないこと(バンドルされていない名前は、ローカルで自動キャプチャされた場合のみ埋め込まれます。クラウドレンダリングではキャプチャされません)。 video-composition.mdからの前景/密度計画 — エッジアンカー、8〜10要素、前景メタデータ、背景テクスチャのルール。(フラットカラー上の中央スタックで、要素が6つ未満で、エッジアンカーのディテールがない? スキップしています — それが汎用的な兆候です。) </ハードゲート>
ステップ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に収縮し、コンテンツは左上隅に積み重なり、最初のグリフは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 / ハードゲートでも条件付けられている。「生成された」ではなく「プロデュースされた」前景ディテーリング) |
| キネティックタイポグラフィ / テキスト主体 | 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": "穏やかなシネマティックアンダースコア" }, // "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
- …
[翻訳のため一部省略]