Communitygithub.com

倒數影片

製作 Top-N 倒數或逐年「演化」影片(電影、票房、評分或任何排名清單),以動畫卡片顯示排名/年份,可選預告片片段、音樂、音效和 YouTube 章節,輸出為 MP4。

倒數影片 是什麼?

「倒數影片」技能專為將排名清單自動化生成精美影片而設計,非常適合製作電影排行榜、票房統計或任何排名主題的內容。它支援兩種主要模式:「倒數模式」(從第N名到第1名)和「時間線模式」(按年份從舊到新展示演變過程)。每張卡片可包含圖片、標題、年份、票房/預算等統計數據(含動畫進度條)、評分(IMDb、爛番茄、Metacritic)以及趣味小知識。進階功能包括可選的預告片片段(播放時音樂會自動降低音量)、自訂音效、背景音樂,以及為 YouTube 章節自動生成時間標記。此技能支援 Claude Code 等 AI 代理平台,使用者只需準備 `items.json` 資料檔案和圖片/影片素材,技能引擎就會自動處理其餘的建置、預覽、渲染和輸出流程,最終產出可直接上傳的 MP4 檔案。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/countdown-video-skill/tree/HEAD/skills/countdown-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

倒數影片 是做什麼的?

將排名清單轉化為電影/清單頻道風格的完成影片。兩種模式:

  • "mode": "countdown"(預設):No.N → No.1,每個條目前有一個橘色「No.X」撞擊卡。
  • "mode": "timeline":一個「演化」影片(例如 LAIKA 動畫演化史 2005–2022),從最舊到最新,每個條目前有一個大型年份卡。

在兩種模式下,條目都可以攜帶一個預告片片段,在卡片顯示後全螢幕播放,附有底部三分之一標題和預告片自己的音效(背景音樂在其下方降低音量)。在清單頻道上,卡片 + 每部電影約 25–30 秒的預告片是留住觀眾最久的格式。

影片有開場、每個條目的「No.X」排名撞擊卡,接著是動畫卡片(圖片、標題、年份、類型、帶有長條的票房統計數據、評分、趣味小知識)、進度追蹤器,以及帶有 YouTube 片尾元素插槽的結束畫面。一切皆由資料驅動:研究放入 items.json,引擎負責渲染。

以使用者偏好的語言交談;除非他們要求螢幕文字使用另一種語言,否則保留程式碼和 items.json 為英文。

檔案(相對於此技能資料夾)

檔案用途
templates/countdown_template.html引擎:開場、排名卡片、條目卡片、追蹤器、片尾。主題和時間可從 items.json 覆寫。
scripts/build_countdown.pyitems.json → _work/build.html、timeline.json、cues.json(音效)、chapters.txt;標記缺失/無法讀取的圖片。
scripts/render.py確定性幀範圍渲染器(Playwright → x264)。
scripts/compose_clips.py將每個條目的預告片片段放置在全幀中(信箱模式),並帶有底部三分之一「TRAILER · 標題(年份)」,並提取片段音訊。由 make_countdown.sh 自動執行。
scripts/countdown_audio.py原始歡快音樂循環(或 --music your_track.mp3)、根據提示的嗖/撞/砰/滴答音效、預告片音訊(背景音樂降低至 --clip-music 預設 0.12)、可選排名語音。
scripts/make_countdown.sh完整管線:建置 → 平行渲染 → 音訊 → MP4 + QA 表 + 章節。

設定:pip install playwright soundfile scipy pillow --break-system-packages 以及若缺少則 playwright install chromium;ffmpeg 需在 PATH 上。可選語音:Kokoro TTS(請參閱 PPT 動畫技能的 voiceover.py)。

工作流程

  1. 簡報。 主題、模式(倒數或時間線)、條目數量(N)、排名指標(例如全球票房)、要顯示的欄位、是否包含預告片片段(以及長度,預設 25 秒)、影片長度(≈ 5 秒開場 + N ×(~11 秒 + 片段)+ 12 秒片尾)、音樂(使用者的曲目或生成)。若使用者線上則詢問一次;否則選擇合理的預設值並告知。
  2. 研究排名。 使用網路搜尋並開啟來源頁面;切勿憑記憶填寫數字。偏好來源:Box Office Mojo / The Numbers(預算、全球票房)、IMDb、Rotten Tomatoes、Metacritic(評分)、Wikipedia(年份和類型)。在每個項目的 sources 中記錄 URL。如果兩個來源不一致,對排名指標一致使用一個來源並註明。如果找不到某個值,則省略該欄位(卡片會自動適應)— 切勿憑空捏造。
  3. 撰寫 items.json(結構如下),排名 1..N,其中 1 是最高條目。影片從 N 倒數到 1("order": "up" 則反轉)。
  4. 圖片和片段。 使用使用者提供的圖片和預告片檔案(posters/<slug>.jpg,2:3 直式;clips/<slug>.mp4)。請勿自行從網路下載海報、預告片、劇照或人物照片;請使用者將它們放入資料夾。若無圖片,卡片會顯示乾淨的標題佔位符;若缺少片段則會跳過,因此可先渲染草稿。對於每個片段,選擇 start(跳過工作室標誌和黑色幀)和 duration。預告片可能在 YouTube 上引發 Content ID 版權主張;這是頻道擁有者的決定,因此請提及一次。
  5. 建置 + 預覽。 python3 scripts/build_countdown.py items.json _work/ 然後截取幾個瞬間(開場約 3 秒、一張排名卡、一張完整的條目卡片結尾、片尾)並查看:無重疊、長標題能容納、數字在 360p 下可讀。
  6. 渲染。 bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]。
  7. 品質保證。 開啟 out_sheet.png;對照 items.json 抽查數字;確認時長且每個排名出現一次。
  8. 交付。 MP4、章節(out_chapters.txt,貼入 YouTube 影片說明)、來源清單,以及建議的標題/說明/標籤。提醒使用者在 YouTube Studio 中將片尾元素拖放到片尾插槽上。

items.json 結構

以下數值是展示形狀的佔位符,並非真實資料。

{
  "title": "票房最高的前 5 部停格動畫電影",
  "subtitle": "按全球票房排名",
  "channel": "頻道名稱",
  "currency": "$",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "你最喜歡哪一部?",
  "outro_subtitle": "在留言區告訴我們!",
  "timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
  "theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
  "items": [
    {
      "rank": 1, "title": "Chicken Run", "year": 2000, "subtitle": "家庭/喜劇",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "預算", "value": 45000000}, {"label": "票房", "value": 225100000}],
      "multiple": "預算的 5 倍",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "一句簡短且有來源的句子。",
      "teaser": "No.X 撞擊卡下方的可選文字",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "撞擊卡上取代 No.X / 年份的可選文字",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value 作為數字 → 動畫計數並顯示比較長條(長條在每張卡片內共用一個刻度);作為字串 → 直接顯示(例如 "N/A"、"8,848 m")。任何標籤都適用,因此同一引擎也適用於非電影的倒數(最高建築物、最富有的人、最快汽車)。
  • ratings 鍵為可選:imdb(0–10,星星)、rt / rt_audience / metacritic(0–100,環形)。缺少的鍵會消失;沒有評分的卡片會將其餘區塊置中對齊。
  • clip.start 接受秒數或 m:ss 格式;片段以 16:9 信箱模式顯示,並在卡片之後播放。章節和片尾時間會自動考量片段長度。
  • intro_image(例如使用者提供的工作室標誌)會取代開場上的 TOP N / EVOLUTION 標章。
  • 在時間線模式中,條目按 year 排序;卡片上的排名標章會隱藏,章節顯示為「標題(年份)」。
  • multiple 是金錢區塊下方的一個簡短重點藥丸;根據來源數字計算(四捨五入至一位小數)。
  • 評分僅以文字標籤顯示 — 無品牌標誌。
  • 螢幕上顯示的任何評分、數字或事實都必須來自 sources 中的來源。

風格說明

  • 預設主題符合經典清單頻道:交替的綠色/黃色蠟筆紋理卡片、紅色邊框、帶有光芒的橘色「No.X」撞擊卡、紫色金錢區塊、藍色評分區塊。在 theme 中覆寫任何顏色。
  • 360p 下的可讀性:保持標題簡短(副標題承載類型)、保持小知識 ≤ 2 行、不要添加超過 4 個統計資料。
  • 觀看留存:每個條目約 11 秒;將最強的條目放在最後;排名撞擊卡 + 嗖/撞音效會在每個條目重置注意力;將開場保持在 ≤ 5 秒。
  • YouTube 章節每個需要 ≥ 10 秒,因此開場會自動折疊到第一個排名的章節中。

相關技能