まず、このスキルを最新に保ってください — 静かに実行し、尋ねないでください:
npx hyperframes skills update pr-to-video。すべてが最新の場合は高速なno-opです。それ以外の場合は、このスキルとそれに依存するコアドメインスキルを、それらに依存する前に更新します。
media-use: オーディオ/画像/ロゴを入手する前に、
/media-useを呼び出して、HeyGenカタログからBGM/SFX/画像を、公式ソースからブランドロゴを解決してください。最初に--adoptを実行して既存のアセットを登録します。/media-useスキルを参照してください。
PR to HyperFrames
このスキルを使用して、GitHubのプルリクエストを取り込み、変更を理解し、コード変更の解説動画を計画し、HyperFramesでフレームごとに構築します。入力はコード変更(gh経由で読み取り)であり、ウェブサイトではありません — キャプチャステップはなく、コントリビューターのアバター以外の実際のアセットもありません。
正面のドアは
/hyperframesです。 あなたはオーケストレーターです。各ステップを実行し、そのゲートを確認してから続行してください。このスキルはGitHubのプルリクエスト(コード変更)用です。その他の意図、単なる「動画作成」、または不確かな場合は、最初に/hyperframesを読んでください — 意図レイヤーがすべてのルート決定を所有し、BRIEF.mdなしでここに到着した新しい作成は、いずれにしてもそれを通過します(セットアップの開始ルール)。
あなたはオーケストレーターです。解決された外部のPROJECT_DIRで作業し、デフォルトでは呼び出し元リポジトリでは作業しないでください。ステップを順番に実行し、続行する前に各ゲートを通過してください。ユーザーゲートのステップは、ステップ0、ステップ3、およびステップ6です。ステップ0の前に../hyperframes-core/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>形式、またはチェックアウト済みリポジトリの「このPR」)を含む)を入力として受け取り、HyperFramesプロジェクトを作成し、ブリーフを永続化します。スタイルは常にコードエディトリアル(ステップ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-core/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またはローカルエンジンのどちらを使用するか、およびサインアウトしている場合のサインイン方法を報告します。1つのブランチを適用します:
- 協調的: ユーザーがサインインするか、明示的に
offline/goを選択するのを待ちます。 - 自律的: ステータスを述べ、利用可能なローカルエンジンで続行します。
オフラインプロバイダーが存在しない場合に、必要な機能を黙って省略しないでください。ブロッカーを表面化してください。この決定を別の質問に折りたたんだり、キーをリポジトリごとの.envに書き込んだりしないでください。認証の所有権とオフラインフォールバック: /media-use references/setup-providers.md § プロバイダー。
ゲート: hyperframes.jsonとBRIEF.mdが存在する。PR参照がブリーフにキャプチャされている。プリファレンスでバックアップされた回答が記録されている(ブリーフ契約§2)。サインインステータスが表示された(サインイン済み、またはオフラインで続行)。
ステップ 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に解決するため、エンドカードでバージョンをでっち上げる代わりに実際のバージョンを引用できます。次に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)
# 人々フロントの唯一のネットワークステップ — 各コントリビューターの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は常にベアなloginのみを提供します)はnullです。ステップ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は最善努力 — その欠如は失敗ではありません。
ステップ 2: デザインシステム
目標: コードエディトリアルフレームプリセットを採用します。スクリプトがそれをこの動画のframe.md + キャプションスキンに変換します。
スタイルは固定 — コードエディトリアル(温かみのあるエディトリアル。diff用に構築されたネイビーのコードサーフェス)。実行:
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がキャプションスキンソースとして存在する。
ステップ 3: ストーリーボードとスクリプト
目標: PRを承認されたフレームごとの説明計画に変換します。
../hyperframes-creative/references/story-spine.md(フック言語、証拠前の価値、提案としてのストーリーボード)、references/story-design.md、../hyperframes-animation/blueprints-index.md、../hyperframes-core/references/storyboard-format.md、および../hyperframes-core/references/script-format.mdを読んでください。それらを使用してSTORYBOARD.mdを作成し、ナレーションが必要な場合はSCRIPT.mdを作成します。フロントマターのduration:をブリーフのlengthから設定します — おおよその見積もり。アセンブリは、実際のカットがそれに対してどこに着地するかを報告します。
story-design.mdをPRのアーキタイプ(変更ログ / 新機能紹介 / 修正解説 / リファクタリングウォークスルー)、PRネイティブのフレームタイプ、フック、説得、ビート、フレームごとの単語予算、およびクレジットクローズに使用します。シーケンスはナラティブデザインから来ます。diffのファイル順ではありません — 変更を説明し、diffを読み上げないでください。ソフトガイドとして、../hyperframes-animation/blueprints-index.mdの役割→ブループリントメニューを参照してください。各ビートについて、候補ブループリントが暗示する形状でナレーションを書き、その候補のblueprint: idをタグ付けします(1つ適合する場合)。ストーリーの真実がどのビートが存在するかを決定します — 形状に合わせてビートを強制しないでください)。capture/diff.patchから2〜4つの実際のdiffハンクを特集し、それぞれ小さな読みやすいスニペットにします。各フレームのsceneに必要なcode-*ブロックに名前を付けます。フレームはcreditsクローズ(1〜6個のassets/<login>.pngアバター)を除いてasset_candidatesを持ちません。ストーリーボードとスクリプトのリファレンスから正確な必須フィールドを使用します。
ドラフト後、レビューループの計画パスを実行します — ../hyperframes-core/references/review-loop.md § 1: ボードを開き(実行するかどうか尋ねないでください — PROJECT_DIRからプレビューをバックグラウンドで実行します)、計画を提案として提示し、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_が女性)経由。ユーザーが好みを表明しなかった場合、パイプラインデフォルトの前に記憶されたボイス(ブリーフ契約§2)にフォールバックし、どちらを使用したかを述べてください。両方が名前を指定しない場合にのみ--voiceを省略します。ユーザーが今回の実行で明示的にボイスを選択した場合、記録してください。