プラグインインストール: セットアップやフレッシュネスコマンドの前に、このスキルが HyperFrames プラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順を維持します。
まず、このスキルを最新に保ってください — 実行前にユーザーに確認してください:
npx hyperframes skills update pr-to-video。すべてが最新の場合は高速で何も起こりません。そうでない場合、このスキルとそれが依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ・画像・ロゴを調達する前に、
/media-useを呼び出して、HeyGen カタログからの BGM/SFX/画像と、公式ソースからのブランドロゴを解決してください。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。ホストアプリが独自の音楽や効果音ツールを提供している場合は、そちらを音楽や効果音に使用してください。
PR から HyperFrames へ
このスキルを使用して、GitHub プルリクエストを取り込み、変更を理解し、コード変更の解説動画を計画し、HyperFrames でフレームごとに構築します。入力は コード変更 (gh 経由で読み取り) であり、Webサイトではありません — キャプチャステップや実際のアセットは、コントリビューターのアバター以外にはありません。
正面玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認し、その後でのみ続行します。このスキルは GitHub プルリクエスト (コード変更) 用です。それ以外の意図、単なる「動画を作成」、または不明な場合 → 最初に/hyperframesを読んでください — インテント層がすべてのルート決定を所有し、BRIEF.mdなしでここに到着した新規作成も結局はそれを通過します (セットアップの開始ルール)。
あなたはオーケストレーターです。デフォルトでは呼び出し元リポジトリではなく、解決された外部 PROJECT_DIR で作業します。ステップを順番に実行し、続行する前に各ゲートを通過してください。ユーザーがゲートするステップは、ステップ 0、ステップ 3、およびステップ 6 です。ステップ 0 の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートタイプと、BRIEF.md の flow/storyboard がステップ 3/4/6 のゲートを管理するモードをどのように導出するかが定義されています。ステップ 5 を除き、すべてのステップを自分で実行してください。ステップ 5 では、制限されたフレームワーカーのプールをディスパッチします。設計やモーションのルールはここには配置しないでください。それらはフレームワーカーサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative にあります。
ワークフロー: ステップ 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 参照 (完全な URL、<owner>/<repo>#<N> 参照、またはチェックアウト済みリポジトリ内の "this PR") を含む — を入力として受け取り、HyperFrames プロジェクトを作成し、ブリーフを永続化します。スタイルは常に code-editorial (ステップ 2 で固定され、尋ねられることはありません)。
ブリーフは、ここでの質問ではなく、インテント層によって確認されます。 開始ルール、順序: (1) BRIEF.md が存在する → それを読み、何も尋ねない — ブリーフは確定しており、その flow/storyboard がモードを導出します (ブリーフ契約 § 1)。(2) BRIEF.md はないが、プロジェクトが存在する (ディスク上に hyperframes.json / STORYBOARD.md がある) → ストーリーボードのフロントマターと記録された設定から再開します。途中まで構築されたプロジェクトに再び質問をすることは決してありません。(3) どちらでもない — ここに直接到着した新規作成リクエスト → /hyperframes を読み、そのインテント層 (references/intent-interview.md) を実行します: レシピと記憶されたデフォルトをチェックし、このルートの質問を実施します — PRサイズ → 長さのドクトリンを含み、これは全体が ../hyperframes/references/routes/pr-to-video.md にあります — その後、ロックされたブリーフを返します。編集リクエストはこれらすべてをスキップします — 編集を行ってください。
他の作業を行う前に、プロジェクトディレクトリを解決してください。ユーザーが指定したプロジェクトディレクトリを保持します。それ以外の場合は、リゾルバーによって出力された永続的な外部キャッシュの場所を使用します。呼び出し元リポジトリ内に videos/ を作成しないでください:
PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs
機能の事前チェックは、フェッチ、ストーリー作業、オーディオ、またはフレームディスパッチの前に実行されます。インストールされた CLI がこのスキルに必要な検証コマンドを実行できない場合は、コンテキストを使い果たす前に、アップグレード手順を表示して停止します。
$PROJECT_DIR/hyperframes.json がない場合にのみ初期化します。そのベース名は PR から取得され、例: acme-sdk-pr-1842。ワークスペース名やタイムスタンプは使用しないでください。
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init はインストールされたスキルを GitHub 上の最新と比較し、いずれかが古い場合はグローバルセットを更新します。
以下のすべての相対パスコマンドは、$PROJECT_DIR を作業ディレクトリとして実行します。明示的なサブシェルのない例は (cd "$PROJECT_DIR" && …) を意味します。呼び出し元リポジトリの作業ツリーを変更しないでください。
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 が存在する。PR 参照がブリーフに捕捉されている。設定に基づく回答が記録された (ブリーフ契約 § 2)。サインインステータスが表示された (サインインしている、またはオフラインで続行)。
ステップ 1: PR の取り込み (キャプチャなし)
目標: PR の事実を取得し、情報源としてプロジェクトに取り込みます。Webサイトのキャプチャはありません。 fetch-pr.mjs は gh を決定論的に実行します — ページネーションされた gh api でファイルリストを完了させるため、大規模な PR でも約 100 ファイルで切り詰められることはなく、capture/pr.json + capture/diff.patch のみを書き込みます (スクラッチディレクトリなし)。MERGED PR の場合、ベストエフォートの shipped_version (+ version_source) も pr.json に解決するため、エンドカードで実際のバージョンを引用でき、 invent する必要がありません。次に ingest.mjs がそれをオフラインで合成キャプチャパッケージに取り込みます。
PR="<url | owner/repo#N | N>"
# PR を決定論的に取得: gh を実行し、ページネーションされた
# gh api でファイルリストを完了させる (そのため大きな PR でも約 100 ファイルで切り詰められない)、
# capture/pr.json + capture/diff.patch のみを書き込む — スクラッチディレクトリなし。
# gh auth / not-found / private エラーはここで終了コード 1 で終了する。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# オフライン変換 → capture/extracted/{tokens.json (colors:[] → code-editorial パレット)、
# visible-text.txt (ブリーフ)、people.json (コントリビューター、ボットフィルター済み、name+login、
# avatarFile=assets/<login>.png)}。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# ピープルフロントの唯一のネットワークステップ — 各コントリビューターの GitHub アバターを
# assets/<login>.png にダウンロードし、クレジットクローズで使用する。ベストエフォート; 常に終了コード 0。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
fetch-pr.mjs が終了コード 1 (gh auth / not-found / private) で終了した場合、その stderr を報告して停止します — PR の内容をでっち上げないでください。ingest.mjs が終了コード 1 で終了した場合、その stderr を読み (通常は不正な pr.json)、修正して再実行します (決定論的)。fetch-people-avatars.mjs は常に終了コード 0 で終了します。アバターがないということは、単に作者へのクレジットクローズがないことを意味します。
people.json は、gh がすでに名前を付けているコントリビューター (PR 作成者、コミット作成者、mergedBy) については name を保持し、残り (レビュアー/コメンター/アサイン、gh pr view は裸の login しか与えない) については null を保持します。ステップ 3 でクレジットクローズを書き込む前に、そのフレームに実際に登場する 1〜6 人のユーザーの null の名前を自分で解決してください: gh api users/<login> --jq .name (gh はすでにあるため、これをスクリプト化する必要はありません)。GitHub にもそのユーザーの公開名がない場合は、画面上ではログインにフォールバックし、その人を音声ラインから削除します (story-design.md のクレジットセクションを参照 — ナレーションは名前を言わなければならず、生のハンドルを使ってはいけません)。
ゲート: capture/pr.json、capture/diff.patch、capture/extracted/tokens.json、capture/extracted/visible-text.txt、および capture/extracted/people.json が存在する。PR の変更内容を明確な一文で述べることができる。assets/<login>.png はベストエフォート — 存在しなくても失敗ではありません。
ステップ 2: デザインシステム
目標: code-editorial フレームプリセットを採用します。スクリプトがこれをこの動画の frame.md + キャプションスキンに変換します。
スタイルは固定されています — code-editorial (温かみのあるエディトリアルスタイル; ダークネイビーのコード面で、diff 用に構築されています)。実行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
このスクリプトは、code-editorial プリセットの FRAME.md を frame.md にコピーし、capture/extracted/tokens.json 内の任意のブランドトークンにリミックスします (PR にはない → colors:[]/fonts:[] は code-editorial 自身のパレット、完全なデザインを保持します)、プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します (マッピングが壊れていると終了コード 1 で終了)。終了コード 0 で終了したらすぐに進みます — 手動編集は行いません。
ゲート: build-frame.mjs が終了コード 0 で終了した — frame.md が code-editorial プリセットから存在し、.hyperframes/caption-skin.html がキャプションスキンソースとして存在する。
ステップ 3: ストーリーボードとスクリプト
目標: PR を承認されたフレームごとの説明計画に変換します。
../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 から設定します — 大まかな期待値; アセンブリはそのカットがどこに着地するかを報告します。
PR のアーキタイプ (changelog / feature-reveal / fix-explainer / refactor-walkthrough)、PR ネイティブのフレームタイプ、フック、説得、ビート、フレームごとの単語予算、およびクレジットクローズには story-design.md を使用します。シーケンスは diff のファイル順ではなく、ナラティブデザイン から来ます — 変更を説明し、diff をそのまま読み上げないでください。ソフトガイドとして、../hyperframes-animation/blueprints-index.md のロール→ブループリントメニューを参照してください: 各ビートについて、候補のブループリントが暗示する形状でナレーションを書き、1 つ適合する場合はその候補の blueprint: id をタグ付けします (ストーリーの真実がどのビートが存在するかを決定します — ビートを形状に無理やり合わせないでください)。実際の diff ハンクを 2〜4 つ (capture/diff.patch から) フィーチャーし、それぞれを小さな読みやすいスニペットにします。フレームの scene でそれぞれが必要とする code-* ブロックに名前を付けます。フレームは、credits クローズ (1〜6 個の assets/<login>.png アバター) を除いて、asset_candidates を持ちません。ストーリーボードとスクリプトのリファレンスから正確な必須フィールドを使用します。
下書き後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md の § 1: 計画を提案として提示し、2 つの質問をします — 承認するか変更するか、そして スケッチを先に (推奨) かスキップするか。フィードバックはチャット返信として届きます。承認されるまでループします。これは チェックポイントゲート です (ブリーフ契約 § 1): 自律モードでは尋ねることは何もありません — 同じサマリーをヘッズアップとして投稿して進みます。スケッチはビルドに折り込まれ、1 つの質問を含む最終プレビューはステップ 6 で行われます。
ゲート: STORYBOARD.md が存在し、すべてのフレームに必要なナラティブフィールドがある。ナレーションが必要な場合に SCRIPT.md が存在する。ユーザーが計画を承認した (自律モード: サマリーがヘッズアップとして投稿された)。
ステップ 3.1: オーディオ
目標: 承認されたスクリプトから、ナレーション、単語タイミング、音楽、およびオーディオメタデータを生成します。
ステップ 3 の承認後にオーディオを開始します。バックグラウンドで実行し、その後ステップ 4 に進みます。
呼び出す前に、ユーザーのリクエストからナレーションボイスを選択してください。 リクエストが声、性別、またはトーンを指定した場合は、一致するボイス ID を選択し、--voice <id> で渡します。パイプラインのデフォルトは、それ以外の場合は HeyGen では Marcia (女性) / Kokoro では am_michael です — そのため、「男性の声」のようなリクエストは、フラグを渡さない限り黙って無視されます。ボイス 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_ が女性)。
...