プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順に従ってください。
まず、このスキルを最新に保つ — ユーザーに確認してから実行:
npx hyperframes skills update faceless-explainer。すべてが最新の場合は高速なno-op;そうでなければ、このスキルとそれに依存するコアドメインスキルを、使用する前に更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGenカタログからBGM/SFX/画像を、公式ソースからブランドロゴを解決します。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。
フェイスレス解説動画からHyperFramesへ
このスキルを使用して、テキストの本文を解説動画に変換します:デザインシステムを選択し、教育的なストーリーを計画し、HyperFramesでフレームごとに構築します。フェイスレスとは、すべてのビジュアルが後段で発明されることを意味します — キャプチャステップはなく、実際のアセットインベントリもありません。
正面玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認し、その後にのみ続行します。このスキルは、テキストからトピックを説明するためのものであり、キャプチャする製品やウェブサイトはありません。その他の意図、単なる「動画を作る」、または不確かな場合 → 最初に/hyperframesを読んでください — インテントレイヤーがすべてのルート決定を所有し、BRIEF.mdなしでここに到着した新しい作成は、とにかくそれを経由します(セットアップの開始ルール)。
あなたはオーケストレーターです。videos/<project>/ で作業します。ステップを順番に実行し、各ゲートを通過してから続行します。ユーザーゲートのステップは、ステップ0、ステップ3、ステップ6です。ステップ0の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートのタイプと、BRIEF.md の flow/storyboard がステップ3/4/6のゲートを支配するモードをどのように導出するかを定義しています。ステップ5を除くすべてのステップを自分で実行してください。ステップ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 <this 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で1つの質問を含む最終プレビューが行われます。
ゲート: STORYBOARD.md が存在し、すべてのフレームが必要なナラティブフィールドを持ち、ナレーションが必要な場合に SCRIPT.md が存在し、ユーザーがフレームごとの計画を承認した(自律モード:サマリーがヘッズアップとして投稿された)。
ステップ3.1: オーディオ
目標: 承認されたスクリプトから、ナレーション、ワードタイミング、音楽、およびオーディオメタデータを生成します。
ステップ3の承認後にオーディオを開始します。バックグラウンドで実行し、その後ステップ4に進みます。(サインインステータスはステップ0ですでに表示されています;エンジンは自動的にフォールバックします。)
呼び出す前に、ユーザーのリクエストからナレーションボイスを選択します。 リクエストが声、性別、またはトーンを指定した場合、一致するボイスIDを選択し、--voice <id> で渡します。パイプラインデフォルトはそれ以外の場合はMarcia (女性)(HeyGen上)または am_michael(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: フレームビジュアルデザイン
目標: 各ストーリーボードフレームに、ビジュアルの方向性、レイアウトの意図、モーションの選択を追加します。
ストーリーボードシートをスケッチします
...