/video-setup
フレッシュクローンから passed N, failed 0 の状態までをワンステップで実現します。setup.sh が作業を行います。あなたの役割は、それを説明し、了解を得て実行し、すべての FAIL 行を修正に変えることです。
まずワークベンチを見つけます(ワークベンチ内および製品フォルダから動作します):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
ユーザーの言語で話しかけてください。簡潔に:ユーザーが求めているのは動作するセットアップであり、ツアーではありません。
引数 check の場合
bash "$PVS_HOME/setup.sh" --check を実行し、結果を表示します。インストールもダウンロードも書き込みも行いません。各 FAIL 行について、その修正方法を示します(行の末尾に修正方法が記載されています)。そこで停止します。
それ以外の場合
1. マシンを報告する
最初に bash "$PVS_HOME/setup.sh" --check を実行します。アイテムごとに1行ずつ出力されます:ok、warn、または FAIL と正確な修正方法が記載されています。
- Machine 配下の行が失敗した場合(node 22+、python 3.9+、ffmpeg、git)、セットアップを続行できません。行に記載されている修正方法(例:
brew install ffmpeg)をユーザーに伝え、ユーザーのターミナルで実行してもらい、再度チェックを実行するよう依頼してください。システムパッケージのインストールはユーザーの責任であるため、ユーザーが依頼しない限り、brewやaptを自分で実行しないでください。 - Claude Code の
warnは情報提供です。 - Toolchain 配下の FAIL 行は、setup がインストールするものです。初回実行時はこれは想定内です。
2. ダウンロードされるものを説明し、一度だけ尋ねる
チェックで不足していると報告されたものだけを、簡潔なリストでユーザーに伝えます:
| ピース | サイズ | 保存場所 |
|---|---|---|
| 固定バージョンの HyperFrames CLI とその依存関係 | 約 128 MB | node_modules/ |
| HyperFrames がレンダリングに使用する Chrome ビルド | 約 195 MB(キャッシュされている場合はスキップ) | HyperFrames キャッシュ |
| 同じリリースタグの HyperFrames エージェントスキル | 数 MB | vendor/hyperframes/skills/ |
| Python パッケージ(主に音声認識用 torch) | 約 339 MB | .venv/ |
QA が使用する whisper small.en 音声モデル | 484 MB | ~/.cache/whisper/ |
閉じた質問を1つ行います:「これらを今インストールしますか?(はい / いいえ)」セットアップは最初の /video-setup からワンステップで完了する必要があるため、複数の確認に分割しないでください。
3. 実行する
「はい」の場合、bash "$PVS_HOME/setup.sh" --yes を実行します(--yes はユーザーの回答であり、すでに与えられています)。初回実行時は数分かかり、すべてがキャッシュされている場合は数秒で完了します。タイムアウトは最低10分に設定してください。これは冪等です:再度実行しても、不足しているものだけが再実行されます。
4. 各 FAIL を処理する
各 FAIL 行にはその修正方法が記載されています。一般的なもの:
| FAIL | 対処方法 |
|---|---|
npm install failed | ネットワークまたはレジストリの問題。ログの最後の数行を表示し、setup を再実行します |
hyperframes browser ensure failed | ワークベンチから npx hyperframes browser ensure --force を実行し、その後 setup を再実行します |
could not clone heygen-com/hyperframes | ネットワークまたは GitHub アクセスの問題。git ls-remote https://github.com/heygen-com/hyperframes を確認し、その後 setup を再実行します |
python3 -m venv failed | Debian または Ubuntu の場合:sudo apt install python3-venv(ユーザーが実行します) |
pip install -r requirements.txt failed | ログの末尾を表示します。ピン留めよりも新しい Python では新しい wheel が必要になる場合があります。その場合は、ピンを編集するのではなく報告してください |
hyperframes doctor: ... | 行に失敗したチェックとその修正方法が記載されています。バージョン、Docker、およびオプションのローカル音声と音楽チェックは意図的に無視されます |
tests/run.sh: passed N, failed M | bash "$PVS_HOME/tests/run.sh" を実行し、失敗したテストとその出力を表示します |
hyperframes upgrade や hyperframes skills update を実行して FAIL を「修正」しないでください。ワークベンチは 1 つの HyperFrames リリースを固定し、同じタグからスキルを取得します。異なるリリースの CLI とスキルは構成契約について一致しないためです。バージョン変更は tests/run.sh に合格するプルリクエストです。ガードフックはどちらのコマンドもブロックします。
5. 音声キー
セットアップは .env.example から .env を作成し、ElevenLabs キーが設定されているかどうかを、表示せずに通知します。空の場合は、ユーザーに次のように伝えます:
- 自分のエディタで
.env(ワークベンチフォルダ内)を開き、ELEVENLABS_API_KEY=の後にキーを貼り付けます。チャット内では絶対に行わないでください。チャット内のすべてはトランスクリプトに保存されます。もしユーザーがここに貼り付けてしまった場合は、ローテーションするように伝えてください。 - キーがない場合、製品の
product.yaml内のvoice.provider: sayは無料の macOS 音声を使用します。これはドラフトやテストには十分です。
.env を自分で開いたり、読んだり、表示したりしないでください。設定により拒否され、ガードフックによってブロックされます。スクリプトは lib/pvs.py を通じて自分でキーを読み込みます。
6. 完了
出力の最後の行に passed N, failed 0 と Setup done が含まれていることを確認します。次に、次の手順を一行で示します:製品を追加するには /product-new <slug>、状況を確認するには /video-ask。