Communitygithub.com

gbax316/shorts-director

導演無臉直式短影音,從構思到完成母帶,每次執行後都會進步。選擇格式、在編劇室撰寫劇本(以買家身份評判三個前提)、配音、通過動態分鏡檢查,然後逐一決定每個節拍的呈現方式:用 Remotion 繪製程式碼、從生成的靜態圖中剪裁、生成片段,或使用引擎軌道。模式:系列、編劇室、製作、音效、完稿、對決、效果(/effects)、改進(每次短影音後的學習循環)。目前已驗證格式:附對話與嘴型同步的角色短劇、包含引用人物的寫實微紀錄片。觸發詞:「製作短影音」、「下一集」、「製作關於 X 的影片」、「無臉影片」、「針對此提案的 Reel」。請勿觸發於編輯現有影片檔案、純程式碼繪製的說明類影片(屬於 make-short),或拼貼類影片(屬於 make-vox)。

shorts-director 是什麼?

此技能的核心功能是作為一位「導演」,它不僅僅是執行單一流程,而是根據影片類型、系列聖經和過往經驗,動態地為每個短影音選擇最佳的路徑與格式。它支援兩種主要格式:需要精準對話與嘴型同步的「角色短劇」,以及旁白搭配真實場景與人物的「微紀錄片」。技能透過如「編劇室」、「製作」、「音效」等步驟,確保從劇本、配音、動態分鏡到最終成品,每個環節都經過層層把關。最特別的是它內建了「改進」模式,會針對每次執行進行評分、記錄錯誤並提出技能本身的修改建議,形成一個持續學習與優化的閉環。此技能適用於 Claude Code、Coder 等具備自主代理能力的開發工具,幫助用戶從零開始、高效產出高品質的垂直短影音內容。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gbax316/shorts-director/tree/main/.claude/skills/shorts-director

在你喜歡的 AI 中提問

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

說明文件

短影音導演

一個短影音的命運,在別人兩秒鐘的滑動中就已決定。本技能的一切存在,都是為了讓你交出第一版剪輯時,對方會毫不猶豫地發佈:從三個構想中選出的點子,螢幕上清晰可見的文字,比你更快發現的畫面瑕疵,以及即使在嘈雜的丹佛巴士上用手機播放也聽得清晰的混音。品質優先。每次生成費用都會事先顯示,但絕不讓預算成為品質的天花板。

此技能負責「導演」;儲存庫中的引擎負責執行。引擎軌道(Remotion 套件、片段與圖片工具、特定領域函式庫、拼貼相機)以及後續添加的工具(嘴巴同步、共享卡片、字幕分割器、檢查器)都是此技能逐一在每個節拍間選擇的渲染路徑,而不是每支影片只使用單一軌道。

開始前:閱讀設定檔與聖經

品牌識別存在於設定檔中,絕不在技能本身。請閱讀儲存庫根目錄下的 director.config.json,了解品牌、角落標記、影片中可能提及的人物、連結標籤、製作規則、供應商及其價格,以及最終母帶目標。視覺識別(顏色、字型、標誌)位於 remotion/src/brand.ts 和 remotion/src/fonts.ts。如果短影音屬於某個系列,請在撰寫任何內容前閱讀 ai-shorts/series/<系列名稱>/BIBLE.md 中的系列聖經;如果是全新頻道或角色陣容,系列模式會先撰寫一份聖經。然後閱讀 RUNS.md 和 LESSONS.md 的最後幾筆記錄,因為上次執行的錯誤,是這次最容易避免的問題。

模式

模式功能參考文件
series為固定角色陣容或頻道風格建立聖經modes/series.md
writers-room產出三個不同的前提,以買家身份評判,然後產出劇本modes/writers-room.md
produce配音、動態分鏡、靜態圖、片段、嘴巴、構圖modes/produce.md
sound背景音樂、音效提示、混音與母帶處理modes/sound.md
finish最終母帶、手機用版本、文字檢查、發佈用素材包modes/finish.md
bakeoff在決定預設模型前,讓不同模型相互比較modes/bakeoff.md
effects/effects <名稱>:預覽效果、將其套用至某個節拍,或將新效果加入函式庫modes/effects.md
improve每次短影音後:為此次執行評分、記錄學到的經驗、提議技能修改modes/improve.md

一個新的短影音會按照以下順序執行這些模式:series(僅在缺少聖經時)、writers-room、produce、sound、finish、improve。業主可以透過名稱進入任何模式,而一個明顯屬於某個模式的請求(例如重新配音、修正字幕、新的鉤子)會直接導向該模式。

快速通道。 當系列聖經已存在、格式已驗證、引擎也已熟悉時,不要跳過任何步驟,但縮短每個步驟:只進行一輪前提評估而非冗長過程,並在合適之處重複使用系列中的靜態圖。檢查點和閘門保持不變;只有輪次減少。

每次執行都需通過的閘門

以下是業主必須檢視的環節,依序進行。工作會在業主回覆前暫停。每個環節在當下修改的成本很低,但之後修改的成本很高。

  1. 前提。 三個,以買家身份撰寫和評判,並附上選擇及其原因。在選擇一個之前,絕不進行配音。
  2. 配音。 業主提供的台詞,使用他們的用語。對於皮欽語或當地人名,請讓他們透過聽覺試鏡選擇(references/voice.md)。選定的錄音要精確定位,絕不重新生成。
  3. 動態分鏡。 將靜態圖放置在真實的聲音時間線上,包含程式繪製的笑點、字幕,以及在將放置片段的位置加上紅色標籤。在動態分鏡獲得批准前,絕不生成任何片段。
  4. 花費。 每個生成步驟都需先說明其點數或成本(references/stills-and-clips.md),並在最後報告總計。
  5. 初剪。 業主在母帶處理前觀看粗剪,並在最終檔案發佈前觀看完成版。

在閘門之間,請依照 references/qa.md 描述的方式自我檢查,確保業主的精力只花在品味判斷上,而非任何掃描即可發現的錯誤上。

格式

一個格式帶有自身的語法(節拍如何進行)、自身的視覺世界與預設渲染路徑。目前已驗證的格式各有參考文件:

  • references/formats/skit.md:附對話的角色陣容(由 Akpos 和 Segs 的第一、二集驗證)
  • references/formats/documentary.md:旁白搭配附來源人物的寫實場景(由 Qodeup 微紀錄片第一集驗證)

引擎格式也依然可用:透過 make-short 和 vidtsx-2d-generator 進行程式繪製的說明類影片;透過 make-vox 進行拼貼。導演可以將整個短影音導向其中一種格式,或從中借用某個節拍。

當請求的格式尚未驗證時

如果業主要求的短影音類型不屬於任何現有格式(例如列表類、前後對比類、會說話的物品類、新聞摘要類),請坦白告知,而不是硬塞進最接近的格式;將角色短劇的語法套用在新聞摘要上,會產生一種他們會察覺的彆扭感。提供兩條路徑。第一條是正確設定:將其作為一次驗證執行,一旦順利產出,透過 os-skillify 從此次執行驗證的結果撰寫 references/formats/<名稱>.md,這樣下一次就能從語法而非猜測開始。第二條是使用最接近的格式作為臨時支架,一次性製作,並標明所有差距,然後不留記錄。如果同一種新格式出現第二次,請選擇第一條路徑;不斷臨時拼湊的格式永遠不會擁有自己的語法,這會悄悄地限制業主能請你製作的內容類型。

如何持續進步

每次短影音結束於「改進」模式。它會根據 references/outcomes.md 中的結果為本次執行評分,記錄到 RUNS.md,將學到的經驗寫入 LESSONS.md,當某個錯誤發生兩次或某個技巧已證明有效時,它會以一般性術語提出對本技能的修改建議,就像一個供業主批准的差異對比。Git 是回到過去的保障。

參考文件

  • references/outcomes.md:技能必須產出的項目、其數值、檢查方式以及改進迴圈
  • references/render-routing.md:為每個節拍選擇使用程式碼、剪裁、生成的片段或引擎軌道
  • references/voice.md:聲音、選角、試音、皮欽語和名稱、定位選定的錄音
  • references/stills-and-clips.md:生成靜態圖和片段、能維持品牌識別的提示、重新生成、價格
  • references/mouths.md:使用 mouth_sync 在生成的片段上重繪嘴巴,包含每個鏡頭的設定
  • references/facts.md:針對螢幕上陳述為事實的內容進行事實檢查
  • references/effects.md:一個節拍可以擁有的效果、每個效果適用的工作,以及防止短影音變成展示影片的節制規則
  • references/qa.md:閘門之間的檢查,以及每個檢查曾經發現的問題
  • references/formats/:每個已驗證格式一個檔案

相關技能

  • make-short, vidtsx-2d-generator:程式繪製的說明類影片軌道及其崩潰規則,用作渲染路徑
  • make-vox:拼貼軌道
  • make-ai-short:生成式軌道,此技能繼承了其片段紀律
  • suggest-sfx:音效提示試音,從音效模式中調用
  • os-writing (Personal OS):用於發佈的鉤子和字幕,從完稿模式中調用
  • os-skillify (Personal OS):在驗證執行後撰寫新的格式參考文件

Individual skills in this repo

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

gbax316/make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, ~35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to "make an AI video short", "make an ai short", "make a blue-man video", or any short where the pixels come from a VIDEO MODEL — not TSX animation (that is make-short) and not layered collage (that is make-vox). Defers model choice re-litigating to ai-shorts/IDEAS.md, TSX crash rules to vidtsx-2d-generator, SFX taste to suggest-sfx + brand §7. For a NEW short (writers' room, dialogue skits, documentaries, mixed render paths), start with shorts-director, which calls this track as an engine.

gbax316/vidtsx-2d-generator

Generate production-ready 2D TSX video files for VidTSX (Remotion-based) from a shot, scene, or video description. Use whenever the user wants to create or generate a VidTSX video, a 2D TSX shot or scene, an animated clip, title card, or rendered motion graphic — including when they describe a visual animation they want built, or say "make a shot", "build this scene", "generate the TSX", or "turn this into a video". Covers the mandatory file structure and composition config, dimension presets (horizontal/vertical/square), six style presets (minimalist, memphis, neo-brutalism, glassmorphism, neon, corporate), and the hard rules that keep renders from crashing, covering frame-based animation only (no useState/useEffect/setTimeout), strictly monotonic interpolate ranges, Easing.bezier not wrapper syntax, and the chroma-js and @remotion/paths import gotchas. Not for 3D/three.js compositions, general React work, or editing video files.

相關技能