プラグインのインストール: セットアップやフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合はプラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。
まず、このスキルを最新に保つ — ユーザーに確認してから実行:
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 で読み取り)であり、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を使用するかローカルエンジンを使用するか、およびサインアウトしている場合のサインイン方法が報告されます。1つのブランチを適用します:
- 協調: ユーザーがサインインするか、明示的に
offline/goを選択するのを待ちます。 - 自律: ステータスを表示し、利用可能なローカルエンジンで続行します。
オフラインプロバイダーが存在しない場合に、必要な機能を黙って省略しないでください;ブロッカーを表面化します。この決定を別の質問に折りたたんだり、キーをリポジトリごとの .env に書き込んだりしないでください。認証の所有権とオフラインフォールバック: /media-use references/setup-providers.md § Providers。
ゲート: hyperframes.json と BRIEF.md が存在する;PR参照がブリーフにキャプチャされている;プリファレンスバックアップされた回答が記録された(ブリーフコントラクト § 2);サインインステータスが表示された(サインインしている、またはオフラインで続行している)。
ステップ1: PRの取り込み(キャプチャなし)
目標: PRの事実を取得し、情報源としてプロジェクトに組み込みます。Webサイトのキャプチャはありません。fetch-pr.mjs は gh を決定論的に実行します — ページネーションされた gh api によってファイルリストを完成させるため、大きなPRでも~100ファイルで切り詰められず、capture/pr.json + capture/diff.patch のみを書き込みます(スクラッチディレクトリなし)。マージされた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認証/未検出/プライベートエラーはここでexit 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)
# 人物フロントの1つのネットワークステップ — 各コントリビューターの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認証/未検出/プライベート)、その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 です。ステップ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の変更を1つの明確な文で述べることができる。assets/<login>.png はベストエフォート — その欠如は失敗ではありません。
ステップ2: デザインシステム
目標: code-editorialフレームプリセットを採用します;スクリプトがこれをこの動画の frame.md + キャプションスキンに変換します。
スタイルは固定されています — code-editorial(温かみのあるエディトリアル;差分用に設計されたネイビーコードサーフェス)。実行:
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 にコピーし、自己検証します(壊れたマッピングでexit 1)。exit 0になったらすぐに進む — 手動編集はしない。
ゲート: build-frame.mjs がexit 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 を使用します。シーケンスは ナラティブデザイン から来ており、差分のファイル順ではありません — 変更を説明し、差分を読み上げないでください。ソフトガイドとして、../hyperframes-animation/blueprints-index.md の役割→ブループリントメニューを参照します:各ビートについて、その候補ブループリントが暗示する形状でナレーションを書き、一致するブループリントがある場合はその候補の blueprint: IDをタグ付けします(ストーリーの真実がどのビートが存在するかを決定します — 形状に合わせてビートを強制しないでください)。capture/diff.patch から2〜4つの実際の差分ハンクを特徴とし、それぞれ小さな読みやすいスニペットにします;各フレームの 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_ 女性)を介して。ユーザーが好みを表明しなかった場合、パイプラインデフォルトにフォールバックする前に記憶されたボイスにフォールバックします(ブリーフコントラクト § 2)。
...
[切り詰められました]