最初に、このスキルを最新に保ってください — ユーザーに確認してから実行:
npx hyperframes skills update pr-to-video。すべてが最新の場合は高速に何も行いません。そうでない場合は、このスキルと、それが依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ/画像/ロゴを調達する前に、
/media-useを呼び出して、HeyGenカタログからBGM/SFX/画像を、ブランドロゴを公式ソースから解決します。既存のアセットを登録するには、最初に--adoptを実行します。/media-useスキルを参照してください。
PR to HyperFrames
このスキルは、GitHubプルリクエストを読み込み、変更を理解し、コード変更の解説動画を計画し、HyperFramesでフレームごとに構築するために使用します。入力は コード変更(gh 経由で読み取る)であり、ウェブサイトではありません — キャプチャステップはなく、コントリビューターのアバター以外の実際のアセットはありません。
玄関は
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認し、それから先に進みます。このスキルは GitHubプルリクエスト(コード変更)用です。他の意図、「動画を作って」というだけのリクエスト、または不確かな場合は、最初に/hyperframesを読んでください — インテントレイヤーがすべてのルートの決定を所有し、BRIEF.mdなしでここに来た新しい作成は、いずれにせよそこを通ります(Setupの開始ルール)。
あなたはオーケストレーターです。解決された外部の PROJECT_DIR で作業し、デフォルトでは呼び出し元のリポジトリでは作業しません。ステップを順番に実行し、各ゲートを通過してから続行します。ユーザーゲートのステップは、Step 0、Step 3、およびStep 6です。Step 0の前に ../hyperframes/references/brief-contract.md を読んでください — ゲートタイプと、BRIEF.md の flow/storyboard が、Step 3/4/6のゲートを支配するモードをどのように導出するかを定義しています。Step 5を除くすべてのステップを自分で実行します。Step 5では、バインドされたフレームワーカーのプールをディスパッチします。設計やモーションのルールはここに置かず、フレームワーカーのサブエージェント、このスキルのローカル ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/、および hyperframes-creative に置いてください。
ワークフロー: Step 0 セットアップ → hyperframes.json; Step 1 インジェスト → capture/extracted/ + assets/<login>.png; Step 2 デザインシステム → frame.md; Step 3 ストーリーボード/スクリプト → STORYBOARD.md と SCRIPT.md; Step 3.1 オーディオ → audio_meta.json; Step 4 ビジュアルデザイン → 拡張された STORYBOARD.md; Step 5 フレーム → compositions/frames/NN-*.html と index.html; Step 6 最終レンダリング → renders/video.mp4。
Step 0: セットアップ
目標: 確認済みのブリーフ(PR参照 — 完全なURL、<owner>/<repo>#<N> 形式の参照、またはチェックアウトされたリポジトリ内の "this PR" を含む)を入力として、HyperFramesプロジェクトを作成し、ブリーフを永続化します。スタイルは常に コードエディトリアル です(Step 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 がプロジェクトにコピーされ(Step 2はスキップされます)、Step 3のドラフトが基づくスケルトンが返されます。レシピは回答を埋めますが、承認は埋めません。レビューゲートは引き続き実行されます。
Setupを通過する前にサインインステータスを表示します — npx hyperframes auth status を実行し、その出力をそのまま中継します。これにより、音声/BGMがHeyGenを使用するかローカルエンジンを使用するか、およびサインアウトしている場合のサインイン方法が報告されます。以下のいずれかの分岐を適用します:
- 協調的: ユーザーがサインインするか、
offline/goを明示的に選択するのを待ちます。 - 自律的: ステータスを述べ、利用可能なローカルエンジンで続行します。
オフラインプロバイダーが存在しない場合に、必要な機能を黙って省略しないでください。ブロッカーを表面化させてください。この決定を別の質問に折り込んだり、リポジトリごとの .env にキーを書き込んだりしないでください。認証の所有権とオフラインフォールバックについては、/media-use references/setup-providers.md § Providersを参照してください。
ゲート: hyperframes.json と BRIEF.md が存在する。PR参照がブリーフにキャプチャされている。プリファレンスバックアップの回答が記録されている(ブリーフ契約 § 2)。サインインステータスが表示されている(サインイン済み、またはオフラインで継続中)。
Step 1: PRをインジェストする(キャプチャなし)
目標: PRの事実を取得し、情報源としてプロジェクトに取り込みます。ウェブサイトのキャプチャはありません。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エラーはここでexit 1になります。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# オフライン変換 → capture/extracted/{tokens.json (colors:[] → コードエディトリアルパレット),
# 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)
# peopleフロントの唯一のネットワークステップ — 各コントリビューターのGitHubアバターを
# assets/<login>.png にダウンロードし、クレジットクローズで使用します。ベストエフォート、常にexit 0。
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
fetch-pr.mjs がexit 1の場合(gh auth / not found / private)、そのstderrを報告し停止します — PR内容を捏造しないでください。ingest.mjs がexit 1の場合、そのstderr(通常は不正な pr.json)を読み、修正し、再実行します(決定論的)。fetch-people-avatars.mjs は常にexit 0です。アバターが欠落している場合は、著者へのクレジットクローズがないことを意味するだけです。
people.json は、gh がすでに名前を特定しているコントリビューター(PR作成者、コミット作成者、mergedBy)には name を持ちます。残り(レビュアー/コメンター/アサイン、gh pr view はログインのみを返す)は null です。Step 3でクレジットクローズを書き込む前に、そのフレームに実際に表示される1〜6人の null nameを自分で解決します: 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の変更を1つの明確な文で述べることができる。assets/<login>.png はベストエフォートです — その欠如は失敗ではありません。
Step 2: デザインシステム
目標: コードエディトリアルフレームプリセットを採用します。スクリプトがこれをこの動画の frame.md + キャプションスキンに変換します。
スタイルは固定されています — コードエディトリアル(温かみのあるエディトリアル。差分用に作られたネイビーのコード面)。以下を実行:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
このスクリプトは、コードエディトリアルプリセットの FRAME.md を frame.md にコピーし、capture/extracted/tokens.json 内の任意のブランドトークンにリミックスします(PRにはない → colors:[]/fonts:[] はコードエディトリアル自身のパレット、完全なデザインを保持します)、プリセットのキャプションスキンを .hyperframes/caption-skin.html にコピーし、自己検証します(壊れたマッピングではexit 1)。exit 0になったらすぐに進めます — 手動編集は不要です。
ゲート: build-frame.mjs がexit 0 — frame.md がコードエディトリアルプリセットから存在し、.hyperframes/caption-skin.html がキャプションスキンソースとして存在する。
Step 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 から設定します — 大まかな期待値です。アセンブリは、カットがそれに対してどこに着地するかを報告します。
story-design.md を、PRアーキタイプ(changelog / feature-reveal / fix-explainer / refactor-walkthrough)、PRネイティブのフレームタイプ、フック、説得、ビート、フレームごとの単語予算、およびクレジットクローズに使用します。シーケンスは ナラティブデザインから来ます。diffのファイル順ではありません — 変更を説明し、diffを読み上げないでください。ソフトガイド として、../hyperframes-animation/blueprints-index.md のロール→ブループリントメニューを参照します:各ビートについて、その候補ブループリントが暗示する形状でナレーションを書き、該当する場合はその候補 blueprint: id をタグ付けします(ストーリーの真実がどのビートが存在するかを決定します — 形状に合わせてビートを強制しないでください)。capture/diff.patch から2〜4の実際のdiffハンクをフィーチャーし、それぞれ小さな読みやすいスニペットにします。各フレームの scene で必要な code-* ブロックを指定します。フレームは、credits クローズ(1〜6個の assets/<login>.png アバター)を除いて、asset_candidates を持ちません。ストーリーボードとスクリプトのリファレンスから正確な必須フィールドを使用します。
ドラフト後、レビューループの計画パスを実行します — ../hyperframes/references/review-loop.md § 1: 計画を提案として提示し、2つの質問をします — 承認するか変更するか、そしてスケッチを先に(推奨)またはスキップするか。フィードバックはチャット返信として届きます。承認されるまでループします。これはチェックポイントゲートです(ブリーフ契約 § 1): 自律モードでは質問するものは何もありません — 同じ要約をヘッズアップとして投稿し、続行します。スケッチはビルドに折り込まれ、唯一のプレビュー質問はStep 6で行われます。
ゲート: STORYBOARD.md が存在する。すべてのフレームに必要なナラティブフィールドがある。ナレーションが必要な場合、SCRIPT.md が存在する。ユーザーが計画を承認した(自律モード: 要約がヘッズアップとして投稿された)。
Step 3.1: オーディオ
目標: 承認されたスクリプトからナレーション、単語タイミング、音楽、およびオーディオメタデータを生成します。
Step 3の承認後にオーディオを開始します。バックグラウンドで実行し、Step 4に進みます。
呼び出す前に、ユーザーの要望からナレーションボイスを選択します。 リクエストが声、性別、またはトーンを指定した場合、一致するボイスIDを選択し、--voice <id> で渡します。パイプラインデフォルトは、HeyGenでは Marcia(女性)、Kokoroでは am_michael です — そのため、「男性の声」のようなリクエストは、フラグを渡さない限り黙って無視されます。ボイスIDはプロバイダー固有です。Step 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 ./STOR
…
[翻訳のために切り詰められました]