チームメンバーの初期セットアップ
誰かがスキルパッケージをインストールしたばかりで、何が必要かわからない状態です。このスキルは、作業ができるようになるまで手取り足取り導きます。専門用語なしの平易な言葉で話し、各ステップを実際に確認してから次に進みます。「たぶん動くはず」はありません。
すべてに優先するルール
前のステップをコマンドで確認せずに次のステップに進んではいけません。 ステップが失敗したら、そこで止めて解決します。これをインストールする人はターミナルが何か知っているとは限りません。何かを依頼するときは、コピペしてそのまま実行できる完全なコマンドを提示し、どのような出力が出れば成功かを伝えてください。
ステップ 0 — インストール内容の確認
python3 instalar.py --revisar
ファイルが見つからなければ、リポジトリをクローンしていないことになります。もう一度クローンするコマンドを伝えます。出力には不足しているものが表示されます。上から順に解決します。
ステップ 1 — ツールの確認
| 不足 | 対応方法 |
|---|---|
| Python 3 | Macには標準で入っています。本当にない場合: brew install python |
| rclone | brew install rclone — Driveに接続するために必要です |
| openpyxl | pip3 install openpyxl — レポートシートを扱う場合のみ必要 |
| ffmpeg | brew install ffmpeg — 動画編集を行う場合のみ必要(その場合は editar-vsl-cliente/INSTALACION.md の手順もすべて必要)。そうでなければスキップ |
Homebrewがインストールされていない場合: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
ステップ 2 — エージェンシーのGoogle Driveに接続
最も失敗が多く、最も重要なステップです。Driveがなければ、ブリーフもブランディングも、成果物の置き場もありません。
rclone config
そして、以下の手順を1つずつ伝えます:
n(新規リモート)- 名前:
gdrive← この通り、小文字で。スキルはこの名前で探します。 - 種類:
driveと入力 client_idとclient_secret: Enter (空白のまま)- スコープ:
1(フルアクセス) root_folder_id: Enter- サービスアカウント: Enter
- 詳細設定:
n - ブラウザを使用:
y→ Chromeが開く → Flowboostのアカウント(ディレクションから指定されたもの)でログインし、許可 - 共有ドライブ:
n· 確認:y· 終了:q
実際に確認する(「終わった」と言うだけでは不十分):
rclone lsd gdrive: | head -5
クライアントのフォルダ一覧(i_…、c_…)が表示される必要があります。空だったりエラーが出たら、接続されていません: ステップ2をやり直します。
ステップ 3 — 作業ディレクトリの作成
mkdir -p ~/Desktop/CLIENTS && echo OK
クライアントに関するダウンロードや作成物はすべて ~/Desktop/CLIENTS/<client>/ に配置します。ダウンロードフォルダにばらまかないでください。
ステップ 4 — 特定の担当業務でのみ必要なもの
どの業務を担当するかを尋ね、必要なものだけをセットアップします。使わないものは要求しません。
| 担当業務 | 必要なもの | 誰が提供するか |
|---|---|---|
| キャンペーンまたはレポート | Meta Ads の読み取りアクセス | ディレクションがBusiness Managerに追加 |
| レポートのみ | それ以外は不要:シートはすでにDrive上にある | — |
| 静的クリエイティブ | エージェンシーのChatGPTアカウント | ディレクション。⚠️ 決して <correo-direccion> アカウントを使ってはいけません |
| 動画編集 | ffmpeg だけでは不十分:Pythonライブラリ、文字起こしモデル、QCツール、MoneyPrinterTurbo(自身のPexels APIキー付き)、約8GBのディスク容量が必要。editar-vsl-cliente/INSTALACION.md をステップバイステップで実行し、python3 ~/.claude/skills/editar-vsl-cliente/scripts/comprobar_entorno_edicion.py で確認 | 自分自身(Pexels APIキーは自分で設定し、チャットでは決して共有しない) |
| ランディングページ | クライアントのホスティングへのアクセス | 公開時にディレクションが対応 |
⚠️ パスワードやAPIキーをチャットで要求したり、エージェントが代わりに入力したりしてはいけません。 キーが必要な場合は、ユーザー自身が自分のコンピュータで設定するよう説明し、その場所を指示します。
ステップ 5 — 最終動作確認
以下のコマンドが成功するまではセットアップ完了としません:
rclone lsd gdrive: | wc -l
0より大きい数字が表示されれば準備完了です。その時点で、今すぐ何を依頼できるかを、担当業務に応じた例とともに伝えます:
- レポート: 「のレポートを出して」「をレポートに追加して」
- キャンペーン: 「のキャンペーンを作って」(作成は停止状態で行います。公開は常にディレクションのみ)
- 静的クリエイティブ: 「の静的クリエイティブを作って」
- ランディングページ: 「のランディングページのコピーを書いて」
最初から知っておくべきこと
- クライアント向けのテキストはすべてスペイン語(スペイン)で書きます。「voseo」は使わないこと。
- 情報を捏造しない: 数字、 testimonial(お客様の声)、日付、保証など。不足しているものは
[FALTA]とマークします。 - クライアントのDriveは読み取り専用です(成果物フォルダへの書き込みは除く)。
- キャンペーンの公開は常にディレクションの権限です。 エージェントは停止状態で作成します。
- アクセスがない場合は、その旨を伝えて停止します。 中途半端に続けてはいけません。
よくある問題とその原因
| 症状 | ほぼ確実な原因 |
|---|---|
| 「クライアントのフォルダが見つからない」 | Driveが接続されていない → ステップ2 |
| 「ファイル…が存在しません」 | fundamentos パッケージがインストールされていない → 併せてインストール |
| コピーの品質が悪い | 同上: fundamentos が不足しており、警告も出ない |
| 「command not found: rclone」 | ステップ1を実行 |
注意: 原文の「CLIENTES」はディレクトリ名としてそのまま使用しています。必要に応じてローカライズしても構いませんが、スキルが内部で参照するパスと整合性を取る必要があります。