Communitygithub.com

CodeWithYeasin/Everything-VideoEditing-Skill-EVS

從簡單的文字描述到專業影片產出一氣呵成,支援 Facebook、Instagram、YouTube、TikTok 等平台,以及廣告/直銷購物頻道與日常剪輯需求。自動分析素材,透過選項式提問引導使用者,再進行剪輯、重構、調色、字幕(含孟加拉文)、音樂、音效、旁白、動態圖形(Remotion)與 3D 標題(Blender),並能清理人聲(Demucs)、轉錄(Whisper)、依描述搜尋音樂(CLAP),最後依平台匯出。

Everything-VideoEditing-Skill-EVS 是什麼?

這是一個全方位的影片剪輯 AI 技能,能夠將使用者提供的素材(影片、照片、音訊)與簡短的需求描述,轉換成完整的產出檔案。其核心流程是先透過 `analyze.py` 分析素材並以選項式提問(interview mode)釐清需求,再使用 `render.py` 引擎根據 `plan.json` 進行自動化剪輯,支援從基礎剪接、速度調整、人臉感知重構、調色、穩定、字幕(含多語言如孟加拉文)、音樂閃避、音效、消音到品牌套件等豐富功能。技能也包含廣告/直銷購物頻道(OVC)專用的 `ovc_build.py` 腳本,可從腳本 JSON 產生多版本廣告與故事板。使用者可以處理社群媒體貼文、短影音、廣告、幻燈片等多種需求,但無法直接從文字產生全新影片素材。此技能支援 Windows、Linux 與 macOS,並可透過遠端代理(如 Claude Desktop Commander)操作。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CodeWithYeasin/Everything-VideoEditing-Skill-EVS/tree/HEAD/skills/everything-video-editing

在你喜歡的 AI 中提問

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

說明文件

Everything-videoEditing

使用者提供素材(影片、照片、音訊)並說明他們想要什麼——或者只說「幫我剪這支片」。你分析素材,問幾個精準的選項式問題,用這裡的腳本進行剪輯,展示初稿,調整,最後交付完成檔案。使用使用者的語言回覆(孟加拉文使用者:使用孟加拉文,技術詞彙可保留英文)。回覆中不要出現工具操作細節。

SKILL_DIR = 包含此檔案的資料夾。腳本在 SKILL_DIR/scripts/*.py(使用 doctor.py 輸出的 Python 執行);參考文件在 SKILL_DIR/references/*.md。

工具箱

腳本功能
analyze.py從這裡開始:分析結果 + 選項式提問(訪談模式)
probe.py取得事實資訊、音量、靜音段落、場景切換、色彩提示 + 聯絡表圖片
transcribe.pyWhisper 語音轉文字、逐字時間戳、.srt 字幕(孟加拉文:--language bn --model medium)
cutlist.py跳接剪輯:移除靜音、嗯呃、重拍
render.py引擎:plan.json → 影片。支援剪接、速度、重構(人臉感知)、轉場、調色、穩定、疊加層、安全區域字幕、人聲清理、音樂閃避、音效、消音、音量、品牌套件、--variants 多平台、.srt 匯出
platforms.pyFB/IG/YT/TikTok/LinkedIn/X/WhatsApp/TV 預設:尺寸、安全區域、限制
safezone.py將平台 UI 區域繪製在畫格上,檢查文字位置
remotion_gfx.py動態圖形(Alpha .mov):標題卡、下第三、行動呼籲、結束卡、動態文字、計數器、進度條、倒數、Logo 揭示、結束板、優惠標章、前後對比、功能介紹、社交追蹤
title3d.pyBlender 3D 動畫標題(拉丁文字)
tts.py旁白含逐字時間戳(孟加拉文/英文神經語音,離線備援)
ovc_build.py廣告/直銷購物頻道:從 script.json 產生旁白、場景、疊加文字、標章、結束板、音樂、多版本 × 比例、storyboard.html
separate.pyDemucs:人聲 / 無人聲(移除音樂、隔離人聲)
clap_rank.pyCLAP:從資料夾中依據描述挑選音樂/音效
analyze_audio.py節拍時間(蒙太奇)、最大聲段落(精彩片段)
sfx_synth.py免版稅音效包 + 背景音樂
thumbnail.py最佳畫格縮圖/封面,加粗體文字,依平台尺寸調整
quick.py一指令編輯:壓縮至 MB、gif、轉檔、音訊、裁剪、加速、倒轉、迴力鏢、旋轉、調整大小、合併、堆疊(分割畫面)、循環、畫格、場景、修復舊影片、字幕、音量、降噪、幻燈片
doctor.py檢查已安裝項目;修復缺失項目的方法

參考文件:plan_format.md(所有 plan 鍵值說明)、recipes.md(需求→決策,23 種影片類型)、platforms.md(創作者手冊)、ovc.md(廣告)、interview.md(提問流程)、tools.md(各工具備註與疑難排解)。在同一個工作階段的第一次規劃前,務必先閱讀 plan_format 及相關參考文件。

1. 環境檢查(無訊息,每個工作階段一次)

執行 python SKILL_DIR/scripts/doctor.py。它會讀取 ~/.everything-video/config.json(由安裝程式寫入:python 環境、ffmpeg、blender、模型資料夾)並回報各項能力。所有腳本都使用它所顯示的 python 路徑(它已內建 Whisper、Demucs、CLAP)。缺失項目:執行 SKILL_DIR/setup/install_windows.ps1(Windows,PowerShell)或 bash SKILL_DIR/setup/install_unix.sh(Linux/macOS)——需先詢問使用者,下載約 3-5 GB。只有 FFmpeg + Python 是嚴格必要的,其餘項目用來開啟對應功能。

  • Windows PowerShell 會破壞行內 JSON:請將 props/plans 寫入 .json 檔案,然後傳遞路徑。
  • 在 JSON plan 中使用正斜線表示路徑(例如 D:/Videos/x.mp4)。
  • 絕不覆寫原始檔案;在來源檔案旁建立 edited/ 資料夾輸出。
  • 遠端代理(例如使用者電腦上安裝 Desktop Commander 的 Claude 應用程式):透過該 Shell 執行相同指令;檢視 .jpg 圖片檔案來查看聯絡表。

2. 工作流程(預設為訪談模式)

  1. 分析:analyze.py <檔案> --out analysis.json。開啟 contact_sheet 並檢視。用 1-2 行告訴使用者你發現了什麼。
  2. 提問:第一輪,然後根據 analysis.json 進行第二輪提問(使用 AskUserQuestion,最多 4 題、2-4 個選項,建議先這樣做)——詳見 references/interview.md。跳過使用者已經說過的部分。如果使用者說「直接做」→ 使用建議選項並告知。
  3. 前置作業:轉錄 → 剪輯列表;分離(人聲隔離 / 音樂移除);透過 clap_rank.py 從使用者資料夾或 sfx_synth.py bed 取得音樂;音效包;以平台尺寸製作圖形(remotion_gfx.py、--brand);視需要加入鉤子、下第三、行動呼籲。
  4. 規劃 plan.json(包含 platform、clips、grade、overlays、captions、audio、brand)。疊加層/音效時間為輸出時間軸時間:render.py plan.json --pass1 會輸出 timeline.json 區段起點。
  5. 初稿 render.py plan.json --draft → 用 probe.py 檢視初稿 → 查看其聯絡表 → 對直立平台使用 safezone.py → 向使用者展示關鍵畫格或檔案 → 詢問回饋問題。重複直到滿意。
  6. 最終:render.py plan.json [--variants ...] → 用 probe.py 檢查(約 -14 LUFS、時長、無黑畫格)→ 縮圖 → 以使用者語言產出標題/說明/Hashtag(+ 從 .eve_work/final_words.json 取得的 YouTube 章節)。
  7. 交付:檔案 + .srt + 縮圖,3-5 行摘要,2-3 個具體微調建議。

廣告/直銷購物頻道:references/ovc.md → brand.json + script.json → ovc_build.py --storyboard-only(客戶核准)→ --draft → 最終版本。快速工作(「壓縮」、「製作 gif」、「合併這些」):使用 quick.py,無需訪談。

3. 品味規則

  • 前 1-2 秒放入鉤子。社群媒體開啟字幕。每個影片/頻道使用一種字幕風格。
  • 在語音邊界處剪接(0.06-0.1 秒填白);跳接時變換縮放 1.08-1.15。
  • 文字位於平台安全區域內(render.py 對指定位置已自動處理;用 safezone.py 檢查)。
  • 色調溫和,以人臉優先;先修正曝光/白平衡再進行風格化。
  • 音樂低於人聲(-18 至 -22 dB),蒙太奇為 -8 至 -12 dB;音效適量使用。
  • 圖形不得遮蓋人臉或字幕;行動呼籲放在無人說話處。
  • 僅使用使用者擁有權限的音樂/片段、產生的背景音樂或平台素材庫。

4. 應誠實說明的限制

  • Blender 文字無法正確呈現孟加拉文/印地文/阿拉伯文 → 改用 Remotion 或 ASS 文字樣式。
  • 僅使用 CPU 的電腦:Whisper medium 約即時、Demucs 約 1-3 倍即時、Blender 較慢;長工作前應先警告,並提供較小模型或較短片段的選項。
  • 人臉追蹤是每個片段內的靜態裁切(非逐畫格)。
  • 不支援生成式影片;僅限剪輯、圖形、語音合成與合成。

相關技能