Communitygithub.com

hongxiang01/video-forge

成片工坊總入口:畫風視頻、音樂 MV、科普動畫、三維微縮場景都從這裡進。先追問到每個細節(場景、人物、情緒、結構、聲音、禁忌),不知道選什麼就給樣片牆和內容點子;畫風寫成數值卡讓用戶確認,分鏡聯繫表確認後才生產;做完交給獨立子 agent 評審打分迭代,最後歸檔到 ~/video-forge。用戶說「做個視頻」「做個動畫」「做 MV」「畫風視頻」「做個微縮場景」「用 XX 方案做」「不知道做什麼畫風」時用。

video-forge 是什麼?

video-forge 是一個 AI 驅動的影片生成技能(Skill),專為 Claude Code 等開發者工具設計。它不直接生產影片,而是扮演「導演」和「關卡」的角色,透過嚴謹的流程確保高品質輸出。使用者只需提供模糊需求(例如「做個動畫」),此技能便會透過結構化追問(場景、人物、情緒、鏡頭、聲音、禁忌等)將模糊想法轉化為具體的視覺藍圖,並在每一步(畫風卡、設定卡、分鏡表)由使用者確認後,才調用底層產線(如 lemo-opuscar 風格短片、MV-director、Remotion 科普動畫、three.js 微縮場景)進行實際渲染。生產完成後,由獨立的子 agent 評審,根據使用者同意的「評審標準卡」逐項評分,不通過的項目會反覆迭代(最多三輪)。最終作品、所有過程文件與使用者回饋數據(如影片留存率)一併歸檔至 `~/video-forge` 目錄,形成可複用的知識庫與作品集。

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

在你喜歡的 AI 中提問

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

說明文件

成片工坊(video-forge)

好作品不是一句話生成的。這個 skill 管住三件事:

  1. 問清楚:需求模糊就一直問,直到場景、人物、情緒、每個細節都落到具體畫面上。
  2. 先確認,再生產:畫風、設定、分鏡都要用戶點頭,才進入耗時的製作。
  3. 別人來審:成片交給獨立評審,按用戶確認過的「評審標準卡」逐條判定,不拿自檢代替審片。

生產本身交給已有的產線(lemo-opuscar、mv-director、Remotion、three.js 微縮),這個 skill 只做導演和關卡。

鐵規矩

  1. 不許一句話開工。追問清單(references/interview-checklist.md)的必填項沒問齊,不進入生產。用戶說「你定」的項,給出具體預設值寫進需求卡,讓用戶看到。
  2. 模糊詞換成畫面:「溫馨」「高級」「有感覺」不算答案;給 2–4 個具體畫面選項讓用戶挑。
  3. 每輪追問後貼需求卡(references/card-templates.md),用戶能一眼看到已定和未定。
  4. 關卡順序不能跳:需求卡 + 評審標準卡 → 畫風(樣片)→ 風格卡/風格幀 → 設定卡 → 分鏡聯繫表 → 草稿 → 評審循環 → 歸檔。產線可以聲明跳過某關(如微縮沒有分鏡),但要寫明。
  5. 分鏡預設要確認(lemo 預設不確認,這裡改成預設確認)。
  6. 評審是獨立子 agent,只給作品和用戶確認的評審標準卡,不給我的結論。評審要看全片(每 2 秒抽 1 幀),只能測量聲音、不評價好不好聽。用戶的話優先於評審。
  7. 人物不演戲:程式碼畫的表情、手部動作必僵。除非產線有角色綁定能力,人物只做小、遠、靜止或簡單循環。
  8. 用戶原話進卡片:用戶說過的具体要求(比如「燈光不要拍扁」)原文寫進需求卡的禁區或硬要求。
  9. 大任務按職責分給多個 agent(references/division-of-labor.md):先定骨架檔案,各職責只引用編號,算術用腳本校驗;不靠降低思考強度來避免超時。
  10. 作品歸檔到 ~/video-forge,不放臨時目錄;臨時目錄重啟會丟。
  11. 網路:這台機器的代理極慢,大下載用 curl --noproxy '*'、env -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY 繞開;shell 裡 grep 壞了時用 /usr/bin/grep。

步驟

0. 分流

先看 ~/video-forge/recipes/:用戶點名方案(「用三渲二微縮方案做個車站」),讀方案檔案,追問只問方案沒定的項。

否則按需求選產線:

需求產線檔案
某個畫風的短片(30–90 秒),主題自定畫風視頻references/pipeline-style-film.md
給一首歌做 MVMVreferences/pipeline-mv.md
講清一件事、歷史、數據科普references/pipeline-explainer.md
可以拖拽旋轉的三維小場景微縮references/pipeline-diorama.md

用戶什麼都沒想好:走 references/style-picker.md 的新手引導(先看樣片牆,再給內容點子)。

1. 追問 → 需求卡

先定視頻類型和時長檔,載入 references/genres/ 裡對應的類型卡(選卡表見 genres/README.md),後面的追問、結構、字數預算、評審標準卡都以這張卡為起點。

按 references/interview-checklist.md 一輪一輪問。用 AskUserQuestion,每輪 ≤ 4 個問題,選項寫成具體畫面。每輪後貼需求卡。必填項齊了,讓用戶確認需求卡。

2. 畫風

用戶沒選:按 references/style-picker.md 推薦 2–3 個並附樣片連結,同時給出全部 66 種列表(純文字提問,不用 AskUserQuestion,選項太少會把列表藏起來)。 選定後讀該畫風的 STYLE.md,整理成風格卡(數值:色值、線寬、光比、字體、鏡頭語法、聲音),貼給用戶確認。

3. 風格幀

用真實的繪製程式碼出 1–3 張風格幀(一個鏡頭/一個角落,光和色定好)。用戶確認後再鋪開。

4. 設定卡

有人物、地點、物件時,每個一張設定卡:長相、比例、配色、服裝、關鍵道具、不能出現的東西。出設定圖,用戶確認。

5. 分鏡聯繫表

6–9 格縮略圖拼一張(每格:時間、畫面、鏡頭、聲音、字幕),用戶確認後才做動畫。

6. 草稿 → 評審循環

按產線做出草稿,按 references/review.md 開兩個評審,按評審標準卡逐條判定(通過 / 部分 / 不通過 + 證據幀)。只改不通過的項,每輪都給用戶看。 停止:必須項全部通過且用戶滿意,或滿 3 輪,或用戶喊停。

7. 歸檔

在 ~/video-forge/works/<slug>/ 放:原始碼或專案連結、成片/截圖、需求卡、風格卡、分鏡、scores.md;在 ~/video-forge/retros/ 寫回顧;路子可複用就從 recipes/_template.md 寫一份新方案,並在 ~/video-forge/README.md 的「🎞 作品」表加一行;用到新的外部函式庫就登記進 deps.json 並重建 index/。

發布後約一週,請用戶從平台後台(如抖音創作者服務中心)看一眼完播率、平均觀看時長、在哪幾秒流失最多、哪段被回看,回填到這個作品的 scores.md「發布數據」一節,並在回顧裡寫一句:哪個留存設計起了作用、哪裡流失了。下次寫稿和分鏡參考這些真實數據,而不是只憑評審意見。

參考檔案

階段檔案什麼時候看
1 追問references/interview-checklist.md每次開工;每輪追問前對照還缺什麼
1–5 卡片references/card-templates.md貼需求卡、風格卡、設定卡、分鏡聯繫表時
2 畫風references/style-picker.md用戶沒選畫風、不知道做什麼內容
3–6 生產references/pipeline-style-film.md用 lemo-opuscar 畫風做短片
references/pipeline-mv.md做音樂 MV
references/pipeline-explainer.md用 Remotion 做資訊、科普視頻
references/pipeline-diorama.md做 three.js 三維微縮場景
3–6 分工references/division-of-labor.md用多個 agent 寫 Treatment 或做生產時:職責劃分、骨架檔案、校驗腳本
類型卡(按類型 / 時長檔)references/genres/README.md追問時定下類型和時長檔後載入對應的卡:時長預算、結構、視覺聲音規範、校驗邏輯、提示詞模板都從卡裡取
配樂references/music.md選配樂路子(程式碼作曲卡拍 / 免版稅曲庫 / 開源模型)、tools/music/code_score.py 用法
選畫風 / 選動效~/video-forge/index/catalog.md(index.json 機讀)所有畫風庫、動效卡、解說語法、自己的畫風合在一張表;缺庫執行 bash ~/video-forge/bootstrap.sh <id>
1 / 6 評審references/review-standards.md追問時按視頻類型給預設檢查項,和用戶一起定評審標準卡
6 評審references/review.md開評審、逐條判定、決定停不停
排錯references/troubleshooting.md裝依賴、渲染、截圖、網路出問題
歸檔~/video-forge/README.md、~/video-forge/recipes/_template.md做完以後

相關技能