上傳影片至雲端
video-animado 會將 MP4 檔案產出至專案中。此技能則負責將這些檔案放入團隊可識別的雲端資料夾，並使用固定的命名規則。這些名稱將成為後續分析每個素材成效的關鍵。
規範
<由使用者確認的目標資料夾>/
<行銷活動名稱>/
30S/ 每個秒數一個子資料夾
vvs_bala_coroa/ 每個影片一個資料夾
vvs_vertical_bala_coroa.mp4 9:16 · 1080×1920
vvs_wide_bala_coroa.mp4 16:9 · 1920×1080
vvs_square_bala_coroa.mp4 1:1 · 1080×1080
como_foi_feito.md 影片製作過程說明
15S/
vvs_bala_coroa/ …
- 檔案名稱：
<前綴>_<格式>_<關鍵字>.mp4，全部小寫。預設前綴為vvs，可透過清單中的"prefixo"變更。 - 格式： 垂直影片變成
vertical，方形變成square，水平影片變成wide。不存在的格式則忽略；請勿自行發明。 - 關鍵字： 從影片標題中提取 1 到 4 個詞，全部小寫且移除重音符號。冠詞、介系詞、「和」以及「的」等會被自動移除。
- "A bala na coroa" 變成
vvs_vertical_bala_coroa.mp4。 - "Três crianças diante do poder" 變成
vvs_wide_tres_criancas_diante_poder.mp4。 - 若超過 4 個詞，必須在清單的
"palavras"中指定；腳本會拒絕直到指定為止。
- "A bala na coroa" 變成
- 影片資料夾 名稱為
<前綴>_<關鍵字>。秒數僅存在於子資料夾（30S/、15S/）與記錄中。14.0 秒的影片會歸入15S/。 - 同一個標題出現在兩個不同秒數 時，會在不同資料夾產生相同的檔案名稱。腳本會發出警告。在廣告管理平台中，請將秒數加在廣告名稱上。
- 每個影片資料夾都必須有
como_foi_feito.md，方便任何人了解製作過程。腳本會根據原始專案（atributos.projeto）自動產生此文件：- 技術規格；
- 導演、旁白與配樂；
- 概念與腳本（取自
roteiro.json）； - 專案的
ANALISE.md與RELATORIO.md：簡報、概念、創作聖經與審查備註。
操作步驟
- 目標資料夾：務必由提出需求者確認。 切勿自行猜測。如果對方未指定，請先詢問。
- 找到已同步資料夾的本機路徑。 在 macOS 上，Google Drive 桌面版通常位於
~/Library/CloudStorage/GoogleDrive-<你的電子郵件>/（My Drive/、Shared drives/）。如果收到的是 Drive 連結且有 Drive 連接器，可以透過上層資料夾鍊（parentId）找到同步環境中存在的名稱。將檔案複製到同步資料夾即完成上傳；請勿透過 API 傳送大型 MP4。 - 準備清單（
manifesto.json，請參考下方範例）：每個影片需包含標題、名義秒數、各格式的檔案路徑，以及分析用的屬性（創意指導、製作流程、旁白、配樂、原始專案）。 - 在複製前，先顯示名稱表格與目標路徑，除非對方已明確指示直接上傳。通常目標是一個共用資料夾。
- 執行
python3 ~/.claude/skills/subir-videos/subir.py manifesto.json。- 執行前，可先用
--seco參數進行乾執行：僅驗證並顯示名稱。 - 如果檔案已在雲端，可用
--so-registro：僅寫入記錄。 - 腳本會檢查尺寸與長度，拒絕不合規範的名稱或重複的標題，建立資料夾，複製檔案，為每個影片寫入
como_foi_feito.md，並將新行附加到全域記錄檔~/videos/VVS_REGISTRO.csv。
- 執行前，可先用
- 幾分鐘後檢查雲端，因為同步是在背景執行，大型檔案會需要較長時間。
- 提供資料夾連結與名稱表格，並在專案的
ANALISE.md中記錄每個影片存放的位置。
清單（範例）
{
"destino_local": "~/Library/CloudStorage/GoogleDrive-<你的電子郵件>/Shared drives/<共用雲端硬碟>/<資料夾>",
"campanha": "行銷活動名稱",
"prefixo": "vvs",
"drive_link": "https://drive.google.com/drive/folders/<目標資料夾 ID>",
"videos": [
{"titulo": "A bala na coroa", "duracao": "30S",
"arquivos": {"vertical": "…/out/30s_9x16.mp4", "wide": "…/out/30s_16x9.mp4", "square": "…/out/30s_1x1.mp4"},
"atributos": {"direcao": "2D 角色動畫", "processo": "請求影片 + video-animado",
"voz": "Gemini TTS", "trilha": "Lyria, ~120 bpm", "projeto": "~/videos/<slug>"}}
]
}
為何需要記錄
名稱 <前綴>_<格式>_<關鍵字> 是與廣告成效進行比對的關鍵（秒數會加在廣告名稱中）。團隊以這個名稱將素材上傳至廣告管理平台，該名稱會出現在媒體數據的廣告名稱中。VVS_REGISTRO.csv 儲存每個影片的屬性（創意指導、流程、旁白、配樂、實際長度），以便後續比較哪些元素有效、哪些無效。請勿在此檔案中儲存個人資料。
禁止事項
- 請勿上傳至未經確認的資料夾，也請勿刪除或重新命名資料夾中其他人的檔案。
- 請勿自行更改命名規則：規則變更須由提出需求者決定。
- MP4 檔案不應放入 git 儲存庫。