veo_promo_animation 是給 Claude Code 使用的 Skill。開新對話說「使用flow」或「使用veo」，再提供成果貼文或活動海報，AI 會依固定流程製作成果影片。分鏡、插圖與旁白都由你確認，確認後才接著做。
📝先寫分鏡腳本
依貼文內容列出每個畫面要呈現什麼、放哪些文字、旁白怎麼說。你確認後才開始製作；名單較長時，改放在片尾。
🖼️插圖不放文字
用 Codex 依序生成每個畫面的插圖。AI 容易把中文寫錯，所以插圖一律不含文字，並集中成一張總覽圖讓你檢查。
🎞️用 Flow 生成影片片段
透過 Claude in Chrome 操作 Google Flow（建議）或 Gemini，以插圖作為第一個畫面生成影片片段。開始前由你選擇用哪一個；下載後自動對應到分鏡順序。
✨標題與字幕由程式加上
標題、學校與教案名稱、字幕都由程式加上，文字取自原始公告。字幕依旁白的實際停頓分段，畫面之間以金色光帶轉場。
🎵旁白與背景音樂
旁白先試聽一兩句，確認聲音後才全部生成。背景音樂可在 Gemini 生成無人聲的曲子，長度不夠會自動延長，旁白出現時音量自動降低。
🏆片尾名單與三種版本
片尾捲動完整得獎名單；輸出 1080p 完整版、上傳社群用的版本，以及 30MB 以內、方便手機傳送的預覽版。
這個 Skill 的流程與程式，是製作這支 1 分 51 秒影片時整理出來的。全片共 10 個畫面，最後 16 秒是得獎名單。以下是開頭 20 秒（720p），完整影片可到 YouTube 觀看。
開場：嘉義市街景、噴水池圓環與阿里山雲海，帶出「嘉義市」標題
在 YouTube 看完整影片 ↗
總成績：鏡頭固定不動，獎項標籤跟著旁白依序出現
卓越獎：標題放在上方，避開人物臉部
佳作：四件教案的名稱，跟著旁白依序出現
字幕依旁白的實際停頓分段
需要的環境
| 項目 | 說明 |
|---|
| Claude Code | 支援 Skill 的 AI Agent |
| Claude in Chrome | 讓 AI 操作 Google Flow、Gemini 網頁，生成影片片段與背景音樂 |
| Google 帳號 | 使用 Google Flow 或 Gemini 生成影片，會用到你帳號的點數或額度 |
| Python 3.11+、Pillow | 加上標題與字幕、製作片尾名單、比對下載的影片 |
| ffmpeg | 影片放大、調整速度、串接、混音與壓縮 |
| 思源黑體／宋體 TC | 範本使用 Windows 的 NotoSansTC-VF.ttf、NotoSerifTC-VF.ttf；字型路徑可在 scripts/fxlib.py 開頭修改 |
| Codex CLI（選用） | 生成插圖；也可以改用其他生圖工具，只要插圖不含文字 |
| TTS 配音 | 任一 TTS 都可以（範例使用 Gemini TTS），每句旁白存成一個 mp3 檔 |
三步驟開始
- 下載並解壓縮：把 zip 裡的
veo_promo_animation 資料夾放到 ~/.claude/skills/（Windows 為 C:\Users\你的帳號\.claude\skills\）。
- 安裝套件：在終端機執行下方指令，並確認電腦可以執行
ffmpeg。
- 開新對話，說出觸發詞：例如「使用flow，把這篇得獎貼文做成影片」。AI 會先提出分鏡腳本；做到影片片段時，再請你選擇 Flow 或 Gemini。
觸發詞只有兩個：使用flow使用veo 沒有提到 Flow 或 Veo，就不會啟動這個 Skill。
Skill 免費下載；實際使用 Flow、Gemini、Codex 時，會用到你帳號的點數或額度，依各服務方案為準。
| 檔案 | 用途 |
|---|
SKILL.md | 觸發詞、八個步驟，以及每一步要請你確認的地方 |
scripts/storyboard_images.py | 用 Codex 依序生成或修改插圖，可指定模型 |
scripts/voice_timing.py | 找出每句旁白的停頓，讓字幕與標籤在念到時出現 |
scripts/identify_clips.py | 比對影片的第一個畫面，把下載的影片對應到分鏡順序 |
scripts/fxlib.py、render_overlay.py | 標題、緞帶、標題卡、標籤、獎項徽章、字幕、光點與轉場效果 |
scripts/render_clip.py | 每段影片放大到 1080p，配合旁白長度調整速度，再加上標題與字幕 |
scripts/credits.py、assemble.py | 片尾名單；全片串接、延長背景音樂與混音 |
scripts/veo_browser.js | 在 Flow、Gemini 網頁上傳插圖、送出與下載的輔助程式 |
references/ | 製作注意事項、Flow／Gemini 操作步驟、範例設定檔（project.json、scenes.py、生圖提示詞） |
⚠️ scenes_example.py 裡每個畫面的文字與位置，是嘉義市範例專用。換成其他主題時，AI 會依新的分鏡與實際影片畫面改寫；標題、標籤、字幕與轉場效果可以直接沿用。
下載 Skill 要付費嗎？
Skill 免費下載。實際使用 Flow、Gemini、Codex 時，會用到你帳號的點數或額度，依各服務方案為準。
為什麼插圖裡不放中文字？
AI 生圖常把中文寫錯，所以插圖不放文字；標題、校名、教案名稱與數字都由程式加上，內容依原始公告逐字輸入。名單有出入時，AI 會先問你。
要用 Flow 還是 Gemini？
建議先用 Google Flow：可以指定插圖當第一個畫面，一個專案能同時處理多段；選 Veo 3.1 Fast、每次 1 支，每段 8 秒。Gemini 每段約 10 秒，但每天可生成的次數較少。AI 會在生成影片前請你選擇；額度用完時，會先告訴你，再改用另一個。
Flow 的影片下載不下來？
Chrome 預設會擋下同一網站連續下載多個檔案。請在網址列允許 flow.google.com「自動下載多個檔案」，或手動逐一下載；Skill 會比對影片的第一個畫面，自動找出每段影片對應哪個分鏡。
AI 能保證影片沒有瑕疵嗎？
不能。AI 看不到完整影片，也聽不到聲音；它會抽查畫面、量測音量，並列出可能模糊或變形的地方。完成後仍需要你實際看過、聽過。
