Communitygithub.com

短影片製作管線

製作、渲染、檢查、混音及打包 1080×1920 垂直短片(YouTube Shorts、Reels、TikTok),以 clip 為基礎的管線(edl.json、build.py、check.py、sound/mix.py),適用於產出、修正或審查此類影片,或向子代理人編輯下達簡報。

短影片製作管線 是什麼?

此技能定義了一套完整的短影片(YouTube Shorts、Reels、TikTok)製作管線,從題材與旁白腳本匯入開始,經過語音生成、素材收集、剪輯清單(edl.json)編輯、渲染、封面生成、自動檢查(check.py)、音訊混音(-14 LUFS)到最終打包(shorts-packaging)。它強調「與主題無關」的通用框架,所有頻道(主題、語言、受眾、風格、片尾、排程等)的具體規則都寫在專案的 `CHANNEL.md` 中,管線預設值會優先被覆蓋。 支援的平台包含 Claude Code、Cursor、Codex 等 AI 編碼代理,可執行各個階段的命令並驗證結果。 此技能的關鍵在於嚴格依賴 `SHORTS_HOME` 環境變數與專案資料夾結構,並透過 `doctor.sh` 確認所有系統依賴、Python 套件、模型及磁碟空間。 其 AI 實作者必須先讀取並遵循 `CHANNEL.md`,再依據 9 步驟工作流程操作,每個步驟都有對應的驗證命令。 此外,技能也提供充足的除錯指南(如「硬學的教訓」),包含編輯清單與渲染時效性、凍結靜止畫面的處理、縮放限制、創作者疊加層的裁切技巧等,確保產出品質。 如需委託子代理人編輯,主 session 必須提供 `BRIEF.md`、腳本、語音檔案及素材列表,並親自審查每一幀,最後處理音訊混音。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ilyamelnichenkov/youtube-shorts/tree/HEAD/skills/shorts-pipeline

在你喜歡的 AI 中提問

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

說明文件

短影片管線(與主題無關)

一份編輯清單(<short>/edl.json)加上旁白即可產出完成的影片:移動剪輯的「主題照片視窗」、文字字幕、鉤子版、英雄圓圈、封面、音效提示清單,最後以 -14 LUFS 進行音訊混音。 所有與頻道相關的內容(主題、語言、受眾、內容規則、視覺風格、旁白、片尾、排程)都寫在專案的 CHANNEL.md 中。請先閱讀它,並遵循其指示(而非下方的預設值)。 如果 CHANNEL.md 遺失或部分內容為空,請在產出任何作品前向擁有者詢問(或複製 engine/templates/CHANNEL.md 並與對方一起填寫)。 相關技能:shorts-script-voice(主題、腳本、旁白)和 shorts-packaging(完成的檔案、上傳文字)。

在開始任何步驟之前

  1. 套件腳本(setup.sh、shorts-init.sh、doctor.sh、install-codex.sh)位於套件的 scripts/ 資料夾中:即插件資料夾,或 $SHORTS_HOME/kit/scripts/(setup.sh 和 install-codex.sh 會在那裡保留一份副本)。
  2. 從一個專案資料夾開始工作,該資料夾需包含 _pipeline/、_tools/、_fonts/、CHANNEL.md(可使用 scripts/shorts-init.sh <dir> 建立)。以下所有命令都從該資料夾的根目錄執行。
  3. 在每台機器上執行一次 scripts/doctor.sh <project-dir>。它會檢查所有依賴項(系統程式、Python 套件、模型、可用磁碟空間),並必須以「All good.」結尾。如果沒有:對於 ffmpeg/Python/curl,請執行 scripts/install-system-deps.sh;對於其餘部分,請執行 scripts/setup.sh。完整列表請參閱套件的 DEPENDENCIES.md。
  4. SHORTS_HOME(預設 ~/.shorts-studio)存放 Python 虛擬環境和語音模型。如果將其放在其他位置,請匯出此環境變數。
  5. 在撰寫編輯清單之前,請閱讀 _pipeline/README.md(引擎參考)和 references/edl-notes.md。

工作流程(每個步驟都有其專屬檢查)

#步驟命令 / 輸出驗證
1主題 + 腳本技能 shorts-script-voice一個主張、來源已標註、所有者 OK(當設定檔要求時)
2旁白$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json,然後 _tools/words.py <short>/vo讀取 vo/words.json:每個單字正確
3素材_tools/grab.py <topic> '<url>' <start> <end> --tag NAME(記錄於 _footage/SOURCES.md),或自行錄製每個剪輯的連絡表;遵守 CHANNEL.md 中的政策
4編輯清單複製 references/edl-template.json,修改內容build.py <edl> --words 顯示字幕標記
5渲染python3 _pipeline/build.py <short>/edl.json --theme <theme>(3-10 分鐘;4K60 很慢)無錯誤;檔案比 edl 新
6封面... build.py <edl> --cover「無安全區違規」;在 180 像素寬時可讀
7檢查python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.json顯示 ALL CHECKS PASS;你已經看過每張連絡表
8音訊$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict-14.0 +/-0.5 LUFS,真實峰值 <= -1.0 dBTP,單字錯誤接近 0
9打包技能 shorts-packaging檔案 + 封面 + 上傳區塊在 ready/ 中

來源剪輯的連絡表:ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (寫入 PNG:某些來源的 JPEG 輸出會因「non full-range YUV」而失敗)。鏡頭邊界: ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*"。 主題:case-file(檔案紙張)、panel-heist(漫畫頁面)、vice-dusk(霓虹暮色)、classic;設定檔會選擇一個。

好的短影片是什麼樣子(預設值;設定檔會覆蓋)

  • 18-45 秒,一個從鉤子到收束的主張,每 1.5-3 秒一個剪輯,每個鏡頭都有動態,鉤子版從第 0 幀開始顯示 (hook.y 1170 使其避開展品標籤),一個英雄時刻,有一個紅圈圈出幀中實際顯示的內容。
  • 畫面跟隨文字。字幕是 2-3 個單字的短語(break_before);名字保持在同一組。
  • 最後一個鏡頭剪輯回第一個幀(影片循環播放)。
  • 所有可讀文字都保持在手機安全區內:y 300-1580,x 130-950(y 1000-1600 時 x <= 860)。check.py 會強制執行此規則。
  • 高照片視窗 "aspect": "3:4"(900x1200),用於 1080p 及以上的剪輯;720p 或有信箱黑的來源無法填滿它。

硬學的教訓(詳細內容在 references/lessons.md 中)

  • 編輯清單比渲染新?渲染就過時了。 在判斷 check.py 的結果之前,先重新建置。
  • 凍結靜止畫面(連續幀之間差異小於 0.3 秒)會導致 check.py 失敗。靜態螢幕、單一顏色和靜止的主體需要恆速動態:"move_ease": "linear",縮放範圍 0.15-0.4 以及平移 150+ 來源像素。 僅僅 float 是不夠的(正弦曲線在轉折點會減速到零)。
  • 縮放限制: 4K 來源 <= 1.00、1080p <= 1.25、720p <= 1.0(check.py 會顯示每個剪輯的限制)。
  • 創作者疊加層(浮水印、臉部攝影機、第三條、字幕、風格化橫幅)絕不能接觸畫面:使用頂層 sources 的畫面覆蓋、移動裁切或選擇其他幀。檢查每個裁切幀。
  • 誠實: 標籤、圓圈和字幕只能說明幀中顯示的內容,在旁白中將事實歸因於其來源。
  • 封面: 一個滿版裁切的來源幀;版位位於 tab_y(330)並隱藏畫面的頂部。對於主體靠近頂部的情況,請將 tab_y 設定為約 1090,將 stamp_y 設定為約 410。
  • 一次只進行一個渲染(4K60 渲染會使用所有核心);切勿啟動同一個資料夾的第二個渲染。

將編輯工作委託給子代理人

請提供代理人 BRIEF.md(由 shorts-init 從 references/editor-brief.md 建立),以及腳本、語音檔案和素材列表。主 session 負責寫入腳本和語音,親自審查每個幀,並進行音訊混音:代理人的報告只是一個聲明,不是證明。在接收前,請檢查檔案時間(無聲 mp4 比 edl 新,檢查日誌比 mp4 新)。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能