はじめに: このスキルを最新に保つために — 実行前にユーザーに確認してください:
npx hyperframes skills update faceless-explainer。最新の状態であれば何も行われません。そうでなければ、このスキルと依存するコアドメインスキルを更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGenカタログのBGM/SFX/画像と、ブランドロゴを公式ソースから解決してください。既存のアセットを登録するには--adoptを実行します。詳細は/media-useスキルを参照。
Faceless ExplainerからHyperFramesへ
このスキルを使用すると、テキストの本文を解説動画に変換できます。デザインシステムを選択し、教育的なストーリーを計画し、HyperFramesでフレームごとに構築します。Faceless とは、すべてのビジュアルが後工程で発明されることを意味します — キャプチャステップはなく、実際のアセットインベントリもありません。
正面玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認し、その後にのみ続行してください。このスキルは 製品もキャプチャするウェブサイトもないテキストからのトピック解説 を目的としています。その他の意図、単なる「動画を作って」や不確かな場合は、最初に/hyperframesを読んでください — 意図レイヤーがすべてのルート決定を所有し、BRIEF.mdなしでここに来た新しい作成はとにかくそれを通過します(セットアップの開始ルール)。
あなたはオーケストレーターです。videos/<project>/ で作業します。ステップを順番に実行し、続行する前に各ゲートを通過してください。ユーザーゲートのステップは、ステップ0、ステップ3、ステップ6です。ステップ0の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートの種類と、BRIEF.md の flow/storyboard がステップ3/4/6のゲートを支配するモードをどのように導出するかが定義されています。ステップ5(フレームごとに1つのサブエージェントを派遣する)を除き、すべてのステップを自分で行ってください。デザインやモーションのルールはここに置かないでください。それらはフレームワーカーのサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative にあります。
ワークフロー: ステップ0 セットアップ → hyperframes.json; ステップ1 ブリーフ → capture/extracted/; ステップ2 デザインシステム → frame.md; ステップ3 ストーリーボード/スクリプト → STORYBOARD.md と SCRIPT.md; ステップ3.1 オーディオ → audio_meta.json; ステップ4 ビジュアルデザイン → 拡張された STORYBOARD.md; ステップ5 フレーム → compositions/frames/NN-*.html と index.html; ステップ6 最終レンダリング → renders/video.mp4。
ステップ0: セットアップ
目標: 確認済みのブリーフを携えて開始し、HyperFramesプロジェクトを作成し、ブリーフを永続化します。
ブリーフは意図レイヤーによって確認されます。ここでの質問によって確認されるわけではありません。 開始ルール、順に: (1) BRIEF.md が存在する → それを読み、何も質問しない — ブリーフは確定しており、その flow/storyboard がモードを導出します(ブリーフ契約 § 1)。(2) BRIEF.md はないがプロジェクトが存在する(ディスク上に hyperframes.json / STORYBOARD.md)→ ストーリーボードのフロントマターと記録されたプリファレンスから再開し、構築途中のプロジェクトに再び質問をしない。(3) どちらでもない — ここに直接到着した新規作成リクエスト → /hyperframes を読み、その意図レイヤー(references/intent-interview.md)を実行します: レシピと記憶されたデフォルトをチェックし、このルートの質問(../hyperframes/references/routes/faceless-explainer.md)を実施し、ロックされたブリーフを返します。編集リクエストはこれらすべてをスキップします — 編集を行ってください。
hyperframes.json がない場合のみ初期化します。<project> はトピックからケバブケースで命名します(例: compound-interest-explained)。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init はインストール済みのスキルをGitHub上の最新版と比較し、古いものがあればグローバルセットを更新します。
init後、<PROJECT_ROOT> を videos/<project> とし、後続のすべての相対パスコマンドを作業ディレクトリとしてそのディレクトリで実行します。以下のコマンドでは、. は <PROJECT_ROOT> を意味します。.media、capture、または出力ファイルを呼び出し元ディレクトリに書き込まないでください。
initの直後に BRIEF.md を書き込みます(絶対に前ではありません — init は空でないディレクトリを拒否します): 意図レイヤーのロックされたブリーフ、形状は ../hyperframes/references/brief-format.md に従います。<MEDIA_DIR> をインストール済みの /media-use スキルディレクトリに解決します。次に、各プリファレンスに基づく回答を node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . で記録します(brief-format.md がサブセットを指定します)。意図レイヤーがレシピを採用した場合、node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> を実行します。これにより、その frame.md がプロジェクトにコピーされ(ステップ2はスキップされます)、ステップ3のドラフトが作成されるスケルトンが返されます。レシピは回答を埋めますが、承認は埋めません。レビューゲートは引き続き実行されます。
セットアップを超えて進む前にサインインステータスを表示します — npx hyperframes auth status を実行し、その出力をそのまま中継します。これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、およびサインアウトしている場合のサインイン方法が報告されます。次のいずれかの分岐を適用します:
- 協調: ユーザーがサインインするか、明示的に
offline/goを選択するのを待ちます。 - 自律: ステータスを伝え、利用可能なローカルエンジンで続行します。
オフラインプロバイダーが存在しない場合に必要な機能を黙って省略しないでください。ブロッカーを表面化させてください。この決定を別の質問に折り込んだり、リポジトリごとの .env にキーを書き込んだりしないでください。認証の所有権とオフラインフォールバック: /media-use references/setup-providers.md § プロバイダー。
ゲート: hyperframes.json と BRIEF.md が存在する; プリファレンスに基づく回答が記録された(ブリーフ契約 § 2); サインインステータスが表示された(サインイン済み、またはオフラインで継続)。
ステップ1: ブリーフ(キャプチャなし)
目標: ユーザーのテキストを情報源としてプロジェクトに取り込みます。ウェブサイトのキャプチャも実際のアセットもありません — これは顔出し不要の解説動画です。
ユーザーの入力をそのまま保存し、次に手動で合成キャプチャパッケージを作成します:
capture/extracted/visible-text.txt— 記事全文/メモ/トピック/概要をそのまま。これは 情報 のソースであり、ストーリーテンプレートではありません(ステップ3で再形成します)。capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }。title/descriptionをブリーフから入力します。colors/fontsは、ユーザーが明示的にブランドカラーやフォントを指定した場合を除き、空のままにします — その場合は追加します(デザインプリセットは関係なく完全なパレットを提供します)。
ユーザーがスクリプトを貼り付けたり、自分の文言を保持したい場合は、user_script.txt としてそのまま保存します。VO_MODE(逐語的または再構成)は BRIEF.md から取得します — スクリプトが到着したときに意図レイヤーがそれを尋ねます。ブリーフになんらかの理由で欠けている場合のみ、ここで一度だけ尋ね、回答をステップ3のために保存します。
npx hyperframes capture は実行しないでください(URLはありません)。asset-descriptions.md を作成したり、capture/assets/ にデータを入力したりしないでください — 顔出し不要のビジュアルはステップ4-5で発明され、キャプチャされません。唯一の例外: ユーザーが実際の画像を提供した場合は、それを public/<basename> の下に配置し、ステップ3のためにメモします。
ゲート: capture/extracted/visible-text.txt と capture/extracted/tokens.json が存在する; 解説のトピックと対象読者を1つの明確な文で述べることができる。
ステップ2: デザインシステム
目標: 出荷済みのフレームプリセットを1つ選択します。スクリプトがそれをこの動画の frame.md + キャプションスキンに変換します。
BRIEF.md が style_preset を指定している場合 — ユーザーが意図レイヤーでショーケースを目視で選択したもの — それを使用します。判断を下すのはブリーフが沈黙している場合のみあなたです。次に、あなたが1つの判断を下します — どのプリセット: ../hyperframes-creative/references/design-spec.md を読み、../hyperframes-creative/frame-presets/ をブラウズします。トピック、トーン、対象読者に最も適したルックのプリセットを選択します。次に実行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
スクリプトは残りを決定論的に行います: プリセットの FRAME.md を frame.md にコピーし、capture/extracted/tokens.json のブランドトークンにリミックスします(ブランドカラーは役割ごとにプリセットのカラーキーにマッピングされ、プリセットの表示+本文フォントはブランドのものに置き換えられます)。プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します(マッピングが壊れていると終了コード1で終了)。終了コード0で終了したらすぐに進みます — 仕様の手動編集は行わないでください。
顔出し不要の解説動画には通常ブランドカラー/フォントはありません(tokens.json の colors/fonts は空)→ スクリプトはプリセット自身のパレット(完全に出荷可能なデザイン)を保持します。ユーザーがブランドカラー/フォントを指定した場合のみ、実行前に tokens.json に追加し、マッピングが本当に必要な場合にのみ、事後に frame.md を手動で調整します。
ゲート: build-frame.mjs が終了コード0で終了した — frame.md が指定されたプリセットから存在し、(プリセットが出荷する場合).hyperframes/caption-skin.html がキャプションスキンソースとして存在する; 選択されたプリセットがプリファレンスとして記録された(--key style_preset --workflow <このワークフロー>、ブリーフ契約 § 2)。
ステップ3: ストーリーボードとスクリプト
目標: テキストを承認されたフレーム単位の教育計画に変換します。
../hyperframes-creative/references/story-spine.md(フック言語、証拠より先に価値、提案としてのストーリーボード、ソース追跡可能なビジュアル)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes/references/storyboard-format.md、および ../hyperframes/references/script-format.md を読んでください。これらを使用して STORYBOARD.md を作成し、ナレーションが必要な場合は SCRIPT.md を作成します。フロントマターの duration: をブリーフの length から設定します — 大まかな期待値です。アセンブリは、実際のカットがそれに対してどこにあるかを報告します。
story-design.md を解説構造(コンセプト/ハウツー/リスト記事/ストーリー)、フック戦略、明確化テクニック、感情的なビート、タイプ列挙マッピング、および VO_MODE に使用します。動画のシーケンスはナラティブデザインから来ており、入力テキストの段落順ではありません — 並べ替え、マージ、省略、圧縮を行います。ソフトガイドとして、../hyperframes-animation/blueprints-index.md の役割→ブループリントメニューを参照します: 各ビートについて、その候補ブループリントが暗示する形状で音声を書き、該当する場合はその候補を blueprint: ID でタグ付けします。教育的真実がどのビートが存在するかを決定します — ブループリントに合わせるためにビートを強制したり、実績のある形状が利用可能だからといってビートを発明したりしないでください。顔出し不要のビジュアルは後工程で発明されるため、フレームはアセットインベントリを持ちません: ユーザーが実際の public/<basename> 画像を提供した場合を除き、asset_candidates は空のままにします。ストーリーボードとスクリプトのリファレンスから正確な必須フィールドを使用します。
ドラフト後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md § 1: 計画を提案として提示し、2つの質問をします — 承認するか変更するか、そしてスケッチを先に(推奨)するかスキップするか。フィードバックはチャット返信として届きます。承認されるまでループします。これはチェックポイントゲートです(ブリーフ契約 § 1): 自律モードでは尋ねることは何もありません — 同じサマリーをヘッズアップとして投稿し、続行します。スケッチはビルドに折り込まれ、唯一のプレビュー質問はステップ6で行われます。
ゲート: STORYBOARD.md が存在し、すべてのフレームに必要なナラティブフィールドがある; ナレーションが必要な場合 SCRIPT.md が存在する; ユーザーがフレームごとの計画を承認した(自律: サマリーがヘッズアップとして投稿された)。
ステップ3.1: オーディオ
目標: 承認されたスクリプトからナレーション、ワードタイミング、音楽、およびオーディオメタデータを生成します。
ステップ3の承認後、オーディオを開始します。バックグラウンドで実行し、その後ステップ4に進みます。(サインインステータスはステップ0ですでに表示されています。エンジンは自動的にフォールバックします。)
呼び出す前に、ユーザーのリクエストからナレーションボイスを選択します。 リクエストが声、性別、またはトーンを指定した場合、一致する音声IDを選択し、--voice <id> で渡します。パイプラインのデフォルトはそれ以外の場合 Marcia(女性) on HeyGen / am_michael on Kokoro です — そのため、「男性の声」のようなリクエストは、フラグを渡さない限り黙って無視されます。音声IDはプロバイダー固有です。ステップ0のサインインステータスが選択したプロバイダーに対して解決します: HeyGen(サインイン済み)は node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(または GET /v3/voices?engine=starfish)を介して; Kokoro(オフライン)は <MEDIA_DIR>/audio/references/tts.md の音声テーブル(am_/bm_ 男性、af_/bf_ 女性)を介して。ユーザーが好みを表明しなかった場合、パイプラインのデフォルトの前に記憶された音声(ブリーフ契約 § 2)にフォールバックし、使用したものを伝えます。どちらも指定されていない場合のみ --voice を省略します。ユーザーが今回の実行で明示的に音声を選択した場合、それを記録します(prefs.mjs record --key voice)。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
オーディオスクリプトは、ナレーション、ワードタイミング、HeyGenの音楽ライブラリからのBGM検索、およびタイミングメタデータを処理します。BGMのムードはストーリーボードの music: フィールドから取得します。これはHeyGen Audio APIを(生成ではなく)検索に使用し、TTSと同じ ~/.heygen 認証情報を使用します。プロバイダーの詳細については、../media-use/audio/references/tts.md を読んでください。
ナレーションがなく SCRIPT.md もない場合、音声生成をスキップします。ストーリーボードに音楽ムードがある場合、BGMは引き続き実行される可能性があります。
正規の完全無音マーカー(このオーディオモデルを再利用するワークフロー間で共有されます): STORYBOARD.md のトップYAMLブロックに music: none かつ SCRIPT.md がないこと。この組み合わせにより、プロジェクトは無音としてマークされます — ナレーションなし、BGMなし、SFXなし。audio.mjs はそれを認識し、何も生成しません(古い audio_meta.json を削除します。audio_meta.json がないことは、アセンブリが無音として扱うものです)。したがって、このステップはクリーンにスキップされます。ナレーションがある状態での music: none は、TTSを維持し、BGMのみをオフにします。この綴りを正確に使用してください — 他のマーカーを即興で作成しないでください。
ゲート: オーディオジョブが開始された、またはプロジェクトが無音としてマークされた(music: none + SCRIPT.md なし)。
ステップ4: フレームビジュアルデザイン
目標: 各ストーリーボードフレームに、ビジュアルの方向性、レイアウトの意図、およびモーションの選択を追加します。
最初にストーリーボードシートをスケッチします(協調モードのみ)。 計画が承認された瞬間に、スケッチパスを実行します — ../hyperframes/references/review-loop.md § 2(ステップ3.1を待つ必要はありません。スケッチはタイミングを使用しません): すべてのフレームを自分で storyboard.html のセルとしてワイヤーフレームします(`../hyperfram…
[truncated for translation]