セットアップして
ユーザーがラボを初めて開いた状態です。技術に詳しくありません。最終的には、すべてがインストールされ、自分の顔で確認して選んだルックと、保存された自分のキットが揃います。これで最初のリールを作成する準備が整います。
トーン: 温かく、簡潔に、一度に一つのステップ。待っている間は何が起こっているかを伝えてください。生のツール出力をそのまま貼り付けないでください。コマンドを実行するように依頼しないでください(Homebrewが不足している場合の1行を除く。ステップ1参照)。
最初に短いメッセージを1つ送信します:
リール編集ラボへようこそ。セットアップには約10分かかります:いくつかのものをインストールし、3つの簡単な質問をし、あなたの動画でルックを選びます。始めましょう。
1. インストール (約5分、ほとんどは音声モデルのダウンロード)
python3 tools/doctor.py を実行します。チェックリストと DOCTOR=ok または DOCTOR=missing:<名前> を表示します。不足している項目を次の順序で修正し、最後に doctor を再実行します:
- mac / space: いずれかが失敗した場合は、停止して親切に説明します(Appleチップ搭載Macが必要、約6GBの空き容量が必要)。
- homebrew: ユーザーの代わりにインストールすることはできません。実際のターミナルでMacパスワードが必要なためです。理由を1行で説明し、doctorの修正から正確な行を提供し、ターミナルアプリを開くように指示します(Cmd+Space、Terminalと入力)。貼り付けて、Enterキーを押し、Macパスワードを入力し(入力中は何も表示されません。正常です)、プロンプトに従うよう伝えます。最後にHomebrewが
echoとevalで始まる2行の「Next steps」を表示するので、それらも貼り付けるように依頼します。完了したと言われるまで待ち、再確認します。 - apple-tools:
xcode-select --installを実行します。Macのウィンドウがポップアップするので、インストールをクリックし、完了したら知らせるよう伝えます(数分かかります)。Homebrewが通常これらをインストールするので、最初に確認します。 - ffmpeg:
brew install ffmpeg(brewがまだパスにない場合は/opt/homebrew/bin/brewを使用)。 - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh、その後uvが見つからない場合は~/.local/bin/uvを使用。 - python-tools:
uv sync - renderer:
uv run playwright install chromium - speech-model: バックグラウンドで
uv run tools/get_models.pyを実行(2.3 GB)。接続が切れても自動で再開します。ダウンロード中にインタビューに進みます。ステップ3で必要になる前に、ダウンロードの状態を確認します。
インストール中は、各ツールが何のためにあるのかを1行で説明します(doctorの説明文はそのために書かれています)。
2. ブランドインタビュー (3つの質問、一度に1つずつ)
会話形式で質問し、メッセージごとに1つの質問をします。ユーザーの正確な言葉をそのまま保存します。
名前、タグライン、「何をしているか」のラベルは尋ねないでください。ラボはデフォルトでは追加しません(新しいリールスキル「label」を参照)。
- エネルギー.「カメラに映るとき、あなたはどんな感じですか:落ち着いていて思慮深い、温かくておしゃべり、それともハイテンション?」これにより、編集の忙しさが決まります(ステップ4の表を参照)。
- ブランド.「ブランドやデザインファイル、ブランドカラー、フォントはありますか?デザインファイル(.mdまたはPDF)をドロップすると、そこからあなたのルックを作成します。または、カラーコードを貼り付けたり、お気に入りのリールのスクリーンショットを3~6枚
inspirationフォルダにドロップしてください。または「いいえ、オプションを見せて」とだけ言ってください。」 - 絶対に使わないもの.「リールに絶対に使いたくないものはありますか?例えば、すべて大文字のテキスト、特定の絵文字、効果音、絶対に言わない言葉など。」
回答を brand/profile.md に保存します:
# プロフィール
- エネルギー: 温かくておしゃべり
- ブランド: カラー #… / フォント … / inspiration/ 内のスクリーンショット / なし
- 絶対に使わないもの: …
また、各「絶対に使わないもの」を brand/preferences.md に1行ルールとして追加します。
3. 自分の顔でルックを確認する
尋ねます:「では、あなたがカメラに向かって話しているクリップを1つドロップしてください。できれば20秒以上。このチャットまたは inbox フォルダにドラッグしてください。完璧なテイクでなくても大丈夫です。ルックを試すためのものです。」
クリップが配置され(音声モデルが完了したら):
-
uv run tools/transcribe.py "<クリップ>" --name welcome-sample -
projects/welcome-sample/lines.mdを読みます。最初の3~5行のクリーンなライン、約12~20秒 でcut.jsonを作成し、新しいリールのラフカットルール(最後のクリーンテイク、言い間違いなし)を使用します。uv run tools/roughcut.py projects/welcome-sample --no-openとuv run tools/verify.py projects/welcome-sampleを実行し、フラグが立ったものを修正します。このカットのレビューはユーザーに依頼しないでください。これはサンプルにすぎません。 -
build.jsonを新しいリールスキルと同様に記述します:ユーザーが実際に言ったことからhooksスキルを使ってフックを書き(これはラボの第一印象なので、良いものにしてください)、1~2のハイライトワード、1つのズーム、最も強いラインに1つのステートメントを追加します。visualsスキルを使って2~4のポップアップを追加し(例えば、言及されたリストのチップ、プロンプトについて話す場合のチャットウィンドウ)、ラボが実際に何をするかをユーザーに見せます。ビハインドモーメントは追加しないでください。 -
ルックシート:
uv run tools/build.py projects/welcome-sample --looks presetsを実行します。すべてのルックでクリップが並べて表示された1つの画像が開き、LOOKS=の後に印刷された順序で表示されます。最初に自分で画像を確認し(Read it)、テキストが読めること、顔を覆っていないことを確認します。 -
印刷された順序で、各ルックを1行ずつ短く紹介し、各キットの
description(packs/<名前>/kit.json)を使用します。上の行はフックとキャプション、下の行はポップアップを示します。 次に、ルックは出発点であり、最終的な選択ではないことを明確に伝えます:一番 雰囲気 が気に入ったものを選んでください。すべて後から変更できます:「これだけど、セージとクリームで」、「私のカラーを使って:…」、「もっと柔らかいフォントで」、「ピンクなし」。あなたのクリップでやり直して見せます。
どれを動いているところを見たいか尋ねます。
-
ユーザーが選んだ各ルックに対して:
uv run tools/build.py projects/welcome-sample --kit <名前> --out sample-<名前>を実行します。QuickTimeで開きます。2つ選んだ場合は、両方を作成して順に開きます。
ユーザーがステップ2でブランドカラー、フォント、スクリーンショットを提供した場合は、「あなたのブランドからルックを作ることもできます」と提案します。ステップ5を参照。
4. キットを保存する
ユーザーが選択したら(例:「エディトリアルだけど、セージとクリームで」または「プレイフルだけど、もっと落ち着いて」):
-
packs/<プリセット>/kit.jsonをpacks/<ユーザーのファーストネーム-小文字>/kit.jsonにコピーします。コピー内で:"name": ユーザーの名前"preset": false"based_on": "<プリセット>"
-
ユーザーのエネルギーを適用します:
エネルギー intensity zoom jump / punch sfx volume_db statements 落ち着いていて思慮深い clean 1.04 / 1.08 −17 最大1 温かくておしゃべり signature 1.07 / 1.13 −13 最大1~2 ハイテンション full 1.12 / 1.22 −10 最大2 rules.intensity、zoom、sfx.volume_db、rules.statementの文言を一致するように変更します。サウンドセット(
sfx.palette):- 落ち着いている:
soft - 温かい:
softまたはplayful - ハイテンション:
punchy - テクノロジーやAI関連のトピック:
clickyを検討
すべてのサウンドは
sfx/sound-menu.mp4で聞くことができ、「プレイフルなサウンドを使って」と依頼することでセットを切り替えられることを一度伝えます。ユーザーが「効果音なし」と言った場合は、"sfx": {}を設定します。すべて大文字禁止と言った場合は、style.caption_case、style.hook_case、style.statement_caseを"none"に設定します。 - 落ち着いている:
-
ユーザーのカラーを適用します。インタビューからか、その場で依頼された場合(「代わりにこれらの色を使って」):
- 16進数カラーコードまたはプレーンな色名から: 「sage」や「dusty pink」で問題ありません。センスの良い16進数を選び、ユーザーに伝えます。
colorsの値を入れ替え、役割を維持します:明るい色はカードとキャプションに、暗い色はステートメントの背景とインクに、鮮やかな色はハイライトとvisuals.rotateに使用します。- コントラストを確認: テキストが背景に対して読みやすいこと。
- ルックシートを再レンダリング してキット用に(
--looks <ユーザーのキット>)、フルサンプルの前にユーザーが確認できるようにします。 - フォントも同様に機能します: 無料のGoogleフォントであれば何でも(
fonts.pyで存在を確認)。
-
キットのフォルダ名を
brand/kit.txtに書き込みます。 -
ユーザーのキットでサンプルをもう一度作成します:
uv run tools/build.py projects/welcome-sample --out sample-mine。QuickTimeで開きます。尋ねます:「これがあなたのルックです。何か変更したいことはありますか?」変更をキットに適用し(プリセットではなく)、満足するまで再作成します。「キャプションを小さく」「黄色を減らして」「傾きなし」のような小さな変更は、kit.jsonの1行編集です。
5. ブランドからルックを作成する(依頼された場合)
デザインファイルから(最良の方法)
ユーザーがブランドまたはデザインのドキュメント(.md、PDF、Google Docのエクスポートなど、BRAND-DESIGN.md のようなもの)を持っている場合:
-
ファイルを入手します。 チャットにドラッグするか
brand/にドロップするよう依頼し、コピーをbrand/design.mdとして保存します(またはPDFのまま)。ルックのソースオブトゥルースとして使用します。 -
キットにマッピングします:
デザインファイル内 kit.json内カラーパレット(16進数コードとその用途) colors、さらにroles:背景 →hook_cardとlabel_bg;テキストカラー →inkとhook_text;「ステートメント」または暗いブロック →statement_bg;ハイライトカラー →highlight_blocks;アクセント →accent_pill、visuals.rotate「純黒や純白は使わない」などのルール 最も暗いブランドカラーをインクとして使用 見出しとディスプレイフォント fonts.display/poster、そのイタリック体をfonts.italic、サンセリフ体をlabelとキャプションに特徴的な動き(イタリックの混在、単語の後ろのハイライトブロック、傾き、ステッカー、すべて大文字) movesとstyle(hook_case、statement_case、radius)ムード(「落ち着いた」「遊び心のある」「高級感」) visuals.motion、visuals.density、sfx.palette写真や動画のスタイル(暖かみ、ムーディー、明るい、フィルムライク) grade:contrast、saturation、brightness、warmth(−0.05~0.05)、vignette(0~0.5)、legibility(テキスト背後に暗いグラデーション、0~0.5)。肌は自然に保つ:フィルムグレインなし、強いクラッシュなし。アイコン、グラフィック要素、ステッカー、ボタン(線の太さ、角丸または四角、塗りつぶしカラータイル) visuals.icon_stroke(細い1.5 → 太い2.5)、visuals.radius、visuals.card(solid / outline / glass)、visuals.accent(アイコンタイルの色)、visuals.rotate(チップとステッカーの色) -
有料またはカスタムフォント: フォントファイルを探します。ユーザーが持っている場合は
fonts/private/にドロップし、キットは"file"を使用します。持っていない場合は、最も近い 無料のGoogleフォント を選びます:コントラスト、幅(縦長か横長か?)、イタリック体があるかどうかを一致させます。何を代用したか、その理由を伝えます。例:「あなたの有料セリフフォント → Instrument Serif:同じ縦長でコントラストの高い雰囲気、イタリック体あり。」 -
表示します:
--looks <ユーザーのキット>をレンダリングし、sample-mineをビルドします。どの部分がファイルから直接来たか、どの部分を解釈したかを説明します。 -
同期を維持します: 後でユーザーがデザインファイルを更新した場合(「ブランドカラーを変更しました」)、
brand/design.mdを再読み込みし、同じ方法でキットを更新します。
スクリーンショットまたは貼り付けられたカラーから
ユーザーがプリセットではなく独自のルックを希望する場合:
inspiration/内のスクリーンショット、ブランドガイド、または貼り付けられたコードを読みます。以下に注意します:- タイプ:セリフかサンセリフか、どの程度太いか、すべて大文字か、イタリック体が混在しているか
- キャプションの処理:アウトライン、シャドウ、ボックス;フレーズ全体か単語ごとか
- カードの形状と半径
- 4~6色
- どの程度情報量が多いか
- 最も近いプリセットから始め、異なる部分のみを変更します。フォントは 無料のGoogleフォント である必要があります:
{"family": "<Googleフォント名>", "google": true, "weight": N}と記述します(イタリック体の場合は"italic": trueを追加)。各フォントがuv run tools/fonts.py "<ファミリー>" --weight Nでダウンロードできることを確認します。ユーザーが有料フォントを所有している場合は、ファイルをfonts/private/にドロップし、{"family": "...", "file": "fonts/private/<ファイル>", "weight": N}を使用できます。 - 他のクリエイターの正確なフォントとカラーをコピーしないでください。雰囲気を取り入れ、トレードマークのルックはコピーしません。
--looks <ユーザーのキット>をレンダリングして確認し、ステップ4と同様にsample-mineをビルドし、チャットで繰り返します。
6. 完了
約3行で、次のことを伝えます:
-
ルックは保存され、すべてのリールで自動的に使用されます
-
リールの編集方法:
inbox/またはチャットにクリップをドロップし、「このリールを編集して」と言います。あなたがカットし、ユーザーがチャットでラインをレビューし、ルックでビルドします。 -
ポップアップグラフィックはユーザーの言葉を説明します。「グラフィックを見せて」と指示すると、ルック内の全14種類のカタログが再生されます
-
オプションの追加機能:チャットに自分のリールを6つドロップすると「周回するリール」効果とプロフィールグリッド(
tools/reels.py add)を適用できます。Instagramの本物の数字を一度提供すると(brand/instagram.jsonに保存)、フォローアニメーションに使用されます -
任意のラインでミームやGIFを依頼できます(「このラインにデヴィッド・ローズの「ew」ミームを入れて」)。検索には無料のGIPHYキーが必要で、初回は入手を支援します。ユーザー自身のGIFファイルはすぐに使用できます
-
カラーとフォントはいつでも変更可能です:「代わりにこれらの色を使って」と任意のリールで言うだけで機能します
-
いつでも何でも変更できます。「キャプション小さく」「このリールは音なし」「このリールにはLoudルックを試して」など
-
完成したリールは 完成したリール フォルダに保存されます
-
コマンド:/new-reel で新しいクリップ(各リールごとにこのフォルダで新しいチャットを開始)、/update で新しいバージョンを取得、/report-problem で問題が発生した場合に報告
その後、「今提供したクリップを最初の実際のリールとして編集してみませんか?」と提案します。はいの場合、このチャットで新しいリールスキルを実行します。
キットスタイルスイッチ(微調整用)
kit.json → "style":
caption_outline: px; 0はシャドウのみを意味しますcaption_case: "none" / "uppercase"hook: "card" / "bare"(カードなし、アウトラインテキスト)hook_sizehook_casestatement_caselabel: "ticket" / "pill"label_mark: 名前とトピックの間の記号radiusshadow/shadow_soft: rgba色
"captions":
mode: "karaoke"(単語が光る)、"phrase"(フレーズ全体)、"word"(一度に1つの大きな単語)sizemax_wordsposition_y
"moves":
tilt_degreeshighlighter_blocks