動画作成 — 初心者から完成MP4までのスキル
2つのフェーズ、8つのシーケンシャルゲート。各ゲートは具体的な成果物を生成し、次のゲートがそれを消費します。ゲートをスキップしないでください。
このスキルを使用するタイミング — そしてハンドオフするタイミング
このスキルを使用するタイミング:
- ユーザーがHyperFramesを初めて使用し、コンセプト、スクリプト、またはアウトラインから開始する場合
- ユーザーがエンドツーエンドのウォークスルーを希望し、フレームワークのリファレンス資料を求めていない場合
- ユーザーがまだフォーマットを決めていない場合
ハンドオフするタイミング:
- ユーザーがURLを貼り付け、そのサイトから動画を作成したい場合 →
/website-to-hyperframesを呼び出す - ユーザーが明示的に9:16縦型トークヘッド(顔カメラ+シーンオーバーレイ)を希望する場合 → ゲート1~4を実行し、ゲート5以降は
/short-form-videoを呼び出す - ユーザーが動画ではなくフレームワークのルールを尋ねてきた場合 →
/hyperframesを呼び出す
2つのフェーズ
- フェーズ1 — インタビュー(ゲート1~4): コードに触れる前にすべてを収集するための1回の会話パス。意図、フォーマット、スクリプト、音声、スタイル、アセット、ペーシング。
BRIEF.mdにまとめ、明示的な承認を待ちます。 - フェーズ2 — ビルド(ゲート5~8): スキャフォールド → ストーリーボード → コンポジション → リンター → スタジオプレビュー → ドラフトレンダリング → 視覚確認 → MP4プレビュー → 最終レンダリング。
ゲート1 · 意図とフォーマット
AskUserQuestion を使用して一度に1つの質問をし、可能な限り選択式にします。
- この動画の目的は?(プロモーション · ソーシャル広告 · ローンチティーザー · 製品デモ · チュートリアル · 解説 · イントロ/アウトロカード · その他)
- ターゲット視聴者は?(自由記述)
- 目標尺は?(10~20秒のショート · 20~45秒のプロモーション · 45~90秒の解説 · 1.5~3分のレッスン · カスタム)
- アスペクト比は?(16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- フレームレートは?(30 デフォルト · 60 crispなUI · 24 シネマティック)
- プラットフォーム/配信制約は?(ファイルサイズ · 期限 · 再生環境)
ゲート条件: 上記6つすべてを取得。回答が9:16+顔カメラの場合、ゲート5で /short-form-video へのハンドオフを計画します。
全質問バンク: Read: references/interview-questions.md
ゲート2 · スクリプトと音声
- スクリプトのソースは?(ペースト · アウトライン → 私が下書き · 私が録音 · テキストからTTS · ナレーションなし)
- TTSの場合:音声の好み。
npx hyperframes tts --helpから選択肢を提示。ペースも取得。 - 顔カメラの場合:録画パス · フルスクリーンかコーナー配置か · 文字起こしが必要か?(
npx hyperframes transcribe <file> --model small.en --json) - キャプション?(オフ · ハイプ · コーポレート · カラオケ単語単位 · ミニマル)
ゲート条件: スクリプト(または下書き)取得、音声計画取得、キャプション計画取得。
ゲート3 · スタイルインテーク
ユーザーに質問する前に、既存のアセットを棚卸しします。 <workspace-root>/assets/ とプロジェクトの assets/ フォルダを確認します。すでにあるものを尋ねないでください。
その後、段階的に質問します — すべてに答える必要はありません:
- スタイルガイドやブランドドキュメントは?(パスをペースト · なし)
- カラーパレットは?(16進数コード · なし — MOTION_PHILOSOPHYのデフォルトを使用)
- フォントは?(Google Fonts名 · ファイルパス · なし — Inter + JetBrains Monoのデフォルトを使用)
- ロゴファイルは?(パス · なし — 代わりにテキストワードマークを使用)
- 雰囲気の参考動画は?(URL/パス · なし)
- その他のアセットは?(スクリーンショット · 商品写真 · Bロール · 音楽 — パスをリスト)
- MOTION_PHILOSOPHYの美学(黒いキャンバス · クロームタイプ · パースペクティブグリッド · ホイップトランジション)または別の雰囲気?
- ペーシングは?(キネティック 1~2秒 · バランス 2~3秒 · リラックス 3~5秒)
- 音楽は?(なし · アンビエントパッド 0.15 · 音楽ベッド 0.4 · フル 0.8 — 持っている場合はファイルパス)
- アウトロ/コールトゥアクションテキストは?
ユーザーにブランドを押し付けないでください。 ユーザーがスタイルの提供を明示的に辞退した場合にのみ、MOTION_PHILOSOPHYのデフォルトにフォールバックします。
完全なスタイルフロー+MOTION_PHILOSOPHYデフォルト: Read: references/style-intake.md
ゲート4 · ブリーフ統合(ビルド前のハードゲート)
MOTION_PHILOSOPHY.mdを読む — ワークスペースルートに存在する場合は必須。存在しない場合は、references/style-intake.mdのデフォルトで進め、その旨をブリーフに記載します。- プロジェクトの保存場所を尋ねる(自明でない場合):
video-projects/が存在する場合 →video-projects/<スラッグ>/を使用- それ以外の場合 → ユーザーに尋ねる
<project-folder>/BRIEF.mdを書く:- スラッグ · 意図 · 視聴者 · 寸法 · fps · 尺
- スクリプト(全文またはアウトライン)
- 音声選択 · キャプション計画 · 顔カメラ計画
- スタイルプロファイル:パレット(16進数)、フォント、ロゴパス、参考動画
- ペーシング
- アセットインベントリ(パス付き)
- アウトロ/CTAテキスト
- ブリーフを表示。明示的な承認を待つ。 「はい、作ってください」という明確な承認なしにゲート5に進まないでください。
ゲート5 · スキャフォールドとストーリーボード
まずハンドオフチェック
ブリーフが9:16縦型トークヘッド(顔カメラ+シーンオーバーレイ)を説明している場合、今すぐ /short-form-video を呼び出し、ブリーフを引き渡します。このスキルの4層スキャフォールドはそのフォーマット用に設計されています。
それ以外の場合は続行:
スキャフォールド
mkdir <project-folder>- 同様のフォーマットの兄弟プロジェクトが存在する場合、その
hyperframes.json+meta.jsonをテンプレートとしてコピーすることを提案します。それ以外の場合はフォルダ内から:npx hyperframes init meta.jsonをユーザーのスラッグ、寸法、fpsで編集します。- 提供されたアセットを
<project-folder>/assets/にコピーします。 - ゲート3から
<project-folder>/assets/style-profile.mdを作成 — パレット/フォント/ロゴの単一情報源。
ストーリーボード
references/storyboard-template.md のテンプレートを使用して <project-folder>/STORYBOARD.md を生成します。すべてのビートは以下を取得します:
ビート N — タイトル(開始–終了、尺) — 一行でのコンセプト
視覚要素: [各要素、サイズ、アニメーション、タイミング]
モーション言語: [動きの種類]
使用イーズ: [3~4つの異なるGSAPイーズ]
終了: [次のビートへのトランジション]
オーディオ: [VOライン / SFX / 音楽レイヤー]
ファイルの先頭:シーン · 開始 · 尺 · コンポジションファイルのタイミングテーブル。
3幕構成を提案:
- 第1幕(フック)≈ 尺の20%
- 第2幕(本編)≈ 55%
- 第3幕(決着+4~6秒ホールドのあるアウトロ)≈ 25%
(MOTION_PHILOSOPHY §0 法則9、§1)
ユーザーの意図をカタログブロックにマッピング: Read: references/catalog-intent-map.md
ゲート条件: ストーリーボード+タイミングテーブルを表示。ユーザーが承認するまで繰り返します。
ゲート6 · コンポジションのビルド
フレームワークルールについては /hyperframes を呼び出します。このスキルはスキャフォールドと規律を担当し、/hyperframes がルールを実施します。
すべてのサブコンポジションをスキャフォールド
<div data-composition-id="scene-name" data-start="..." data-duration="...">
<style>[data-composition-id="scene-name"] { /* スコープ化 */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... トゥイーン ...
tl.to({}, { duration: SLOT_DURATION }, 0); // アンカー — MOTION_PHILOSOPHY 法則11
window.__timelines["scene-name"] = tl;
})();
</script>
</div>
完全なボイラープレート+キャプションパターン+アンビエント背景パターン: Read: references/composition-scaffold.md
ビルドルール
- アンビエント背景 は、コンポジション全体の期間中
data-track-index="0"で設定。 - キネティックタイプオープナー: 単語ごとに0.06~0.10秒のスタッガー。
- キャプション は、
index.htmlのルートコンポジションのボディレベルの兄弟要素として配置し、それぞれdata-track-index >= 20を設定。シーンタイムライン内には決して配置しない(MOTION_PHILOSOPHY §3.13)。 - カタログブロック は
npx hyperframes add <名前>でインストール。すぐにブロックのCSSを[data-composition-id="..."]にスコープ化 — カタログブロックにはhtml, body { ... }ルールが含まれており、サブコンポジションとしてロードされると親ドキュメントに影響を及ぼします。 - 縦型+顔カメラ: ネイティブの1920×1080の顔をトランスフォーム(
translate+scale)でラップし、下半分またはフルスクリーンモードに。 (ここで/short-form-videoにたどり着いた場合は、ハンドオフを強く検討。) - ユーザーが提供したものだけを適用。 ユーザーのパレット、フォント、ロゴ。それ以外は注入しない。ユーザーがMOTION_PHILOSOPHYのデフォルトを選択した場合は、
references/style-intake.mdからパレット+フォントペアを取得。
決定性
Math.random()、Date.now()、レンダリング時の fetch() は使用しない。シード付きPRNGまたは調和サイン(harmonic-sin)ハッシュを使用する(MOTION_PHILOSOPHY §3.10)。
ゲート7 · リンター → スタジオプレビュー(プレビューゲート1 — 必須)
npx hyperframes lint— すべてのエラーを修正し、警告をトリアージ。- バックグラウンドで
npx hyperframes previewを実行。 http://localhost:3002で「Studio running」が表示されるのを待つ。- ユーザーにURLを提示および個々のコンポジションURL(
http://localhost:3002/?comp=<id>)も提示。プロジェクトにWebGLシェーダーブロックがある場合は、個別URLを最初に提示 — ソフトウェアWebGLフォールバックはマスターコンポジションを停止させる可能性があります。 - 「良さそうだ、ドラフトをレンダリングして」という明示的な承認を待つ まで先に進まない。沈黙は承認ではありません。
ホットリロードはオン — 編集はライブで反映されます。
ゲート8 · ドラフトレンダリング → 視覚確認 → MP4プレビュー → 最終
ドラフトレンダリング
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
視覚確認(納品前に必須)
リンター合格 ≠ デザイン動作。フレームを抽出して確認します。
mkdir -p renders/frames- すべてのビートの見せ場およびすべてのトランジションについて:
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - すべてのPNGに対して
Readツールを呼び出す。 Readツールは画像をコンテキストに読み込みます — ファイル名をリストするだけでは不十分。 - フレームごとに確認:顔が途切れていないか、シーンごとに正しいフェイスモードか、テキストが読みやすくパレットに合っているか、オーバーフローがないか、トランジションが意図した単語に合っているか、空白フレームがないか。
- 問題がある場合:修正 → 再レンダリング → 再確認。壊れたドラフトを決して出荷しない。
MP4プレビュー(プレビューゲート2 — 必須)
npx serve renders -p 8080 -n
Pythonの http.server を使用しない — HTTP Rangeリクエストをサポートしていないため、シークが壊れます。
ユーザーに http://localhost:8080/<slug>-draft.mp4 を提示。再生とオーディオ同期について明示的な承認を待つ。
最終レンダリング
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
出力パスを報告。完了。
完全なプレフライト+納品前チェックリスト: Read: references/build-checklist.md
非交渉事項(重要 — 軽く扱わないこと)
- プレビューゲート1(スタジオ)またはプレビューゲート2(レンダリング済みMP4)をスキップしない。 ビルドごとに常に2つのゲート。
- フレームを抽出し、Readツールで確認するまで、レンダリングが完了したと主張しない。
- 専用のプロジェクトフォルダ以外ではビルドしない。 ワークスペースルートに
index.htmlを置いてはいけません。 - ワークスペースのアセットを棚卸しする前に、ユーザーにアセットを尋ねない。
- すべてのサブコンポジションタイムラインの最後に
tl.to({}, { duration: SLOT_DURATION }, 0)アンカートゥイーンをスキップしない。 MOTION_PHILOSOPHY 法則11。 - レンダリングロジック内で
Math.random()/Date.now()を使用しない。 シード付きハッシュのみ。 <video>タグにclass="clip"を追加しない。 それらが壊れます。- ユーザーにブランドを押し付けない。 最初に尋ね、ユーザーが明示的に辞退した場合のみMOTION_PHILOSOPHYのデフォルトにフォールバック。
参考文献
references/interview-questions.md— ゲート別の全質問バンクreferences/style-intake.md— スタイルインタビュー+MOTION_PHILOSOPHYデフォルトreferences/catalog-intent-map.md— 「ユーザーがXと言った → Yをインストール」references/storyboard-template.md— ビート単位のテンプレート+実例references/composition-scaffold.md— スコープ化スタイル+IIFE GSAPボイラープレートreferences/build-checklist.md— プレフライト+納品前ゲート
外部(ワークスペースレベル):
MOTION_PHILOSOPHY.md— このスキルが存在を前提とする唯一の外部参照。美的ベースライン。ファイルがない場合のフォールバックはreferences/style-intake.mdにあります。
関連スキル
/hyperframes— フレームワークルール、ゲート6で呼び出す/hyperframes-cli— init · lint · preview · render · transcribe · tts/hyperframes-registry— カタログブロックのインストール/gsap— GSAPアニメーションリファレンス/short-form-video— ゲート5で9:16トークヘッド形式へのハンドオフ/website-to-hyperframes— 入力がURLの場合、ゲート1でハンドオフ