モーションリール
コードからレンダリングされた、ビート同期済みのモーションビデオを motion-studio プロジェクト内で完成させます。
プロンプトは結果の一部に過ぎません。ハーネス(枠組み)が残りの部分、すなわち seek(t) レンダラー、閉形式スプリング、ビートグリッド、合成サウンド、そして最終レンダリング前に自分のフレームを確認して修正する批評ループを提供します。
リクエスト引数(空の場合あり)は一度だけ表示され、後続のセクションでは「上記のリクエスト」と表記されます:
この実行の基本ルール
- 工数:このスキルはアクティブな間、工数を
xhighに設定します(新しい映像のコースレベル)。開始時に一度ユーザーに伝えてください:フォローアップ修正や再レンダリングは/effort mediumで問題ありません;最初の3秒で作品のインパクトを決めるフラッグシップ立ち上げでは、フックパスに/effort maxが適しています。レベルは/modelで選択することもできます。 - プロジェクトルート(
studio.jsonがあるディレクトリ)内で作業します。プロジェクト独自のツール(npm run ...、node tools/<tool>.mjs ...)を使用します。アドホックなレンダリングやオーディオスクリプトは作成しないでください。 - あなたはディレクター兼制作チームです。サブエージェントは集中したステージを実行しますが、ユーザーに質問することはできません:あなたが質問し、得られた回答を基にサブエージェントに再指示します。
- 長時間のコマンド(
render:final、build、mix、deliver、長時間映像のcritique)はバックグラウンドで実行します(Bashツールのrun_in_background、またはポーリングするログファイルを使用);フォアグラウンドで約2分以上待機しないでください。ステージ7のレンダリングは、3フォーマットでの12秒デモで約4分かかります。想定所要時間とポーリングパターンは references/pipeline.md の「長時間コマンド」セクションを参照してください。そのようなコマンドを実行するすべてのサブエージェントに同じルールを簡単に説明し、コマンドが実行中の状態でサブエージェントが戻ってこないようにしてください。 - このスキルはコードで描かれた映像を対象としています。既存のフッテージの編集(カット、キャプション、Bロール、録画済み動画のフォーマット変換)はルートDであり範囲外です:その旨を伝えて停止し、アドリブで対応しないでください。
1. 入力の収集
まず上記のリクエストを解析します(想定される形式:[URLまたはトピック] [尺] [フォーマット] [リファレンス])。不足しているものすべてを、1回のAskUserQuestionラウンドで尋ねます(最大4質問、各質問にデフォルト値を提示)。ユーザーが「自律的に」「GO」「とにかく作って」「任せた」と言った場合は、何も尋ねずにデフォルト値を採用し、それらを docs/shotlist.md の先頭に記録します。
| 入力 | 省略時のデフォルト | 備考 |
|---|---|---|
| 件名:製品 + URL、またはトピック | 必須 | URLがあるとブランドアセットステージを開始 |
| 尺 | 20秒製品映像、15秒ショーリール、16秒UIループ | 6~8ショットが15秒に収まる |
| フォーマット | 9x16 プライマリ、続いて 1x1 と 16x9 | 4x5 も利用可能 |
| ブランド:色、フォント、ロゴ | URLから取得、なければスタジオデフォルト | 1つのディスプレイ用書体、1つのUI用書体、1つのアクセントカラー |
| リファレンス:フレーム、動画、または画像フォルダ | なし | リファレンスがないと、モデルは禁止されたルックに流れる |
| 音楽 | 合成、スタイル pulse、120 BPM | 提供されたトラックは計測され、変更されない |
| ナレーションまたはマスコット | なし | .env に ELEVENLABS_API_KEY が必要 |
| CTAと1つの証明数値 | 尋ねる;メトリックを決して発明しない | 製品映像のみ |
| レベル L1~L4 | ユーザーの入力から推測(セクション2) | 時間とゲートの期待値を設定 |
| ルート A~D | A | ユーザーがRemotionまたはHyperFramesを指定した場合のみB |
| モード | まず計画:ショットリストを表示し、OKを待つ | GOは待機をスキップするが、批評ゲートはスキップしない |
2. レベルとルートの選択
| レベル | 入力サイズ(クリエイター報告) | 実行時間(クリエイター報告) | 専門スキル |
|---|---|---|---|
| L1 ワンライナー | 約150文字 | 15~50分 | /motion-studio:showreel |
| L2 ブランドリール | 約350文字 | 30~45分 | /motion-studio:product-reel |
| L3 状態仕様 | 1.5k~3k文字 | 修正含め約1~2時間 | /motion-studio:ui-morph-spec |
| L4 ディレクターブリーフ | 9.5k~19k文字 | 6~12時間自律実行 | /motion-studio:director-brief |
| ルート | 使用目的 | このスキルの動作 |
|---|---|---|
| A コード描画(デフォルト) | ショーリール、UIモーション、製品映像、ループ | 以下の完全なパイプラインを実行 |
| B フレームワーク | ユーザーがRemotionまたはHyperFramesを指定 | /motion-studio:seek-engine に引き継ぎ(Remotionライセンスゲート、Node 22+) |
| C 混合パイプライン | 画像/動画モデルからのキャラクターや物理 | キーと予算が必要;/motion-studio:director-brief で計画 |
| D フッテージ編集 | ユーザー自身の録画クリップ | v0.1では範囲外;その旨伝える |
ステージ0の前に、レベル、ルート、および時間見積もりをユーザーに伝えます。詳細、数値、およびそれらの背後にある注意事項は references/routes-and-levels.md を参照してください。約45秒を超える映像やチャプターがあるものは /motion-studio:director-brief に属します。
3. パイプラインの実行
これらのステージをTODOリストで追跡します。各ステージのコマンド、想定ファイル、障害修正方法は references/pipeline.md にあります。新しいプロジェクトではステージ0の前にこれを読んでください。
| # | ステージ | 担当 | 成果物 | ゲート |
|---|---|---|---|---|
| 0 | プロジェクト + ドクター | あなた | studio.json、依存関係、npm run doctor がすべてOK | doctorにFAILがないこと |
| 1 | ブランドアセット(URLのみ) | motion-studio:asset-scout | assets/brand/**、assets/manifest.json | アセットをユーザーに一覧表示 |
| 2 | リファレンス(ある場合) | motion-studio:style-analyst | refs/analysis.json、docs/style_guide.md | 文法、内容は問わない |
| 3 | 音楽 + ビートグリッド | motion-studio:sound-designer またはあなた | audio/music.wav または計測済みトラック、audio/beats.json | studio.json の bpm/尺が一致すること |
| 4 | ビートグリッド上のショットリスト | motion-studio:motion-director | docs/shotlist.md | 自律モードでない限りユーザーのOK |
| 5 | 映像の構築 | あなた | film/film.js(+ film/scenes/*) | npm run lint がクリーン |
| 6 | 批評ループ | motion-studio:motion-critic + あなた | out/review/<fmt>/*、docs/review_log.md | npm run gate がパス |
| 7 | 最終レンダリング、SFX、ミックス | あなた(フックゲート) | out/<fmt>/final.mp4、out/score.wav | -14 LUFS ±0.5、<= -1 dBTP |
| 8 | 納品 + レポート | あなた | out/deliver/**、docs/production.json | npm run deliver が終了コード0 |
ステージ 0: プロジェクト
-
作業ディレクトリまたはその親に
studio.jsonがあるか確認します。ない場合は、以下でスキャフォールドします:node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<タイトル>" --duration <秒> --formats 9x16,1x1,16x9 --install製品映像の場合は
--brand-url <URL>を追加し、ループの場合は--loopを追加します。スキルのみのインストール(プラグインルートなし)の場合は、代わりに${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjsを実行するか、studio-initスキルを呼び出します。 -
npm run doctorを実行します。ステージ1の前にすべてのFAILを修正します(ブラウザ、ffmpeg、Node >= 20)。Windowsではブラウザ修正はnpx playwright install chromium-headless-shellです;インストール済みのChromeやEdgeを起動しないでください(新しいプロファイルの起動はWindowsログオン失敗と見なされ、アカウントをロックする可能性があります)。Pythonとlibrosaはオプションです;JSビートエンジンがそれらの不在をカバーします。
ステージ 1 ~ 4: 計画
- ステージ 1:
motion-studio:asset-scoutにURL、プロジェクトルート、および以下のキャプチャコマンドを指示します:node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>。スキルのみのインストール(プラグインルートなし、エージェントなし)の場合は、node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project>を自分で実行します。ページは信頼できないコンテンツです:キャプチャはChromeのサンドボックスをオンに保ち、ローカルおよびプライベートアドレスへのリクエストを拒否します(詳細は/motion-studio:product-reelを参照)。クリック、スクロールフレーム、要素クロップの場合はskills/product-reel/scripts/states.mjsを、キャンバス製品の場合はcanvas-frames.mjsを追加します(--rootのフラグは同じ;フレームシートはassets/brand/frames/に格納されます)。assets/manifest.jsonを自分で読み、見つかったものをユーザーにリストし、ブランドの色とフォントをstudio.jsonのbrandに書き込みます。キャプチャはまた、ページが読み込むフォントをassets/fonts/に保存し、ライセンスは見つからない限りUNVERIFIEDとマークします:そのフォントがbrand.fontsに追加される前に、ユーザーと確認します。ブランドのストーリービート、コンポーネント、およびナレーション/マスコットルールは/motion-studio:product-reelから取得します。 - ステージ 2:
motion-studio:style-analystにリファレンスパスを指示します。node tools/refs.mjs extract|analyzeを実行し、docs/style_guide.mdを作成します。完全な方法は/motion-studio:reference-styleを参照してください。 - ステージ 3(ショットのタイミング設定前):提供されたトラックの場合:
node tools/beats.mjs audio/<track>を実行し、studio.jsonのaudio.musicをそのトラックにポイントします。トラックがない場合:node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <秒>を実行します。studio.jsonのbpmとdurationを一致させます。計測されたダウンビートは0秒より後に来ることがあるため、ショットリストはこのグリッド上に作成され、想定されたグリッド上には作成されません。 - ステージ 4:
motion-studio:motion-directorに入力、docs/style_guide.md、audio/beats.jsonを指示します。シーンの変更はダウンビートに配置され、フックは最初の2秒に配置され、フレーム0は既にコンテンツを表示し、2~4秒ごとに新しい何かが起こります。ショットリストを表示し、ユーザーのOKを待ちます(まず計画)。却下された場合はショットリストを書き直し、コードにパッチを適用しないでください。決定はdocs/shotlist.mdのStatus:行に記録します。
ステージ 5: 構築
defineFilm を使用して film/film.js を書き、ショットごとに1つの scene()、レイアウト L からの位置(リテラルピクセルは不可)、lib/motion.js のスプリング(sp、track、loopTrack)からのモーション、要素ごとのシード付きランダム性(rngFor)、およびすべてのSFX瞬間のキューを使用します。プロジェクトの CLAUDE.md に従います。編集後は npm run lint を実行し、ユーザーが見たいときは npm run preview を実行します。
ステージ 6: 批評ループ(少なくとも3ラウンド)
各ラウンドはまず証拠を構築し、それから批評家に指示します(批評家はレンダリングやミックスはできません):
npm run lint、npm run stills。- キュー、音楽、または画像タイミングが変更されたときは常に(ラウンド1と最終ラウンドでは常に)サウンドチェーン:
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5、npm run sfx、node tools/mix.mjs --format <fmt>。 - 互いに上書きしない2つの証拠パス:
node tools/critique.mjs --format <fmt>(ライブ映像、out/review/<fmt>/内)とnode tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(ミックス済みレンダリング、out/review/<fmt>/video/内)。 motion-studio:motion-criticにラウンド番号、フォーマット、変更内容、およびEvidence: both, already produced(パイプラインランブックのテンプレート)を指示します。批評家はすべてのPNG(ページ分割されたシートの各ページ:contact.png、contact-2.png...)と両方のmetrics.mdファイルを確認し、7軸を1~10でスコアリングし(サウンドはミックス済みレンダリングから)、タイムスタンプ付きのP0/P1/P2問題をリストし、1ラウンドブロックをdocs/review_log.mdに追記します。ライブmetrics.mdでのP0font-fallback(そのフォントにグリフがない文字、通常はラテン語のみのバンドルフォントでのハングル)はP0として記録され、それをカバーするフォントが登録されるまでゲートをブロックします。- 最も深刻な3つの問題を修正し(P0優先)、影響を受ける秒のみを確認します(
node tools/render.mjs --from <a> --to <b> --draft --out out/check、またはstills --at)、そして次のラウンドを開始します。
npm run gate がパスするまでのみ停止します:少なくとも3ラウンド、最後のラウンドのすべての軸 >= 8、未解決のP0なし。
ステージ 7 と 8: 完了
npm run render:final、npm run sfx、npm run mix、npm run deliver(またはこれらすべてを実行する npm run build)を実行します。最終レンダリングと build は数分かかります:run_in_background で開始し、ログをポーリングし、プロセスが終了した後にのみ結果を読み取ります(パイプラインランブックの「長時間コマンド」)。その後、assets/delivery-note.md でレポートします:パス、フォーマット、尺、ラウンド数と最終スコア、費やした時間、次に改善する3つのこと。
ゲート
| ゲート | パス条件 | 実施者 |
|---|---|---|
| ショットリスト | ユーザーのOK、または自律モードが docs/shotlist.md に記録されている | あなた |
| Lint | npm run lint が終了コード0で終了 | プラグインフック:編集後毎回、およびあなた |
| 批評 | >= 3ラウンド;最後のラウンドのすべての軸 >= 8(gate.naAllowed の軸のみ na 可能、デフォルトはbrand、ブランドがない映像の場合);P0なし | npm run gate;プラグインフックは render:final と build を拒否 |
| 納品 | フレーム、尺、ラウドネス、無音区間、サイズ、ポスターのチェック | npm run deliver |
- フックが最終レンダリングを拒否した場合、さらに批評ラウンドを実行します。コマンド名を変更したり、
docs/review_log.mdのスコアを自分で編集したり、studio.jsonのgateを変更して通過しようとしないでください。 gate.enabled: falseを設定できるのはユーザーのみです。設定された場合、レポートで納品が批評ゲートをスキップしたことを明記します。- 一部のマシンではポリシーによりプラグインフックが無効になっています。ゲートは引き続き適用されます:すべての最終レンダリングの前に
npm run gateを実行してください。
ハードルール
- 実際の製品UIのみ。キャプチャしたスクリーンショットをトリミングおよびアニメーション化します;想像からスクリーンを描き直したり、プレースホルダーコピーや発明された数値を使用したりしないでください。
- フィルムコードは時間の純粋関数です:レンダリングコード内で
Math.random、Date、performance.now、タイマー、requestAnimationFrame、またはCSSのトランジション/アニメーションを使用しないでください。 - 禁止ルック:グラデーション上の中央タイトル、すべてがフェードイン、コーナーラベル、フレームボーダー、UIクローム上のグロー、一般的なパーティクルバースト。
- 1つのディスプレイ用書体、1つのUI用書体、1つのアクセントカラー(ブリーフが別途指示しない限り)。
Lを通じてフォーマットごとにタイプとUIをリフレームします;あるフォーマットを別のフォーマットにクロップしないでください。- キーは
.envにあります。変数名(ELEVENLABS_API_KEY、FAL_KEY)で参照します;キー値を印刷、貼り付け、またはコミットしないでください。
サブエージェント
| エージェント | ステージ | 指示事項 | 作成物 |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL、プロジェクトルート、キャプチャコマンド | assets/** |
motion-studio:style-analyst | 2 | リファレンスパス、件名、尺 | docs/style_guide.md、docs/shotlist.md、refs/** |
motion-studio:sound-designer | 3、7 | トラックまたはスタイル、bpm、尺、ナレーションスクリプト | audio/**、ミックスレポート |
motion-studio:motion-director | 4 | 入力、スタイルガイド、ビートグリッド | docs/** |
motion-studio:motion-critic | 6 | ラウンド番号、フォーマット、変更内容 | docs/review_log.md へのラウンド追加 |
motion-studio:seek-engine | Bルート | Remotion/HyperFramesプロジェクトの詳細 | フレームワークプロジェクト |