Communitygithub.com

長片導演

將已核准的故事轉換為逐個鏡頭的影片腳本,扮演導演角色。詢問影片使用旁白還是角色對話(或兩者兼具),建議專業的拍攝選擇(攝影機類型、鏡頭、運鏡、燈光、色彩、節奏),將其儲存為獨立的影片風格檔案,然後撰寫符合專案設定的腳本。輸出 film-style.md 和 video-script.md。請在完成 long-video-story 和 long-video-assets 後,或當使用者要求影片腳本、分鏡表、攝影風格或燈光計畫時使用。

長片導演 是什麼?

長片導演(Long video director)是長片工作流程中的第四階段,旨在將已核准的故事轉化為專業、詳盡的影片腳本,並輸出 `film-style.md` 和 `video-script.md` 兩個檔案。它會先確認專案目錄中是否已存在 `story.md` 且狀態為「approved」,並檢查 `visual-bible.md` 以確保美術風格已被鎖定;若檔案遺失,會建議使用者先執行 `long-video-assets`。接著,技能會引導使用者決定影片的「說話模式」(旁白、角色對話或混合模式),並根據故事與專案設定(如視覺風格、預算、TTS 提供者等)給出專業建議。之後,它會參考 `cinematography-options.md`,逐步帶領使用者設定攝影與燈光風格,包括攝影機與格式、鏡頭與構圖、運鏡、燈光、調色與節奏,並在每一步提供適合該故事的建議與理由,直到使用者確認並儲存為 `film-style.md`。最後,它會根據 `script-format.md` 的規範撰寫腳本,確保每個鏡頭符合影片風格、長度限制(單個片段不超過 10 秒,理想為 5-8 秒),並使用視覺聖經中的實體 ID,同時在腳本中標示任何需要的新資產。整個過程會嚴格遵循故事內容,不添加未核准的事實或事件,並在完成時更新專案狀態,讓使用者可以繼續後續的關鍵影格或資產生成階段。

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

在你喜歡的 AI 中提問

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

說明文件

長片導演 是做什麼的?

長片工作流程的第四階段。你扮演導演角色。輸出:專案資料夾中的 film-style.md 和 video-script.md。

開始之前

  1. 在 ~/.long-video/projects/<slug>/ 中找到專案。需要一個狀態為 approved 的 story.md 檔案。如果尚未核准,請停止並執行 long-video-story。
  2. 需要 visual-bible.md(實體 ID 與鎖定的美術風格)。如果遺失,請告知使用者需要先提供美術風格,並提議執行 long-video-assets。僅在使用者選擇跳過時才繼續。在這種情況下,請詢問簡短的美術風格描述,並在影片風格中將其標記為「未鎖定」。
  3. 載入專案設定。從中取得:語言、目標長度、長寬比、觀眾、基調、視覺風格、旁白來源與提供者、字幕、音樂、預算。不要重新詢問設定中已回答的項目。
  4. 如果 film-style.md 或 video-script.md 已經存在,請詢問:繼續,或重新開始其中一個。

第1步:旁白或角色對話

詢問:「影片應該如何發聲?」

  • 旁白。 一個聲音透過畫面講述故事。
  • 角色對話。 角色在螢幕上交談。沒有旁白,或只有少數標題列。
  • 混合模式。 旁白主導故事,而角色在關鍵場景中對話。

在使用者回答之前,針對每個選項對製作過程的意義給出一行說明。使用設定中的 visuals.approach 和 audio.voiceover:

  • 角色對話需要每個獨特角色都有不同的聲音。靜態圖像或簡單動畫無法呈現真實的嘴型同步,因此請說明以下哪種情況適用:需要嘴型同步工具、畫外音傳遞(說話者不在說話時顯示),或一種隱藏嘴巴的風格。
  • 旁白最便宜,且適用於所有視覺風格。

根據故事和設定推薦一個選項。如果該選擇與設定衝突(例如,voiceover.source 為 none),請指出並詢問是否要更新設定。

如果角色會說話,請根據視覺聖經要求提供每個角色的聲音描述(年齡、語氣、口音)。如果設定中有提供 TTS 提供者,請使用它。

第2步:導演決定影片風格

讀取 references/cinematography-options.md。引導使用者逐一瀏覽下列各組別。針對每個組別,建議 3 到 4 個適合此故事的選項。為每個選項提供一行理由。標記你推薦的選項。使用者可以選擇、組合或描述自己的選項。

  1. 攝影機與格式風格
  2. 鏡頭與構圖
  3. 運鏡
  4. 燈光
  5. 色彩與調色
  6. 節奏與轉場。節奏需在片段長度限制內運作:除非設定另有規定,平均鏡頭長度必須維持在 5 到 8 秒之間。透過鏡頭尺寸、運鏡和剪輯節奏來提供變化,而非透過長時間的停頓。

規則:

  • 一切都必須符合已鎖定的美術風格和設定的視覺風格。不要為 2D 插畫風格建議實體電影攝影機。對於插畫或靜態圖像風格,請提供匹配的虛擬運鏡選項(推近、視差、平移畫面),並說明製作團隊實際能達到的效果。
  • 不要與 visual-bible.md 中的風格區塊相矛盾。影片風格是在此基礎上增添。
  • 將每個建議與故事連結:情緒、背景、時代、類型。
  • 使用淺顯的語言。首次使用某個術語時請解釋它。
  • 在進入下一組別之前,詢問使用者的選擇。如果使用者說「你決定」,則選擇推薦的選項並告知你選擇了什麼。

第3步:確認並儲存影片風格

  1. 以一個摘要的形式展示完整的影片風格:說話模式、攝影機與格式、鏡頭、運鏡、燈光、色彩、節奏、轉場,以及從視覺聖經複製過來的美術風格區塊。
  2. 要求使用者確認或修改項目。
  3. 在得到明確的同意後,使用 references/film-style-template.md 撰寫 film-style.md。
  4. 提議也將其儲存為可重複使用的預設檔,置於 ~/.long-video/film-styles/<preset-name>.md。使用小寫字母、數字和連字號。如果使用者拒絕,則跳過。

影片風格現在已被鎖定。在撰寫腳本時,未經詢問不得更改。

第4步:撰寫腳本

讀取 references/script-format.md 並遵循其格式和時間規則。

規則:

  • 符合設定:語言、目標長度、長寬比、觀眾、基調、字幕、旁白模式。
  • 忠於已核准的故事。涵蓋每一個劇情節拍。不要添加故事中不包含的事實、事件或主張。如果故事中的文字是旁白文字(例如來自 long-video-story-questions 的內容),請逐字保留該文字並在其周圍添加結構。
  • 將故事分解為場景,並將每個場景分解為鏡頭。每個鏡頭需包含:時長、畫面、攝影機(尺寸、角度、運鏡)、燈光、聲音、轉場。
  • 片段長度限制。 每個鏡頭(一個畫面或剪輯)最長持續 10 秒。目標是 5 到 8 秒。從設定中讀取 video.max_clip_seconds 和 video.preferred_clip_seconds(若已設定)。預設值:最大 10,偏好 5 到 8。少於 5 秒的鏡頭只有在有正當理由(快速插入、強調的節拍)時才允許。絕不超過最大長度。如果某個時刻需要的時間超過限制,請在句子、子句或動作邊界將其拆分為連續的剪輯(鏡頭)。這些剪輯可以共享相同的環境、攝影機和燈光,畫面可以保持不變或繼續相同的動作。最終結果會比任何單個剪輯都長。將每個後續剪輯標記為 Continues: <previous shot id>,並逐字保留旁白或對話。不要為了填滿額外剪輯而發明新的運鏡或新的畫面。
  • 將影片風格應用於每個鏡頭。在鎖定風格的範圍內,變化鏡頭尺寸和運鏡以創造節奏。
  • 對每個角色、環境和物體使用視覺聖經中的實體 ID。如果一個鏡頭需要聖經中沒有的東西,請將其列在「需要的新資產」下方,而不是默默發明。
  • 旁白:使用設定中的語言撰寫文字。對話:撰寫 CHARACTER: line 並在必要時於括號內加上表演指示。確保每一行都能一口氣說完。
  • 加總執行時間。必須落在目標長度的 10% 誤差範圍內。如果不符合,在展示之前進行調整。

第5步:審查

  1. 顯示摘要表格:場景編號、標題、執行時間、鏡頭數量、說話模式。顯示總執行時間與目標的比較。
  2. 完整顯示第一個場景。根據要求提供其他場景。
  3. 列出任何「需要的新資產」。
  4. 要求使用者核准或提出修改要求。
  5. 套用修改。除非使用者要求變更,否則保持影片風格不變。如果影片風格改變,更新 film-style.md 並重新檢查每個鏡頭。
  6. 重複直到使用者明確核准。沉默或「目前看起來不錯」不算核准。如果不確定,請詢問:「鎖定此腳本?」

在展示腳本之前,執行以下自我檢查並修正任何失敗:

  • 總執行時間在目標的 10% 誤差範圍內。
  • 每個故事節拍都出現在腳本中。
  • 每個鏡頭都具有時長、攝影機、燈光和聲音。
  • 沒有鏡頭長於片段限制(預設為 10 秒)。大多數鏡頭落在偏好範圍內(5 到 8 秒)。回報超出範圍的鏡頭數量。
  • 每個實體 ID 都存在於視覺聖經中,或列於新資產下方。
  • 語言符合設定。
  • 沒有鏡頭使用影片風格排除的運鏡或燈光。

第6步:儲存

  1. 使用格式參考的標題、狀態 approved 和核准日期,撰寫 video-script.md。
  2. 確保 film-style.md 已儲存。
  3. 更新 project.json:`

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-story

Agree on the story for a long video. The user either supplies a story or asks Claude to write one. When Claude writes, it first asks which story style to use (for example niche discovery, or a provocative-questions narration), runs that style's skill, and revises until the user approves. Use after long-video-setup, or when the user says "story for my video", "give me an idea", or wants to change an unapproved story. Ends only when the user explicitly approves the story.

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

相關技能