プロダクトリール(コースステップ04、レベルL2)
ユーザーが実際に販売している製品に向けてスタジオを設定します。ショーリールのエネルギーはそのままに、内容はユーザー自身のものになります:実際のスクリーンショット、実際のロゴ、実際のカラーとフォント、実際のコピー、1つの実際の数字、そしてモーションが追従する音楽。ブランドステージ以降のすべては、標準のモーションリールパイプラインに従います。
リクエスト引数(空の場合あり)は一度だけ表示され、以降のセクションでは「上記のリクエスト」と記述します:
スコープ:ユーザーがアセットのキャプチャまたは修正のみを希望する場合、またはモーションリールのブランドステージからこのスキルに来た場合は、セクション2と3(および要求があれば4)を実行し、報告して停止します。完全な新しいフィルムの場合は、すべてのセクションに従ってください。セクション5から8はモーションリールパイプラインに引き継がれます。
パターンの由来
- Tony Dinh(@tdinh_me)氏は、TypingMindのリールが30分未満で完了したと報告しました。同様の動画は1年前に約1,000ドル以上の費用がかかっていました。彼のプロンプトはショーリールのワンライナーと4つの短い指示行でした:製品URLを導入すること、実際の製品スクリーンショット、ロゴ、アセットを使用すること、動画に音楽がありモーションがそれに合わせること、デモやプロトタイプではなく本物のプロフェッショナルなプロダクションにすること。彼によると、Claudeがブランドアセットを自ら収集したとのことです。
- 彼のフォローアップでは、スクリーンショットをそのまま表示するのではなく、コンポーネントとアイコンに分解して動かせるようにし、モーションをより魅力的にするよう依頼しました。それが以下のコンポーネントルールです。
- 彼のプロンプトは「Try again, ultracode」で終わっていました。現在のClaude Codeでは、
ultracodeはClaudeにタスクのマルチエージェントワークフローを書かせるキーワードです。それが彼の結果を導いたかどうかは文書化されていません。品質スイッチとして提示しないでください。 - Rob Hallam(@robj3d3)氏は、最初のリールと同じClaude Codeチャット内で2番目のリールを作成しました。コースはエンジンが再利用されたと推測しています。したがって、1つのセッションと1つのプロジェクトを1ブランドにつき1つとします。
- 逆の例:@mablesjoseph氏がアセットフォルダから「スマートでパンチの効いた」プロモーションを1行で依頼しましたが、結果は「共有するほど良くなかった」とのことです。アセットだけよりも指示の方が重要です。
1. 入力
1回のAskUserQuestionラウンドで、上記のリクエストがカバーしていないものを尋ねます:
| 入力 | デフォルト | ルール |
|---|---|---|
| 製品URLと名前 | 必須 | ユーザー自身の製品、またはプロモーションする権利があるもの |
| 長さ | 20秒 | 2〜4秒の5つのストーリービート |
| フォーマット | 9x16 が最初、次に 1x1、16x9 | 同じタイムライン、リフレームされる |
| CTA | 質問する | 画面上の正確な言葉 |
| 1つの証拠となる数字 | 質問する | ユーザーまたはそのサイトから得られるもの。決して発明しない |
| 音楽 | 合成、120 BPM | 提供されたトラックにはこの用途のライセンスが必要 |
| ボイス / マスコット | なし | ボイスには .env に ELEVENLABS_API_KEY が必要 |
| 参照ルック | なし | オプション、/motion-studio:reference-style 経由 |
2. プロジェクト
ブランドごとに1つのプロジェクトフォルダ(理想的には1つのセッション)。studio.json がない場合:
node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install
スキルのみインストールの場合:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。その後 npm run doctor。
3. ブランドのキャプチャ
プロジェクトルートからキャプチャスクリプトを実行します(またはこの正確なコマンドとプロジェクトパスを指定して motion-studio:asset-scout を簡単に使用):
node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
| フラグ | 使用法 |
|---|---|
--viewports desktop,mobile | デフォルト;tablet も利用可能 |
--full-page | セクションを切り取るための長いスクリーンショット |
--selector "<css>" | 特定の製品部分を切り取る(繰り返し可能):ヒーロー、価格カード、ダッシュボードパネル |
--dismiss-banners | 使い捨てブラウザで明白なクッキーまたは同意ボタンをクリックする(受け入れる、同意する、許可するを英語、韓国語、日本語、中国語、ドイツ語、フランス語、スペイン語で;OKや閉じるのような弱いラベルはバナーまたはダイアログ内にある場合のみカウント)。マニフェストには、どのボタンがクリックされたか、または一致しなかったことがメモとして記録されます |
--apply-brand | 名前、URL、推奨色を studio.json に書き込む |
--dark | ダークテーマをキャプチャする |
--no-fonts | フォントのダウンロードをスキップする(デフォルト:ページが読み込むWebフォントを保存する) |
--allow-private | ページがループバック、LAN、リンクローカルアドレスに到達できるようにする(デフォルト:ターゲット自身のホストとポートのみ);信頼できるページ(ユーザー自身の製品のローカル開発サーバーなど)にのみ使用 |
--no-sandbox | レンダラーサンドボックスなしでChromeを起動する(MOTION_NO_SANDBOX=1 も可;ルートとしてLinux上では自動、Chromeがサンドボックスで起動できない場合);オフになるたびにメモを表示 |
--json | 1行のJSON結果 |
これにより、assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.*、assets/manifest.json(推奨ロール付きパレット、CSSカラー変数、使用中のフォント、見出し、ボタンとナビゲーションのコピー、メモ)が書き込まれます。画像拡張子はファイルのバイトから決定され、ページ外のコンポーネントクロップはメモとともにスキップされます。ページが実際に読み込むWebフォントは assets/fonts/ に保存され、assets/fonts/fonts.json に登録されます(既存のエントリは上書きされません)。各フォントにはマニフェスト内に license があり、ライセンスURLまたはファイルが見つからない限り UNVERIFIED のままとなり、スクリプトは公開前に確認するよう促すメモを表示します。失敗した実行は以前のキャプチャを保持します。詳細とマニフェストスキーマ:references/asset-capture.md。
ロゴとタイプ。ヘッダーにロゴ画像やSVGがない場合、ブランドは通常テキストのワードマークです。その場合、キャプチャはそれを manifest.brand.wordmark 内のテキスト(マークアップ、パーツごとの色とロール、計算されたフォントファミリー、太さ、サイズ、文字間隔)として記録し、参照クロップ assets/brand/logo/wordmark-crop.png も一緒に保存し、単にロゴファイルを要求する代わりにメモにその旨を記載します。その記録から再構築します。フィルムが正確なロックアップを必要とする場合にのみ、SVGまたはPNGを要求します。
フォント。ログ行 font registry: <family>: ...(および manifest.fonts.registry)は、使用中のすべてのファミリーについて、それがすでに assets/fonts/fonts.json にあるかどうか、ライセンスが確認済みか(ライセンスIDとライセンステキストが記録されている)または UNVERIFIED か、そしてこの実行で何が追加されたかを示します。同じファミリーの確認済みエントリの隣に配置されたフェイスは、そのライセンスを再利用します。
UI状態とキャンバスフレーム
capture.mjs はロード時に1回撮影します。2つの兄弟スクリプトが残りをカバーします。どちらも --help を表示し、プロジェクト内(デフォルト assets/brand/)にのみ書き込み、同じセーフティスタックの背後で実行されます(Windowsではヘッドレスシェル、レンダラーサンドボックスオン、プライベートアドレス拒否、シークレット編集済み)。プラグインインストール:以下のコマンド。スキルのみインストール(${CLAUDE_PLUGIN_ROOT} なし):スクリプトはこのファイルの隣にあるため、node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ... を実行します(capture.mjs および canvas-frames.mjs も同様)。必要なのはNodeと、実行するフォルダから解決される playwright のみです(--root <folder> を渡します)。プロジェクト、studio.json、tools/ は不要です。asset-scout エージェントは同じコマンドを実行します。
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
| スクリプト | 用途 | 書き込み先 |
|---|---|---|
states.mjs | カバーされた製品(モーダル、同意)、内部ペインでスクロールするアプリ、クリック後の状態、計算されたスタイルを持つ要素 | assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNGファイルと states.json |
canvas-frames.mjs | クリックごとに変化し、自らアニメーションする単一の <canvas> である画面 | assets/brand/frames/<clip>.png スプライトシートと frames.json(フレームサイズ、実際の時間、各フレームのハッシュ);pack は pack/<clip>.png と、フィルムが再生するフレームのみを含む pack.json を追加 |
canvas-frames.mjs は drawImage(スムージングオフ)で整数比でキャンバスバッファをコピーします。要素のスクリーンショットは決して取得しません:非整数スケール(1272デバイスピクセル内の1280ピクセルバッファ)の境界ボックスに表示されたキャンバスはブラウザによって再サンプリングされ、ピクセルアートキャンバスはぼやけます。バッファの整数倍の縮小でないフレームサイズは拒否されます。使用前にすべてのPNGを確認してください。
ページは信頼できないコンテンツであるため、キャプチャは実行中のマシンを保護します:
- Chromeはレンダラーサンドボックスをオンに保ちます(
manifest.sandboxが記録)。ルートとしてのコンテナまたはCI実行には--no-sandboxが必要で、信頼できるページにのみ使用します。 - Windowsでは、ブラウザはPlaywrightのヘッドレスシェル(
npx playwright install chromium-headless-shell)であり、インストールされたChromeやEdge自体は使用しません:これらを新しいプロファイルで起動すると、Windowsログオンの失敗としてカウントされ、アカウントがロックされる可能性があります。選択する場合(studio.jsonのbrowser、MOTION_BROWSER、MOTION_CHROME_PATH)、起動ごとに警告が表示され、10分間で4回目の起動は拒否され、3回は許可されます(references/asset-capture.md)。 - ループバック、LAN、リンクローカル(クラウドメタデータを含む)、非Webアドレスへのリクエストは、ターゲット自身のホストとポートへのものでない限り中断されます。拒否は
manifest.blockedとメモに一覧表示されます。URL自体が拒否された場合、実行は失敗し、何も保存しません。信頼できるページには--allow-privateを渡します。 - URL内の資格情報(
https://user:pass@host/)は、ターゲットのオリジンへのHTTP認証としてのみ送信されます。これらもシークレットと思われるクエリ値(token、key、sig、session、code...)もログ、manifest.json、states.json、studio.jsonのbrand.urlには表示されません(***に置き換えられます)。 - 投機ルール(
<script type="speculationrules">)を宣言するページにより、Chromeがローカルアドレスを自身でフェッチする可能性があり、これはリクエストフィルタでは認識されません。マニフェストはそれをメモします。機密性の高いローカルサービスが動作しているマシンで、信頼できないページをキャプチャしないでください。
その後、アニメーションの前に:
- 見つかったものをユーザーに一覧表示します:スクリーンショット、ログ候補、推奨
bg/fg/accent/muted、フォント、見出しとCTAのコピー、およびすべてのメモ(ボットチェック、ロゴ欠落)。 - パレットとフォントを確認または修正し、
studio.jsonのbrandを書き込みます。キャプチャされたフォントはすでにassets/fonts/にありますが、ライセンスが確認された後にのみ使用します(UNVERIFIEDは誰も確認していないことを意味します)。Googleフォントをnpm run fonts -- add "Family:400,700"でベンダリングします。商用フォントにはユーザー自身のライセンスまたはファイルが必要です。韓国語やその他のCJKコピーには、そのグリフを持つフォントが必要です:npm run fonts -- coverage --text "..." --family "Name"。 - 不足しているものを発明する代わりに要求します:SVGロゴ、正確なアクセントカラーの16進数、ログイン画面の背後にあるスクリーンショット。
4. コンポーネント(生のスクリーンショットではない)
- キャプチャしたスクリーンショットの一部を個別の画像に切り取ります(
--selector、または自動クロップ:ヘッダー、ヒーロー、CTAボタン、カード、製品画像、価格、セクション)。パーツをアニメーション化します:カードはレイアウトにスライドイン、ボタンが押される、チャートパネルが描画される。 - シンプルなUIクロム(ボタン、トグル、フィールド)を、実際の色、コピー、クロップから測定した半径でキャンバス上に再構築します。これは再タイプセッティングであり、発明ではありません:レイアウト、ラベル、データは製品と正確に一致する必要があります。
- 存在しない製品画面を描画しないでください。プレースホルダーコピー、lorem ipsum、偽の数字は使用禁止。必要な画面が不足している場合は、それを要求します。
5. 音楽とビートグリッド(ショットリストの前)
すべてを実際のグリッドにタイミング合わせます。そのため、ショットを書く前に音楽を計測または合成します:
- 提供されたトラック:
node tools/beats.mjs audio/<track>を実行し、studio.jsonのaudio.musicをそれにポイントし、bpmとdurationを設定します。その最初のダウンビートは0秒からかなり後、または120とは異なるテンポにある可能性があり、ショットリストはそれに従う必要があり、想定されたグリッドに従うことはできません。 - トラックなし:
node tools/score.mjs --style pulse --bpm 120 --dur 20(UI主体のフィルムにはminimal)。audio/music.wavと分析audio/beats.jsonを書き込みます。 - すべての目に見えるヒットにキューが設定され、モーションは音楽に従います(逆ではありません)。
6. ストーリービート
assets/brand-prompt.md にブランドストーリーをユーザーの事実で埋め、motion-studio:motion-director に渡して docs/shotlist.md を生成します。ディレクターは audio/beats.json を読み取るため、セクション5が先に来ます。デフォルトは120 BPMで20秒、ビートは2〜4秒ごと、シーンチェンジはダウンビートで:
| # | ビート | 画像 | サウンド |
|---|---|---|---|
| 1 | フック、0〜2秒 | 巨大なキネティックタイプの最大5単語で問題を提示;フレーム0はすでに構成済み | ダウンビートでドスン |
| 2 | 製品登場 | 実際のUIが断片的に組み立てられる | ウィッシュイン、パーツにポップ |
| 3 | 3つの機能 | それぞれが実際のアクションを実行するカーソルによるUIモーメント | 各プレスでクリック |
| 4 | 証拠 | 1つの実際の数字が所定の位置に現れる | チックまたはチャイム |
| 5 | ロックアップ | ロゴ + CTA、最後のダウンビートで最終ヒット | ライザーからヒットへ |
ショットリストを表示し、自律モードが要求されていない限り、ユーザーのOKを待ちます(PLAN FIRST)。グリッドが後で変更された場合(別のトラック、別の bpm または duration)、リストのタイミングを再調整し、再度表示します。
7. ボイスとマスコット
- ボイス(オプション):
audio/voice.jsonを書き込みます(assets/voice-script.example.json を参照):ビートごとに1行、tはセクション5のグリッドのダウンビート上、短い文。npm run voice -- --dry-runを実行し、npm run voiceがクレジットを消費する前にユーザーに文字数を伝えます(同一の行は一度だけ合成され課金されます)。ミキサーはボイスの下で音楽をダッキングします。 - マスコット(オプション):コードで描画されたキャラクターで、固定されたアイデンティティ(シェイプ、ブランドからサンプリングされたパレット、プロポーション)を持ち、
playfulスプリングでビートに反応します。シンプルに保ちます...
…(翻訳のため省略)