團隊成員的首次設定
當有人剛安裝好技能包且不知道缺少什麼時,此技能會手把手引導他直到能夠順利工作。全程使用平實的語言,避免術語,且每一步都實際驗證後才前進——絕不說「應該可以用吧」。
最高指導原則
未以指令驗證前一步驟,絕不前進到下一步。 若某一步失敗,就停下來解決。安裝此技能的人不一定懂終端機:如果需要他操作,要給他完整的指令,可直接複製貼上,並說明預期產生的結果。
步驟 0 — 檢查已安裝內容
python3 instalar.py --revisar
若找不到此檔案,表示尚未複製儲存庫:請重新下載儲存庫指令。其輸出會指出缺少哪些項目。從上到下依序解決。
步驟 1 — 工具程式
| 缺少項目 | 應對方式 |
|---|---|
| Python 3 | Mac 已內建。若真的無法執行:brew install python |
| rclone | brew install rclone —— 用於連線 Google 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 — 連接代理商的 Drive
這是最容易出錯也最重要的一步:沒有 Drive 就沒有簡報、沒有品牌、沒有地方儲存任何東西。
rclone config
然後逐項告知使用者需輸入的內容:
n(新遠端)- 名稱:
gdrive← 必須小寫。所有技能都會以此名稱尋找它。 - 類型:輸入
drive client_id和client_secret:Enter(留空)- 範圍:
1(完整存取權) root_folder_id:Enter- Service account:Enter
- 進階設定:
n - 使用瀏覽器:
y→ 會開啟 Chrome → 使用 Dirección 提供的 Flowboost 帳號登入並接受 - Shared drive:
n· 確認:y· 結束:q
實際驗證(光是說完成不算):
rclone lsd gdrive: | head -5
必須看到客戶資料夾清單(i_…、c_…)。若清單為空或顯示錯誤,表示未連線成功:請重複步驟 2。
步驟 3 — 自己的工作資料夾
mkdir -p ~/Desktop/CLIENTES && echo OK
所有下載或建立的客戶資料都存放在 ~/Desktop/CLIENTES/<客戶>/。切勿直接放在「下載」資料夾中。
步驟 4 — 僅特定領域需要的項目
詢問使用者負責什麼領域,只安裝相關項目。不要要求安裝不會用到的東西。
| 負責領域 | 需要項目 | 提供者 |
|---|---|---|
| 廣告活動或報表 | Meta Ads 的讀取權限 | Dirección 將其加入 Business Manager |
| 報表 | 無其他需求:試算表已在 Drive 中 | — |
| 靜態素材 | 代理商的 ChatGPT 帳號 | Dirección。⚠️ 絕不給 <correo-direccion> 帳號 |
| 影片 | 遠多於 ffmpeg:Python 函式庫、語音辨識模型、QC 工具、MoneyPrinterTurbo 及其 自己的 Pexels 金鑰、約 8 GB 磁碟空間。請逐步遵循 editar-vsl-cliente/INSTALACION.md,並使用 python3 ~/.claude/skills/editar-vsl-cliente/scripts/comprobar_entorno_edicion.py 驗證 | 使用者本人(Pexels 金鑰由其自行設定,不可透過聊天提供) |
| 登陸頁 | 客戶主機的存取權 | Dirección(需發佈時提供) |
⚠️ 絕不透過聊天要求密碼或金鑰,也絕不由 AI 代理輸入。 若需金鑰,則由使用者在其電腦上自行設定,並告知設定位置。
步驟 5 — 實際測試
直到以下指令成功執行才算完成:
rclone lsd gdrive: | wc -l
若輸出數量大於零,即表示設定完成。接著告訴使用者現在可以要求什麼,並提供其負責領域的範例:
- 報表:「給我 <客戶> 的報表」、「將 <客戶> 加入報表中」
- 廣告活動:「建立 <客戶> 的廣告活動」(會以暫停狀態建立;啟用始終由 Dirección 負責)
- 靜態素材:「製作 <客戶> 的靜態素材」
- 登陸頁:「撰寫 <客戶> 登陸頁的文案」
從第一天起就該知道的事
- 所有給客戶的文字皆使用西班牙(西班牙)用語。 不可使用 vos 第二人稱單數變位。
- 不可虛構任何內容:數字、見證、日期或保證。遺漏處請標記
[FALTA]。 - 客戶的 Drive 為唯讀,除非是放置交付成果的資料夾。
- 啟用廣告活動始終由 Dirección 負責。 AI 代理僅建立暫停狀態的活動。
- 若缺少某項存取權,請告知並停止操作。 不可半途而廢。
當問題發生時
| 症狀 | 幾乎都是 |
|---|---|
| 「找不到客戶資料夾」 | Drive 未連線 → 步驟 2 |
| 「檔案 … 不存在」 | 缺少 fundamentos 套件 → 一併安裝 |
| 文案輸出無依據 | 同樣是缺少 fundamentos,且不會自動提示 |
| 「command not found: rclone」 | 步驟 1 |