Communitygithub.com

jayfirke/motion-studio

映画のディレクターとして企画を立案し、再生可能なプリビスページ(アニマティック、実際の音声・音楽・フォーリー、タイムライン、各決定に3つの選択肢、時間指定メモ、バージョン管理、承認ボタン付き)をオーナーに提示します。レンダリング前にすべての決定を行います。10秒以上の新作フィルム、オーナーが「まず見せて」「プリビス」「ストーリーボード」「アニマティック」「レンダリング前に可視化」と依頼した場合、またはプリビスページにメモを残した場合に使用します。承認された動画仕様(approved-video-spec.json)をエンジンスキルに出力します。最終レンダリングは行いません。

motion-studio とは?

このスキルは、映画制作のプリプロダクション(監督、ストーリー、脚本、ストーリーボード、スタイルフレーム、アニマティック、音楽、効果音、ナレーション、エンジン選択、QA、レビュー、バージョン管理、承認)を完全に担当し、高額なクリエイティブ決定を最もコストのかからない段階で行えるようにします。HyperFrames、video-shotcraft、Remotion、motion-reel、bang-motion、Diffusion Studioなどのレンダリングエンジンは、オーナーが承認した内容のみを構築します。固定されたReact + TypeScriptアプリ「Previs Studio」を基盤とし、すべてのフィルムはデータパックとして提供されます。オーナーは、ビデオプレーヤー、ストーリーボード、計画、ガイド付きレビュー、ディレクターへの質問、⌘K検索、元に戻す/やり直し、ライト/ダークテーマなどの機能を備えたインタラクティブなページを受け取ります。各決定に3つの異なる選択肢を用意し、ライブラリ機能でさらに多くの選択肢を追加可能。レビュー、バージョン管理、承認フローを内蔵し、承認後はエンジンが正確な仕様に従ってレンダリングを実行します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/video-director-previs

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ビデオディレクター・プリビス

高額なクリエイティブ決定を最もコストのかからない段階で行います。このスキルはプリプロダクション(監督、ストーリー、脚本、ストーリーボード、スタイルフレーム、アニマティック、音楽、SFX、ナレーション、エンジン選択、QA、レビュー、バージョン管理、承認)を所有します。エンジン(HyperFrames、video-shotcraft、Remotion、motion-reel、bang-motion、Diffusion Studio)は、オーナーが承認したものだけを構築します。

使用例:examples/crumb-previs/(架空の割り勘アプリ)。そのデータパックはPrevis Studio内のデモフィルムです(_shared/previs/studio/films/011-crumb/)。

アプリはフィルムごとに変わりません。 Previs Studioは1つの固定されたReact + TypeScriptアプリです(ソース _shared/previs/app/、そのREADMEを参照)。npm run build で型チェック、バンドル、インライン化を行い、_shared/previs/studio/index.html と _shared/previs/page/index.html(テンプレート)を生成します。各フィルムごとのページに対するターゲットを scripts/inline.mjs に追加してください。npm run smoke は、実際のChromeでデスクトップ、タブレット、スマートフォン、フルスクリーンでビルドされたページを駆動します(--out でスクリーンショット出力)。ビルドされた index.html を手動で編集しないでください。

オーナーが得るもの

視聴(ビデオスタイルプレーヤー:真のフルスクリーン、ホバースクラブプレビュー、エンドカード;コメントモード:ポインター下の最小部分を名前表示、スクロールで拡大/縮小、複数部分をボックスで囲む、ペンと矢印、ショット列をドラッグして時間範囲指定;サウンドレーン:波形、ビート、ダックカーブ、ソロ/ミュート/ボリューム、ビートにスナップするドラッグ可能SFX)、その瞬間をその場で再生しながら選択肢を切り替え、サイドバイサイド比較、長押しでオリジナルを聴く、ストーリーボード(カードがその場でショットを再生、すべて再生、ショットごとの選択肢、ショットシート)、計画(チーフディレクター、ストーリー、ディレクターチーム、ルック、サウンド、アセット、制作、チェック、バージョン「元に戻すよう依頼」付き、スペックエクスポート)、ガイド付きレビュー、ディレクターに質問、⌘K検索、元に戻す/やり直し、ライト/ダークテーマ、すべてのコントロールにツールチップ。フィルムはデータパックとしてのみ届きます。

2つのホーム、同じアプリ

  • Previs Studio(全フィルム): _shared/previs/studio/。フィルムを追加するには = films/<id>/previs.json + films/<id>/audio/... と films.json に行を追加します。ローカル:python3 -m http.server --directory _shared/previs/studio(または .claude/launch.json の previs-studio エントリ)。
  • フィルムごとのページ: projects/NNN/previs/page/ は同じ index.html(タイトル <Product> Previs)、films.json(path が "" の1行)、previs.json、audio/ を保持します。
  • claude.aiのArtifactとして(Claudeのみ): capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true} でページを公開します。db はメモと選択肢を保存、sample は「ディレクターに質問」を動作させ、comments は「Claude Codeに送信」を伝達、downloads はスペックエクスポートを提供します。これらがなくてもページは動作し、ブラウザに保存されます。
  • データベースパス:コメント(フィルムにピン留めされた変更リクエスト;コレクションは古い名前を保持)films/<id>/notes(kind: frame、region、range、sound、shot、revert、request;target、targets、box、strokes、quick チップ、t/t2、picks、version);選択肢とサウンド調整 films/<id>/state/picks(tweaks: <scene>.<sfx> {dt, db}、lane.vo|music|sfx {db}、mix.duck {on});追加オプション films/<id>/state/custom;承認 films/<id>/state/approval;Claudeのステータス films/<id>/state/claude;アクティビティ films/<id>/activity;メモ(フィルム全体に関する自由な考え:背景として読み、タスクとして扱わない)films/<id>/pad。

ライブラリ:必要に応じて3つ以上の選択肢

すべての決定には3つのディレクターオプションが付属します;D['libraries'] は、レビュアー(または「質問」タブ)がさらに取り込める選択肢を追加します:direction(ルック:トークンセット + fonts_url)、music(CC0のBGM:bpm、phase、tags、level)、motion(ease、spring {f,d} または bezier)、pacing、camera、transition、sfx(フィルム内のすべての音)、voice(Fishの音声:dir、durs、texts(他言語用)、intro、sample)。グローバルな voice 決定がナレーターを選びます;各ラインは <dir><scene>-<A|B|C>.mp3 に解決されます。needs があり dir がない音声は、録音されるまでキャプションとして再生されます。追加オプションはページデータベースに保存され、元に戻すことができ、承認済みスペックに含まれます。examples/crumb-previs/libraries.py をモデルにライブラリを構築します:

  • 音楽:Freesound CC0を検索(freesound.py search ... --min-dur 20)、freesound.py get、その後 python3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs>(ビート合わせ24秒抜粋、BPM測定);各BGMにタグと理由を記述;_shared/ASSETS.md に台帳行を追加。
  • 音声:search_voices で公開Fish音声を選択(実在人物やキャラクタークローンは不可)、voices/voices.tsv にリスト、voices/lines-<lang>.txt を作成、voices/make_voices.sh(無料モデル)を実行、whisper-cliでテイクをスポットチェックし、単語が欠けたものを再生成。
  • AIディレクター(「質問」タブ、lib/director.ts)はルック(コントラストチェック済み、許可されたGoogleフォント)、モーションの感触、新しいラインの言い回し(録音が必要:Claude Codeにリクエストノートを送信)もデザインできます。

Claude Code側のメモ処理(毎ラウンドこれを行う)

オーナーはページからメモを送信します(「Claude Codeに送信」:監視中のセッションを起こすライブコメント、またはコピーされたメッセージ)。その後: 0. 変更前にプル。 claude.ai上のClaudeは「Claude Codeに送信」スレッドに自分で回答し、データファイルを編集して新しいバージョンを公開できます。ビルドする前に、公開された previs.json を読み、ローカルビルドと比較し、変更を build_previs.py に移植して、次のビルドで保持されるようにします。

  1. films/<id>/state/claude を設定します(state:"reading"|"working"|"publishing"|"idle"、at、message、version、open) ページに何をしているか表示されるようにします。
  2. 開いている各メモに対して:update で claude: {state:"seen"}(読んだとき)、{state:"working"}(変更中)、その後 status:"done"、claude:{state:"done", at, msg} にし、replies に {by:"claude", text, at} を追加します(if_version でピン留め)。オーナーが必要なときは state:"question"(質問は msg に)、保持を推奨するときは "wontfix" を使用します。kind:"request" のメモは「質問」タブからのジョブです(新しいラインの録音、音の検索);prefer はオーナーが好むオプションを指します;intent:"question" は変更ではなく回答を求めます。 すべての at は実際の時刻です:date -u +%Y-%m-%dT%H:%M:%SZ から取得し、決して推測しないでください。
  3. films/<id>/activity に行を追加します({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}):読んだもの、変更したもの、公開したもの。
  4. オーナーが「Claude Codeに送信」を使用した場合は、ページのコメントスレッドで返信し、その後解決します。

ルール

  • 1人のディレクター、委員会は不要。 以下の専門家チェックリストを自分で順番に実行します。オーナーが要求しない限り、ワークフローやサブエージェントは使用しません(コストルール)。
  • 積極的に推測し、真のブロッカーのみ質問(製品の事実、不足アセット、ライセンス質問)。オーナーが何かを見る前の長い質問票は禁止。
  • すべての決定にデフォルトで3つの選択肢。 方向性、音楽、モーションの感触、ペーシング、およびシーンごとに:トランジション、カメラ、ナレーションライン、各SFXイベント。選択肢は真に異なるものでなければなりません。ディレクターの選択をマークし、各オプションに理由またはトレードオフの1文を付けます。「なし」は有効なSFXオプションです。
  • 製品の真実。 すべてのシーンは real_ui、conceptual_ui、conceptual_visual、external_footage のいずれかにラベル付けされます;実際のものでないものはプレーヤーにラベルを表示します。
  • ハウスルールは引き続き適用(AGENTS.md、OWNER.md):禁止されたクリシェ、キャリー、2つのテキストレベル、録音されたフォーリー、デフォルト音声、ライセンス。ページはCC0または自作のオーディオのみを再生;Mixkit(レンダリングのみ)は名前のみで表示されます。
  • スケールダウン。 6秒のスティングは1枚の方向性カード、3つの音楽オプション、6秒のアニマティックで済みます。40秒の製品フィルムはフルセットを取得します。
  • ロック。 オーナーが承認すると、ストーリー、コピー、順序、タイミング、選択肢はロックされます。後続のメモはそのターゲットのみを変更します;保持したものをリストアップします。

専門家チェックリスト(ディレクターが各項目を簡潔にカバー)

ストーリー(2秒までにフック、ビートごとに1つの状態)・脚本とナレーションライン(1秒あたりの単語数 ≤ 3.4)・編集のペーシング(ショット長を変える、休止、すべてのカットをビートに合わせない)・アートディレクション(3つの方向性をトークンセットで:bg、on-bg、card、on-card、muted、line、paper、on-paper、accent、on-accent、frame、display、ui、mono)・タイポグラフィ・リファレンス(借用/回避/使用箇所;文法、内容は不可)・カメラ(すべての動きに理由がある)・モーション(目的、イーズ、UI上ではオーバーシュート ≤ 4 %、タイプにはなし)・トランジション(シンプルなカットは有効)・アセット(既存/新規/生成/プレースホルダー、ライセンス付き)・音楽(測定されたBPMとフェーズ、エネルギー曲線、ドロップの位置)・SFX(アセット、時間、トリガー、ゲイン、理由)・ミックス(ナレーションがリード、ダック8 dB、インパクトが最も大きい)・エンジン(選択、理由、代替、フォールバック)・QA。

ファイル(フィルムごとに1フォルダ)

projects/NNN-name/previs/
  build_previs.py          # page/previs.json を書き込みます;examples/crumb-previs/build_previs.py をコピーして編集(scenes = HTMLスタイルフレーム + アニメーショントゥイーン)
  vo-lines.txt             # ラインごとに3つの言い回し、fish_tts.py 用
  page/index.html          # _shared/previs/app でビルド(npm run build;このページを scripts/inline.mjs のターゲットとして追加)
  page/films.json          # [{"id": "NNN-name", "name": "Product", "path": ""}]
  page/previs.json         # 完全な計画
  page/audio/{music,vo,sfx}/
  changes.jsonl            # 追記専用変更ログ、1行1操作
  approved-video-spec.json # 承認後 _shared/previs/freeze_spec.py によって書き込まれる

手順

  1. 読む:ブリーフまたは一行の依頼と製品ソース(実際のUI、トークン、コピー)を読みます。推測された決定事項を BRIEF.md に書きます。
  2. オーディオ(低コスト、ローカル):
    • BGM:低帯域オンセットエンベロープで85–150 BPMの範囲でコンブフィットによりテンポとフェーズを測定(AGENTS-tooling.md、「Previs」);ビートから始まる24秒抜粋をカット、loudnormで−18 LUFSに:ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3。
    • ナレーション:python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav(無料モデル)、その後無音部分をトリミングして page/audio/vo/sN-{A,B,C}.mp3 に。
    • フォーリー:_guide/prompt-studio/media/foley/ からCC0プレビューをコピーするか、freesound.py で取得。
  3. 計画を build_previs.py で立案(例のすべてのフィールドを参照):project、summary、chief、story(ビート → シーン)、directors、assets、gates、pipeline、changes、directions(3)、global.music|motion|pacing|voice(各3)、engine、references、style_rules、audio_notes、qa、versions、film_css(すべての色はトークン経由、クラスは f- 接頭辞)、fonts_url、そして scenes[] に html、anim(x、y、s、sx、sy、r、o、clip、w、blur に対するトゥイーン {s, t:[a,b], f, to, e};{s, set, at, until} クラストグル;{s, count:[from,to], t, p, d} カウンター;e:'m' はモーションピックに従う)、decisions(トランジションタイプ:cut、push、slide、zoom、iris;カメラ {s,x,y,origin};ナレーション {text, src, dur, at, copy})、sfx(at は連続再生のためにリスト可能)、key(ストーリーボード静止画の瞬間)。オーナーが指す可能性のあるすべての要素にプレーンな data-name(「領収書合計」、「リクエストボタン」)を付けます。
  4. ローカルで確認:ページフォルダをサーブし、各シーンの静止画と1つの中間トランジションを見て、3つの方向性すべてを1回切り替え、コンソールエラーがないことを確認。1パスで、ループはなし。
  5. ページを共有(ローカル、または上記の機能を持つclaude.ai Artifactとして)し、フィルムをPrevis Studioに追加します。オーナーにリンクと5行の要約を伝えます。レビューのために停止します。
  6. レビューループ(各ラウンドは1回の再公開):
    • メモ、選択肢、承認を読みます。
    • 各開いているメモに対して:そのターゲットのみを変更し、changes.jsonl に操作を追加します({"v","target","t","change","from","to","reason","preserve":[...]})、その後メモを1行の返信で完了マークします(上記のプロトコル)。revert メモはリストされた変更を元に戻すよう要求します。
    • build_previs.py で versions を増やし、そのラウンドの changes を追加し、再実行し、previs.json をStudioコピーにコピーし、再公開します。プレーヤーは「何が変わったか」バナーを表示し、「計画」に各変更を「元に戻すよう依頼」ボタン付きでリストします。
  7. 承認:state/approval に approved: true がある場合(picks、tweaks、custom を含む)、それを保存し、python3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file> を実行し(追加オプションとナレーションを解決し、needs_before_build(未録音のラインなど)をリストします)、スペックから SHOTLIST.md を書き込み、スペックで指定されたエンジンスキルに引き継ぎます。エンジンは正確にスペックを構築します(ポリッシュは許可、決定は不可)。

コスト

単独作業のみ。20秒のプリビスは1セッションの数時間(API換算でおおよそ$30–60)、Fishは無料モデルを使用し、レンダリングは行いません。プロダクションレンダリングとそのチェックは承認後に行われます。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル