scourtain/reels-engine

リールセットアップ

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME が設定されていればその値、そうでなければ Mac の場合は ~/Movies/Reels、Windows の場合は ~/Videos/Reels。ENGINE init-home でパスが表示されます。 コマンド内では、HOME と PROJECT のパスを必ずダブルクォーテーションで囲み、エンジンが表示した通りの完全なパスを記述してください（ダブルクォーテーション内の ~ は機能しません）。Windows ではパスにバックスラッシュやスペースが含まれることが多く、クォーテーションがないと壊れます。

Windows の場合（uname -s で確認：Claude Code のシェル上で MINGW または MSYS で始まっている場合）、以下の手順1と2をスキップして、代わりにこれを実行してください：

• Node と ffmpeg： node --version（22 以上）と ffmpeg -version を確認します。不足しているツールは winget install --id OpenJS.NodeJS.LTS -e および winget install --id Gyan.FFmpeg -e でインストールします。Windows が「このアプリが変更を加えることを許可しますか？」という画面を表示する場合があります。その場合はメンバーが「はい」をクリックします。インストール直後にツールが見つからない場合、エンジンは winget 自身のフォルダも検索します。ENGINE doctor でまだ赤く表示される場合は、メンバーに Claude を閉じて再度開くよう依頼し、その後再確認します。
• Whisper（文字起こしツール）： Windows 用のダウンロードを curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest で取得し、アセット名が正確に whisper-bin-x64.zip のものを選択します。その名前のアセットがない場合は、処理を停止してメンバーに次のように伝えます：「Windows セットアップは最新の Whisper ダウンロードに対応するためのアップデートが必要です。Sam に連絡済みです。」それ以外の場合は mkdir -p "HOME/tools/whisper"、curl -L --fail -o "HOME/tools/whisper.zip" <そのアセットの browser_download_url>、/c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper"（Windows 標準の tar は zip ファイルを読み取れますが、Git Bash に付属の tar は読み取れません）を実行し、zip ファイルを削除します。whisper-cli.exe が配置されたことを確認します：ls "HOME/tools/whisper" "HOME/tools/whisper/Release"。どちらのフォルダにもない場合は、処理を停止してメンバーに同じメッセージを伝えます：「Windows セットアップは最新の Whisper ダウンロードに対応するためのアップデートが必要です。Sam に連絡済みです。」ENGINE doctor で whisper-cli が緑色になるはずです。
• その後、以下の手順3から続行します。ENGINE doctor で – person cutout の行（「今のところ Mac のみ」と表示されます）については、メンバーに一度だけ伝えます：「頭の後ろにタイプを表示する2つのフックルックは今のところ Mac のみです。残りの4つは動作します。」これに対する修正は提供しないでください。

1. Homebrew（ツールインストーラ）： which brew、次に /opt/homebrew/bin/brew と /usr/local/bin/brew を確認します。どれも存在しない場合、メンバーは通常の Mac インストーラでインストールします（ターミナルは不要）。メンバーを https://github.com/Homebrew/brew/releases/latest に誘導し、.pkg で終わるファイルをダウンロードさせ、ダブルクリックして画面の指示に従ってもらいます（通常の Mac ウィンドウで Mac パスワードを求められます。あなたはパスワードを入力したり尋ねたりしてはいけません）。メンバーが完了したと言うのを待ち、再度確認します。それでも brew が名前で見つからない場合は、次の手順ではフルパス（/opt/homebrew/bin/brew）で呼び出します。
2. ツール： brew install node ffmpeg whisper-cpp（既にあるものはスキップ）。その後 ENGINE doctor を実行します。赤く表示されているものは、fix ヒントを使って修正します。
   • – で始まる行はオプションです。– person cutout は、この Mac では2つのフックカードルック（頭の後ろにタイプを表示）がオフになっていることを意味します。それ以外はすべて動作します。修正は一度だけ提案します：「頭の後ろに表示する2つのフックルックを有効にしますか？ターミナルで xcode-select --install を実行し、「インストール」をクリックしてから「再確認」と言ってください。」セットアップをブロックしないでください。
3. レンダラーブラウザ + 音声モデル（初回のみダウンロード、約700MB）： npx -y [email protected] browser ensure を実行します。次に、音声モデルが存在することを確認します：~/.cache/hyperframes/whisper/models/ggml-small.en.bin または HOME/models/ggml-small.en.bin をチェックします。どちらも存在しない場合は、ダウンロードします： mkdir -p "HOME/models" && curl -L --fail -o "HOME/models/ggml-small.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.en.bin
4. ワークスペース： ENGINE init-home を実行します。これにより Reels フォルダのパスが表示され、既存のファイルは上書きされません。
5. 基本情報（一度に1つずつ質問し、HOME/brand-kit.json に保存します。ファイル内の既存のキーは保持します）：
   • Instagram ハンドル → handle
   • デフォルトのリール長（秒、デフォルトは40） → default_target_seconds
6. 語彙： よく使う名前、ツール、ブランドワード（ビジネス名、製品、アプリなど）を尋ねます。それらを HOME/vocabulary.txt に1行ずつ書き込み、文字起こしで正しくスペルされるようにします。
7. スタイル。 ../reel-style/references/style-interview.md にあるスタイルインタビューを実行します。キャプションピッカーページが開き、そこでメンバーが選択したものがデフォルトのスタイルになります。サンプルリールやリンクは求めないでください。インタビューの命名ステップはスキップします：スタイル名は常に main です（draft ではなく、直接 HOME/styles/main.json に書き込みます）。2つ目のスタイルは提供しないでください。後で /reels-engine:reel-style で追加できます。
8. 最後に次のように伝えます：「セットアップ完了です。1～4個のクリップをチャットにドラッグして「new reel」と入力するか（または /reels-engine:reel と入力）、新しいリールを作成できます。」

再実行は安全です。既に完了した手順はスキップします。基本情報の再質問は、メンバーが変更を希望する場合のみ行い、スタイルの変更は /reels-engine:reel-style に任せます。