media-use: オーディオ/画像のソーシングの前に、
/media-useを呼び出して、HeyGenカタログからBGM/効果音/画像を解決します。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。
PRからHyperFrames は何をしますか?
このスキルを使用して、GitHubプルリクエストを取り込み、変更を理解し、コード変更説明ビデオを計画し、HyperFramesでフレームごとに構築します。入力はコード変更(ghを介して読み取り)であり、ウェブサイトではありません。コントリビューターのアバター以外にキャプチャ手順や実際のアセットはありません。
ステップ0の前にルートを確認してください。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認してから続行します。このスキルはGitHubプルリクエスト(コード変更)用です。他の意図は別の場所にルーティングしてください。製品ローンチ/プロモーション →
/product-launch-video;一般的なウェブサイトツアー →/website-to-video;PRのないトピック説明 →/faceless-explainer;既存映像への字幕 →/embedded-captions;短いナレーションなしモーショングラフィック →/motion-graphics;リポジトリ全体または複数PRのリリースウォークスルー →/general-video。対象外: ライブ/レンダリング時のデータ。PRの事実は作成時に一度読み取られ、埋め込まれます。ユーザーが「ビデオを作って」とだけ言った場合、またはルートが不明な場合は、最初に/hyperframesを読んでください。
あなたはオーケストレーターです。videos/<project>/ディレクトリで作業します。ステップを順番に実行し、各ゲートを通過してから続行してください。ユーザーによるゲートがあるステップは、ステップ0、ステップ3、ステップ6です。ステップ5(各フレームに1つのサブエージェントを割り当てる)を除き、すべてのステップを自分で実行してください。デザインやモーションのルールはここに記載しないでください。それらはフレームワーカーのサブエージェント、hyperframes-creative、およびhyperframes-animationに存在します。
ワークフロー:ステップ0 セットアップ → hyperframes.json;ステップ1 取り込み → capture/extracted/ + assets/<login>.png;ステップ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:セットアップと概要
目標:PR参照とコアとなるビデオ概要を確定し、必要に応じてHyperFramesプロジェクトを作成します。
PR参照(完全なURL、<owner>/<repo>#<N>形式、またはチェックアウト済みリポジトリの「this PR」)を取得し、1つのメッセージで概要を確認します。各項目の推奨デフォルトを先頭に提示し、/hyperframesですでに設定されているものはプリフィルします:角度(changelog / feature-reveal / fix-explainer / refactor-walkthrough — デフォルト:PRから推測)、オーディエンス(デフォルト:開発者)、長さ(デフォルト:PRの変更サイズにスケーリング — 以下を参照)、アスペクト比(デフォルト16:9)、言語。スタイルは常にclaudeです。ユーザーが返信した後にのみ続行します。「go」はデフォルトを受け入れます。
長さを固定の推測ではなく、PRの変更サイズから推奨します。 概要を確認する前に、PRを一度覗き見します。これは読み取り専用の呼び出しであり、角度の根拠にもなります(ステップ1ではまだ完全な決定論的フェッチを行います):
gh pr view <PR_REF> --json title,additions,deletions,changedFiles
additions + deletionsからティアを選択し(changedFilesで微調整)、それをデフォルトとして先頭に提示します(ユーザーはオーバーライド可能;ハードキャップは約3分):
| PRの変更サイズ | 推奨長さ |
|---|---|
| 些細(≲ 50行変更) | 約20~40秒 |
| 焦点が絞られている(約50~200行) | 約40~70秒 |
| 相当量(約200~600行) | 約70~110秒 |
| 大規模(≳ 600行、または25+ファイル) | 約110~180秒 |
提案時にその根拠を一言で述べてください(例:「約40秒 — 小さな変更、+44/−13、12ファイルにわたって」)。PRが巨大でも、ビデオが長いとは限りません — ストーリーが1つの主要な変更であれば、コンパクトに保ち、その旨を伝えてください。
hyperframes.jsonがない場合のみ初期化します。<project>にPRからケバブケースで名前を付けます(例:acme-sdk-pr-1842)。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "videos/<project>" --non-interactive --example=blank — initはインストールされたスキルをGitHubの最新版と照合し、古いものがあればグローバルセットを更新します。
概要の前にサインインステータスを表示します — npx hyperframes auth statusを実行し、その出力を逐語的に中継します(言い換えたり書き換えたりしないでください)。 これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、およびサインインしていない場合のサインイン方法が報告されます。サインインしていない場合は、STOPしてユーザーが選択するのを待ちます — サインインするか、「go」/「offline」と言ってローカルエンジンで続行します。その後、概要などを尋ねます。 これは一時的なメモではなく、実際の意思決定ポイントとして扱ってください。選択を概要の質問に組み込んだり、キーをリポジトリごとの.envに書き込んだりしないでください。(自律モードでは、ステータスをメモしてオフラインで続行します。)正規のガイダンスについては、../hyperframes-media → Preflightを参照してください。
ゲート: hyperframes.jsonが存在する;PR参照がキャプチャされた;角度、長さ、アスペクト比、言語が確定した;サインインステータスが表示された(サインイン済み、またはオフラインで続行)。
ステップ1:PRの取り込み(キャプチャなし)
目標:PRの事実を取得し、プロジェクトに情報源として取り込みます。ウェブサイトのキャプチャはありません。 fetch-pr.mjsはghを決定論的に実行します — ページネーションされたgh apiを介してファイルリストを完了するため、大きなPRでも約100ファイルで切り捨てられず、capture/pr.json + capture/diff.patchのみを書き込みます(スクラッチディレクトリはなし)。次に、ingest.mjsがそれをオフラインで合成キャプチャパッケージに取り込みます。
PR="<url | owner/repo#N | N>"
# PRを決定論的に取得:ghを実行し、ページネーションされたgh apiを介してファイルリストを完了
# (大きなPRでも約100ファイルで切り捨てられない)、capture/pr.json +
# capture/diff.patchのみを書き込む — スクラッチディレクトリはなし。
# gh認証/見つからない/プライベートエラーはここでexit 1。
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# オフライン変換 → capture/extracted/{tokens.json(colors:[] → クロードパレット)、
# visible-text.txt(概要)、people.json(コントリビューター、ボットフィルター済み、avatarFile=assets/<login>.png)}
(cd "videos/<project>" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# peopleフロントの1つのネットワークステップ — 各コントリビューターのGitHubアバターをassets/<login>.pngにダウンロード
# オプションのクレジットクローズ用。ベストエフォート。常にexit 0。
(cd "videos/<project>" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
fetch-pr.mjsがexit 1の場合(gh認証/見つからない/プライベート)、そのstderrを報告して停止します — PR内容を作り出さないでください。ingest.mjsがexit 1の場合、そのstderrを読み(通常は不正なpr.json)、修正して再実行します(決定論的)。fetch-people-avatars.mjsは常にexit 0です。アバターがない場合は、作成者へのクレジットクローズがないことを意味するだけです。
ゲート: capture/pr.json、capture/diff.patch、capture/extracted/tokens.json、capture/extracted/visible-text.txt、およびcapture/extracted/people.jsonが存在する。PRの変更を1つの明確な文で説明できる。assets/<login>.pngはベストエフォート — 存在しなくても失敗ではありません。
ステップ2:デザインシステム
目標:claudeフレームプリセットを採用します。スクリプトがこれをこのビデオのframe.md + キャプションスキンに変換します。
スタイルは固定 — claude(温かみのあるエディトリアル;差分用に構築されたネイビーのコードサーフェス)。実行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset claude --hyperframes .
このスクリプトは、claudeプリセットのFRAME.mdをframe.mdにコピーし、capture/extracted/tokens.json内のブランドトークンにリミックスします(PRにはない → colors:[]/fonts:[]はclaude独自のパレットを保持し、完全なデザイン)、プリセットのキャプションスキンを.hyperframes/caption-skin.htmlにコピーし、自己検証します(マッピングが壊れているとexit 1)。exit 0になったらすぐに続行します — 手動編集は不要です。
ゲート: build-frame.mjsがexit 0 — frame.mdがclaudeプリセットから存在し、.hyperframes/caption-skin.htmlがキャプションスキンソースとして存在する。
ステップ3:ストーリーボードとスクリプト
目標:PRを承認されたフレームごとの説明計画に変換します。
references/story-design.md、../hyperframes-core/references/storyboard-format.md、および../hyperframes-core/references/script-format.mdを読みます。これらを使用して、STORYBOARD.mdと、ナレーションが必要な場合はSCRIPT.mdを作成します。
story-design.mdを使用して、PRのアーキタイプ(changelog / feature-reveal / fix-explainer / refactor-walkthrough)、PRネイティブなフレームタイプ、フック、説得、ビート、フレームごとの単語予算、オプションのクレジットクローズを決定します。順序はナラティブデザインに基づき、diffのファイル順ではありません — 変更を説明し、diffを読み上げないでください。capture/diff.patchから実際のdiffハンクを2~4つ選び、それぞれ小さな読みやすいスニペットにします。各フレームのsceneで希望するcode-*ブロックを指定します。フレームには、オプションのcreditsクローズ(assets/<login>.pngアバター2~6個)を除き、asset_candidatesはありません。ストーリーボードとスクリプトリファレンスの必須フィールドを正確に使用します。
ドラフト後、フレームごとの概要を表示します。同じメッセージでユーザーに(a)承認または変更要求、および(b)ストーリーボードのスキャフォールドのライブプレビューを希望するかどうか(npx hyperframes preview)を尋ねます — 「はい」の場合のみ開きます。承認されるまで反復します。プレビューの選択をステップ6に引き継ぎます。
ゲート: STORYBOARD.mdが存在し、すべてのフレームに必要なナラティブフィールドがあり、ナレーションが必要な場合はSCRIPT.mdが存在し、ユーザーが計画を承認した。
ステップ3.1:音声
目標:承認されたスクリプトからナレーション、単語タイミング、音楽、音声メタデータを生成します。
ステップ3の承認後に音声を開始します。バックグラウンドで実行し、その後ステップ4に続行します。
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
音声スクリプトは、ナレーション、単語タイミング、HeyGenの音楽ライブラリからのBGMルックアップ、タイミングメタデータを処理します。BGMのムードはストーリーボードのmusic:フィールドから取得します。これはHeyGen Audio APIを取得に使用し、生成には使用しません。また、TTSと同じ~/.heygen認証情報を使用します。プロバイダーの詳細については、../hyperframes-media/references/tts.mdを読んでください。
ナレーションがなく、SCRIPT.mdもない場合は、音声生成をスキップします。ストーリーボードに音楽ムードがある場合は、BGMが実行される可能性があります。
ゲート: 音声ジョブが開始されたか、プロジェクトがサイレントとしてマークされた。
ステップ4:フレームビジュアルデザイン
目標:各ストーリーボードフレームにビジュアルディレクション、レイアウト意図、モーションの選択を追加します。
STORYBOARD.mdをその場で編集します。別のストーリーボードを作成しないでください。色、タイポグラフィ、レイアウトの雰囲気、スタイルの情報源としてframe.mdを使用します。
references/visual-design.md、references/composition.md、references/motion-language.md、references/code-vocabulary.md、および../hyperframes-animation/を読みます。visual-design.mdを使用して、必須のフレームフィールドと必須の## Video directionブロック、およびコードビートがcode-*ブロックをそのfocalとして指定する方法を確認します。code-vocabulary.mdを使用して、ビートごとに適切なブロックを選択します(diff = code-diff、リファクタリング = code-morph、新しいコード = code-typing、…)。composition.mdをレイアウト/階層/焦点に使用し、motion-language.md + ../hyperframes-animation/を有効なエフェクトとブループリントIDに使用します。エフェクト名やブロック/ブループリントIDを発明しないでください。
すべてのフレームに対して、effectsやfocalやrolesを含む、必要なビジュアルとモーションフィールドを追加します。コードビートの場合、code-*ブロックをfocalとして指定し、effectsが周囲のクロードコードサーフェス(コードアニメーションは除く。コードアニメーションはブロックが所有します)の振り付けを行えるようにします。ビデオ全体に1つの## Video directionブロックを追加します。
ストーリー、スクリプト、transition_in、asset_candidates、またはPRソースを変更しないでください。このステップではHTMLを作成しません。アセットステージング手順はありません — 唯一の実際のアセットはクレジットアバターであり、すでにassets/にあります。
ゲート: すべてのフレームにeffectsとfocalやrolesがある;コードフレームがcode-*ブロックを指定している;## Video directionが存在する。
ステップ5:フレームの構築
目標:すべてのストーリーボードフレームをHTMLコンポジションとして構築し、再生可能なビデオを組み立てます。
音声が開始された場合は、ステップ3.1の音声が終了するのを待ちます。その後、継続時間を同期し、効果音を取得します。サイレントの場合は両方をスキップします。
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
継続時間の同期は機械的です。実際の音声の長さが優先され、サイレントフレームは推定値を保持し、同期された継続時間を手動で編集しないでください。
ディスパッチ前に、STORYBOARD.md全体で名前が付けられたレジストリブロックを一度プリインストールします。これにより、並列ワーカーがレジストリで競合するのを防ぎます:
for b in <each registry block named in the storyboard>; do npx hyperframes add "$b"; done
ディスパッチ前に、sub-agents/frame-worker.mdと../hyperframes-core/references/subagent-dispatch.mdを読みます。フレームごとに1つのサブエージェントをディスパッチします。可能であれば並列に、そうでなければワーカーをウェーブで実行します。各ワーカーは正確に1つのフレームを受け取ります。各ワーカーのコンテキストには、PROJECT_DIR、frame_id、キャンバスサイズ、キャプションが有効な場合のキャプションステータスとキープアウトバンド、ANIM_DIR(../hyperframes-animation/への絶対パス)、およびreferences/code-vocabulary.mdへの絶対パスを含める必要があります。各ワーカーは、frame.md、独自の## Frame Nブロック、引用された各エフェクト/ブループリントIDのレシピ本文、およびコードビートの場合は、名前付きブロックの入力用にcode-vocabulary.mdを読みます。各ワーカーはcompositions/frames/NN-*.htmlのみを書き込みます。ワーカーはSTORYBOARD.mdを編集しません。
各ワーカーが戻ってきたら、STORYBOARD.mdでそのフレームをanimatedとしてマークします。
音声タイミングが存在した後、バックグラウンドでキャプションを構築し、インデックスを組み立てます:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjsは、プロジェクトの.hyperframes/caption-skin.html(ステップ2でコピーされたclaudeのもの)を使用し、frame.mdからブランドトークンを注入します。captions: skipped (<reason>)は...