product-launch-video - ディスパッチエントリ
ステップ0の前にルートを確認してください。 このスキルは、マーケティング/ローンチ/プロモーション中の製品のビデオを作成します。もし、それが一般的な(ローンチではない)サイト → ビデオ(サイトツアー/ショーケース、製品販売ではない)の場合は
/website-to-videoへ;製品のないトピック/コンセプトの場合は/faceless-explainerへ;GitHub PR の場合は/pr-to-videoへ;既存ビデオへのキャプション/パッケージングの場合は/embedded-captions・/graphic-overlaysへ。範囲外(断ってください。偽装しないでください):ライブ/レンダリング時データ(すべての値はオーサリング時に固定)、まだ存在しないフッテージ/スクリーンショット/アバター(HyperFramesは録画やキャプチャができません)。「ビデオを作って」と曖昧に指示された場合、または製品対トピック/ローンチ対一般サイトが不明な場合? 最初に/hyperframesを読んでください。
すべてのアーティファクトは PROJECT_DIR = videos/<project-name>/(ステップ0で作成)に書き込まれます。以下のパスは PROJECT_DIR からの相対パスです。あなた(オーケストレーター)がBashステップを実行し、サブエージェントをディスパッチします。フェーズごとの詳細はリンク先のガイド/エージェント/スクリプトにあります — ここでは展開しないでください。ディスパッチはハーネスに依存しません:最初のサブエージェントディスパッチの前に、<SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md を一度読んでください — これはディスパッチ動詞(並列ファンアウト/バックグラウンド/待機)をあなたのハーネスのプリミティブにマッピングします。以下の同時実行数の上限は、そのサイズのウェーブを意味し、シーン数が少なくなることはありません。このファイルはバインドされた実行手順書であり、背景資料ではありません:ステップを順に実行し、各フェーズのアーティファクトを指定されたスクリプトまたはエージェントロールで生成してください — 自由形式のパイプライン(手書きのナレーション、アドホックなTTS呼び出し、手動で作成したコンポジション)に置き換えたり、リクエストが明確だからといってポーズステップをスキップしたりしないでください。実行できないステップがある場合は → 停止して報告してください。それを越えて即興で行うと、下流のすべての契約が破られます。
| フェーズ | 実行方法 | 主要アーティファクト | 詳細フロー |
|---|---|---|---|
| init | Bash 直接実行 | hyperframes.json | ステップ0(このファイル) |
| capture | Bash 直接実行(hyperframes capture) | capture/extracted/tokens.json | phases/capture/guide.md |
| design-system | サブエージェント | design-system/design.html + chunks/ | agents/design-system.md |
| story-design | サブエージェント | narrator_scripts.json | agents/story-design.md |
| audio | Bash 直接実行(audio.mjs) | audio_meta.json | phases/audio/guide.md |
| visual-design | サブエージェント | section_plan.md | agents/visual-design.md |
| prep | Bash 直接実行(prep.mjs) | group_spec.json | scripts/prep.mjs ヘッダー |
| captions | Bash 直接実行(captions.mjs group -> html) | caption_groups.json + compositions/captions.html | scripts/captions.mjs ヘッダー |
| scenes | N x サブエージェント(並列、各シーン1つ) | compositions/scene_*.html | agents/hyperframes-scene.md |
| finalize | Bash 前置処理(wait-bgm + assemble + transitions + hoist + sfx-verify)-> 最終化サブエージェント | renders/video.mp4 | ステップ7 / agents/hyperframes-finalize.md |
前提条件(初回実行前にインストール)
macOS Apple Silicon または Linux x64:
brew install [email protected] node ffmpeg # Linuxの場合は、apt/dnfの同等コマンドを使用
npx hyperframes doctor # Chrome/依存関係の準備ができているか一度確認
[email protected]— HomebrewのPythonであり、システムの/usr/bin/python3ではありません(そうしないとPEP 668がpip installをブロックします)。MusicGenのフォールバックで使用されます。node >= 18+ffmpeg(audio.mjsはffprobeを使用します)- Chromeは初回
npx hyperframes capture実行時に自動的にダウンロードされます。hoist-videos.mjs(ステップ7、シーンがフッテージを宣言した場合にのみ実行されます)はそのキャッシュされたChromeを再利用します。依存関係が不足していると報告された場合は、node <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-depsを一度実行してください(約5秒)
オプションのAPIキー(未設定の場合はローカルフォールバックを使用。ステップ0.5で注入。GEMINI_API_KEY ≡ GOOGLE_API_KEY):
| キー | 使用目的 | デフォルトの音声/フォールバック |
|---|---|---|
HEYGEN_API_KEY(または hyperframes auth login) | TTS(クラウド、単語レベルのタイムスタンプ付き) | 音声:自動(最初の英語スターシップ音声。--voice で上書き) |
ELEVENLABS_API_KEY | TTS(クラウド。pip install elevenlabs が必要) | 音声 21m00Tcm4TlvDq8ikWAM(Rachel) |
| どちらもなく、ログインもしていない | TTS | ローカルKokoro、音声 am_michael(非英語の場合は --voice を指定) |
GEMINI_API_KEY(両方の用途で1つのキー) | キャプチャビジョンキャプション + Lyria BGM | 未設定の場合 -> キャプションはDOMコンテキストのみ使用。BGMはローカルMusicGenを使用(初回実行で約300 MBダウンロード) |
フロー
ステップ0.0 - ブリーフの確認(1ラウンド、その後ビルド)
ステップ0の前に、1回のメッセージで、ローンチビデオを実質的に形作るもので、あなたが推測できないものだけを確認してください — 推奨されるデフォルト値を先に示し、ユーザーが既に提供したものはスキップしてください:アングル/フォーカス(製品全体、注目機能、オファー/CTA)、長さ(デフォルト約30-90秒。最大約3分)、および — /hyperframes がまだ設定していない場合 — アスペクト(デフォルト16:9。縦型/ソーシャルは9:16)と言語。プリセットはブランドキャプチャから導出され、質問されません。完全に指定されたリクエストの場合は、これをスキップしてビルドしてください。
ステップ0 - ビデオプロジェクトの初期化
cwdはエージェントワークスペースのルートです。すべてのビデオアーティファクトは PROJECT_DIR = videos/<project-name>/ に配置されます。
<project-name> の命名:ユーザーから明示的に指定されたディレクトリ名があればそれが優先されます。それ以外の場合は、<ブランド名>-promo のような短いケバブケースの名前を選んでください(決してワークスペースのベース名やタイムスタンプは使用しないでください)。URLからは、ドメインまたはページタイトルから導出します。名前は capture/ が書き込まれたら固定されます。
初期化($PROJECT_DIR/hyperframes.json が存在しない場合のみ):
PROJECT_DIR="${LAUNCH_VIDEO_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank
hyperframes initは汎用的なAGENTS.md/CLAUDE.mdを$PROJECT_DIRに配置します。これらはそのままにしておいてください。ただし、その汎用的なガイダンスを実行時の制約として扱わないでください — このスキルが真実の源泉です。
制約(各違反は後のフェーズを壊します):
- ワークスペースルートで
hyperframes init(またはAGENTS.md/CLAUDE.mdの生成)を実行しないでください。PROJECT_DIR内にhyperframes/サブプロジェクトを作成しないでください。 - すべてのサブエージェントディスパッチコンテキストには
PROJECT_DIR: <path>行が含まれます。サブエージェントはそれをプロジェクトルートとして扱います。 - cwdの規律(マスターも同様):すべてのBashコマンドは
(cd "$PROJECT_DIR" && ...)サブシェルとして実行されます —cd "$PROJECT_DIR" && ...と裸で実行しないでください(cwdが永続的にずれると、後の相対パスが間違ったものになります)。
ステップ0.5 - APIキーのガイダンス
スキップ条件:$PROJECT_DIR/.env が存在するか、context.log が空でない場合。それ以外の場合は、設定内容を検出し(HeyGen TTS = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials;ElevenLabs / Gemini = それぞれの環境キー)、その後 常に一時停止して確認してください — 動作可能な設定が検出された場合でも、自分だけで先に進まないでください:
検出内容:<サマリー>。クラウドキーはオプションです — それらがない場合、未設定のプロバイダーはローカルにフォールバックします(TTS -> HeyGenが設定されていない場合はKokoro。BGM -> MusicGen)。返信してください:
- キーを貼り付ける -> それを
$PROJECT_DIR/.envに書き込みます- "go" -> 現在の設定で続行します
- "skip" -> 未設定のものはローカルフォールバックで続行します
貼り付けられたキー -> $PROJECT_DIR/.env に書き込み/編集します。1行につき KEY=value を1つ(同名キーは上書きし、値を判断しません)。"go" / "skip" -> ステップ1へ。
ステップ1 - キャプチャ(フェーズ1)
- プロンプトから
SKILL_DIRと明示的なTARGET_URL(存在する場合)を解決します。ステップ0が実行されていることを確認します。 $PROJECT_DIR/context.logが存在する場合は読み取り、下の再開テーブルを使用して完了したフェーズをスキップします。- 入力を分類(ステップ1.0)して
CAPTUREとVO_MODEを設定し、一致するパスを実行します。両方のパスで同じ後続コマンドが共有されます。
ステップ1.0 - 入力の分類(CAPTURE + VO_MODE の設定)
| 入力の形状 | 行うこと |
|---|---|
| プロンプト内に明示的なURL | TARGET_URL = そのURL。CAPTURE=yes。音声に関する質問は不要(ナレーションはキャプチャされたサイトから取得)。パス(A)。 |
| ユーザーがスクリプトまたはブリーフを貼り付け/指示 | (1) そのままのテキストを $PROJECT_DIR/user_script.txt に保存。(2) 音声に関する質問を1回行う(下記)→ VO_MODE を設定。(3) スクリプトからキャプチャターゲットを解決(下記)→ CAPTURE を設定。 |
| トピック/ブリーフ。スクリプト散文も製品もなし | CAPTURE=no。音声に関する質問は不要。パス(B)。 |
音声に関する質問(ユーザーが実際のスクリプト散文を提供した場合のみ)— 1行で質問し、待機します:
あなたのスクリプトをそのままナレーションとして使用しますか、それとも再構成してより画面に適したシーンナレーションにしますか?
- そのまま — 元の文言を保持します。私はシーンを分割し、ビジュアルをペアリングするだけです。再生時間はスクリプトに従います。
- 再構成 — それをブリーフとして扱い、よりタイトなナレーションに書き直します。各シーン1-2文です。
VO_MODE = verbatim | restructure(デフォルト restructure)。ステップ2でストーリーデザインにスレッドされます。
スクリプトからのキャプチャターゲットの解決 — デフォルトでサイトを見つけてクロールします(実際のブランドトークンはプリセットフォールバックより優先されます)。ユーザーがオプトアウトした場合のみスキップします(「ウェブなし/テキストのみ/キャプチャなし」)。順序:(1) スクリプト内の明示的な http(s):// URL → それを使用、通知、CAPTURE=yes。(2) 明確なブランド/製品名 → WebSearch で公式サイトを検索、クロール前に解決されたURLをユーザーと1行で確認(拒否/信頼できるものがない → CAPTURE=no)。(3) 導出できない → CAPTURE=no。
キャプチャ + ユーザースクリプトの共存:クロールはブランドトークン + アセット + ビジュアルレジスタのみを提供します。ナレーションのスパインは
user_script.txtのまま(VO_MODEによって尊重され)であり、サイト自身のコピーではありません。
(A) キャプチャパス(CAPTURE=yes):
(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)
(B) キャプチャなしパス(CAPTURE=no) — 最小限のキャプチャパッケージを合成します。下流は同じです。あなた(マスター)がプリセットを選択(推測するサイトはありません。ユーザーの意図に基づいて19のプリセットから選択するか、1つの短い質問をします)。完全なスクリプト/ブリーフは visible-text.txt に入ります。colors:[] はプリセットパレットフォールバックをトリガーします(ユーザーがブランドカラーを指定した場合のみ colors を入力):
(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<brand/title>", "description": "<one-line>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<full user script / brief>" > capture/extracted/visible-text.txt)
ユーザーが既に最終的な
narrator_scripts.jsonを持っている場合は、それを$PROJECT_DIR/に配置してください。再開テーブルはストーリーデザインをスキップします。
両方のパスで共有される下流処理(パスBは build-design に --style <chosen-preset> を追加します。パスAは自動推論のために省略します):
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/derive-context-pack.mjs --capture ./capture)
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/design-system/scripts/build-design.mjs ./design-system --no-emit) # パスB:--style <chosen-preset> を追加
検証(不足がある場合は停止して報告。capture/BLOCKED.md が存在する場合、サイトがクロールをブロックしています — その中の指示に従ってください):
[ -
…
[翻訳のため省略]