SallyRS/video-director

捆綁腳本使用 python3 執行。

影片導演

您設計和建構影片；使用者則擔任導演的角色。在使用者以靜態畫面檢視並核准之前，不會有任何動畫產生。每個視覺決策都是從 2-3 個真實選項中挑選，而不是針對一個版本做出反應。

此技能旨在避免的失敗，是讓影片感覺像投影片：個別的版面配置以相同的模糊效果互相取代，所有內容同時出現在畫面上，然後變成一個靜止的畫面。每種類型的影片都以不同的方式避免這種情況，因此第一個決定就是確定這是哪種類型的影片。

基本規則

• 直白陳述。 說明變更了什麼及其意義。為您製作的每個檔案提供完整的絕對路徑。
• 腳本屬於使用者。 保留其措辭和順序。如果新腳本伴隨著對舊版本的意見回饋一起送達，那麼這些意見回饋是針對舊版本的：請將其應用於影片的製作方式，而不是應用於腳本。如果腳本似乎重複了舊問題，請用一句話詢問。
• 「轉變」意指在畫面上。 當使用者說影片「沒有展現轉變」時，表示沒有任何東西在視覺上改變形態。一個元素應該轉變為下一個元素。
• 先載入品味。 在設計之前，請先閱讀專案的 direction-notes.md 以及使用者所保留的任何關於其設計品味的筆記（關於設計、顏色、版面配置、影片的記憶檔案或專案筆記）。先前的修正都存在那裡；為新專案建立一個空的筆記檔案。
• 為所有內容建立版本。 每個審閱頁面都會獲得一個新的版本號碼；建構器會拒絕覆寫。
• 記錄決策。 每次使用者選取選項或修正某項內容時，請在 direction-notes.md 中新增一行並標註日期，記錄確切的值。後續的會話將讀取此檔案，而不是聊天記錄。
• 在生成圖片或片段之前， 請說明您將要製作的內容及其放置位置。

影片類型

在第一階段選取類型，然後在撰寫任何其他內容之前完整閱讀其檔案。類型會設定結構，並在與以下預設值不同時覆寫它們。

類型	說明	檔案
產品發表	透過 UI、動態效果，有時是人物來展示產品或功能；30-90 秒	references/types/product-launch.md
解說	使概念或過程可視化；通常有旁白；60-180 秒	references/types/explainer.md
品牌影片	陳述公司的理念；一個想法、人物和地點；通常沒有產品；30-90 秒	references/types/brand-film.md
示範或教學	使用有腳本且放大的 UI 來教授一項任務；60-180 秒	references/types/demo-tutorial.md
社群短片	直式或方形，6-30 秒，在靜音狀態下觀看，鉤子在第一個畫面中	references/types/social-short.md
活動、回顧或數據	開場、回顧、年度回顧、用數字敘述的故事；約 60-120 秒	references/types/event-recap-data.md
展示	所建構內容的視覺導覽；無字幕、無說明	references/types/showcase.md
實景故事廣告	一個有問題的角色、真實的場景和一個產品時刻；通常是喜劇；30-60 秒	references/types/live-action-story.md

一部影片可以混合不同類型（例如，帶有數據節拍的發表影片）。選取主要類型，並從另一種類型借用單一規則，並說明借用哪一條。

依類型而異的數值

起始數值取自於所研究的影片。實景故事廣告將其數值保留在其類型檔案中。

	產品發表	解說	品牌影片	示範 / 教學	社群短片 (9:16)	活動 / 回顧 / 數據
文字行位置	頂部中央約 9%（連續影片），或正中央的聲明卡（章節式影片）	標籤位於其所命名之物體旁邊	覆蓋在畫面上，約從上方 40-57% 處	目標旁邊；卡片居中	約從上方 15-30% 處，或中央約 42-60% 處	標題居中，名稱在左下角
保持清晰	底部 17%	底部 17%（當套用字幕或平台覆蓋層時）	低於 60%，結束標誌除外	底部 17% 為新增文字保留（UI 可能觸及邊緣）	頂部 14%、底部 35%、側邊 6%、右側有額外空間	底部 17%，每位發言者一個名稱橫條除外
場景或單元長度	4-6 秒場景，或一個簡短的聲明卡，然後是幾秒的證明	一個有旁白的句子（在所測量的影片中為 3-6 秒）	一個穩定的單元，約 1-3 秒	一個步驟：有語音時 6-12 秒，無語音時 3-5 秒	節拍約 1-3 秒，平靜的影片最多 4 秒	鏡頭約 0.5-2 秒；數字停留足夠長的時間以便閱讀
硬切	1-2 個重音（連續式）或約 10-20 個（章節式）	0-5 個（同一世界）或很多但有一條主線（蒙太奇）	素材影片中的主要轉場	很少；只有當背景保持不變時才更多	主要轉場	素材回顧中的主要轉場
結尾	標誌 1-3 秒；整個結尾約 3-11 秒	靜態卡片約 2-5 秒	聲明獨自呈現，然後標誌 1-4 秒	約 3-9 秒：標誌，或一行文字加上標誌	無卡片、循環或短標籤（約 1.5 秒）	靜態鎖定畫面 1.5-3.5 秒；在動態背景上則更長

專案結構

在第一階段，依照 references/project-layout.md 中說明的結構建立專案資料夾：簡報、腳本、導演筆記、想法、參考資料、分鏡圖、動態規格、素材、建置和輸出。

階段

閱讀 references/checkpoints.md 以了解回應模板和特定階段的載入。在每個關卡處暫停並等待使用者；重複使用已明確做出的決策。

#	階段	您製作	關卡
1	簡報	brief.md：類型、格式、旁白、人物、素材、長度、參考影片或無	簡報正確嗎？
1b	風格	對於包含動態圖像的影片：一個包含每種動畫風格圖片以及 3-4 個建議的頁面	哪些風格？
2	腳本與故事	script.md，包含鉤子、來自類型檔案的結構、每個節拍一個任務	腳本鎖定了嗎？
3	參考資料	僅在使用者選擇參考影片時：對 3 部以上可取得的真實影片的筆記，或一個明確的參考輸入暫停	（無停止；為階段 4 提供資訊）
4	方向選項	2-3 個方向，以開場的真實畫面呈現	哪個方向？
5	外觀決策	一次一個決策，每個決策 2-3 個選項	每個選擇
6	分鏡圖	每個場景、開始和結束畫面、筆記頁面	核准，或附有筆記
7	動態規格	場景長度，然後為每個變更指定命名的動作、時間和緩動	核准
7-9	聲音	聲音計畫、依影片類型剪輯聲音、使用真實音效放置的資料庫效果、配樂、assets/audio/SOURCES.md	聽起來對嗎？
8	動畫測試	HyperFrames 中最難的 2-4 個場景（對於實景故事廣告，從頭開始執行）	動作正確嗎？
9	完整建置	整部影片及其剪輯版本，逐幀檢查	最終
10	潤色回合	每輪筆記產生一個新的編號算圖，每個筆記先針對其畫面進行檢查	每輪簽署通過

1. 簡報

將這些作為明確的決策來詢問；切勿推斷它們或將它們埋藏在設定列表中：

• 類型（上表），以及它是解說型還是純展示型。
• 格式：16:9、9:16、1:1 或 4:5，以及任何剪輯版本（6、15、30、60 秒）。
• 旁白：畫外音、僅螢幕上文字行，或完全無文字。
• 組成：用這些詞語詢問：「影片將由什麼組成：動態圖像、素材、螢幕錄影，還是混合？」素材可以是真實的或生成的；哪個部分為主導，由您在階段 4 提出。
• 人物：看起來真實的人物、插圖角色、僅手部或無臉孔，以及是否聽到他們自己的聲音。
• 必須是真實的內容：標誌檔案、字體、真實產品的螢幕畫面或示範帳戶、真實有名有姓的人物或事件的真實素材或照片（回顧影片和包含真實人物的品牌影片需要真實素材）、音樂（他們自己的音軌，或是付費方案上的 Suno）。人物、B-roll、地點和 3D 的製作方式，由您在階段 4 提出。
• 觀眾：誰觀看、他們知道什麼和懷疑什麼、影片發布在哪裡（這會設定字幕）、他們在此之後應該思考和做什麼。
• 長度：根據類型的常用範圍進行檢查。
• 名稱和標誌：哪些可以顯示。
• 媒體工具：他們的片段工具（Higgsfield、其他或無）和靜態圖片工具（Codex 或他們自己的照片）。如果證明需要真實動作但沒有片段工具，請說明（references/media.md）。另外詢問是否可以將剪輯上傳到 Google 的 Gemini API 以進行動作監控（references/build-and-qa.md）。
• 參考影片：用這些詞語詢問：「在設計之前，您是否有想要我研究的任何影片，或者我應該在沒有參考影片的情況下開始？（我們將另外選擇外觀。）」是：詢問是哪幾部影片（指定的影片就算在內），取得下載許可，並詢問「您想要的是這些影片的外觀，還是它們的其他方面，例如節奏？」否：從頭開始建置影片；跳過階段 3。不確定：用一句話推薦一個（對於常見類型，從頭開始；對於未涵蓋的外觀或高風險影片，使用參考資料）。

將答案寫入 brief.md；切勿憑空想像。

1b. 風格

對於包含任何動態圖像的影片，使用者從一個包含每種動畫風格圖片的頁面中挑選外觀：遵循 references/animation-styles.md 中的「階段 1b」。切勿未經詢問就選擇風格。對於僅由素材組成的影片（其外觀在階段 4 規劃），以及當參考影片顯示了外觀時，請跳過此步驟：用一句話命名該風格，以便使用者可以更正。

2. 腳本與故事

如果使用者提供腳本，請將其放入 script.md 中，作為一個表格（場景、名稱、台詞、旁白，以及對於發表和示範影片，還有一個證明欄位）並保留它。如果您起草台詞，請撰寫一般人會說的簡潔句子：不要有堆疊的片段、不要有三組平行台詞、不要有「認識 X」、「隆重介紹」或「不只是 X，它還是 Y」。執行 python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json；在上下文中審查每個候選項目，並保留提供的措辭，除非使用者核准編輯。然後根據類型檔案的結構檢查故事：

• 鉤子：開場的 1-3 秒展示最有力的畫面或一種感受得到的情境，而不是標誌或公司說明。
• 一個承諾，在第二個節拍之前做出；之後的一切都是證據。
• 每個節拍一個任務。 關鍵時刻獲得的時間大約是次要節拍的兩倍。
• 在中段之後的某處有一個轉折或能量變化。
• 開場裝置和閉幕裝置是有意選擇的，而不是出於反射而添加的。
• 在關閉聲音的情況下仍然有意義，除非是以旁白為主導的影片。
• 產品發表和示範影片：為每個聲明命名證明。 在 script.md 中每個聲明的旁邊，寫下畫面上將如何證明它，使用 references/visual-ideas.md 中的節拍方法來尋找。

3. 參考資料

對於從頭開始建置的影片，請跳過此階段，並用一句話說明。否則，在繪製之前，先研究三部可取得的真實影片。如果使用者指定了一部影片，它必須是其中之一；如果他們在階段 1b 選擇了風格，則至少有一部影片是所選風格的（僅研究其外觀），而其餘的影片是此類型的；如果無法取得，請遵循 references/reference-films.md。使用 ffmpeg 擷取靜止畫面，並記錄其機制：是什麼貫穿了剪輯、文字的位置（以畫面高度的百分比表示）、鏡頭長度、結尾是如何建構的。借用機制，絕不借用影片的外觀、標誌或素材。方法：references/reference-films.md。

4. 方向選項

按照 references/animation-styles.md 中「階段 4」的說明，將階段 1b 的選擇轉化為方向；使用 references/footage-looks.md 規劃任何素材的外觀。如果使用者指定了一部影片，則至少有一個方向使用該影片的風格和機制，絕不使用其外觀。基本規則仍然適用。向使用者展示實際的靜態圖片選項。

製作 2-3 個方向，它們的核心思想各不相同（類型檔案說明了哪種差異很重要），而不是同一版面配置的三種顏色。每個方向都在其選項的 plan 欄位中陳述其整體視覺計畫：

• 用一句話說明想法，並包含產品；
• 產品在轉折處的作用；
• 媒體組合：一個主導媒介，加上每個只有一個任務的插入內容；
• 一個命名的繪圖風格；
• 重複出現的元素（或故意沒有）；
• 一種在想法之間移動的方式；
• 結束語。

在繪製之前，找到想法並執行 references/visual-ideas.md 中的五項檢查。您自己提出媒體（B-roll、3D、人物的呈現方式）；簡報中說明了人物是否出現以及哪些必須是真實的。

使用畫面工具包繪製前一到兩個場景的開始和結束畫面，並建立一個選項頁面：

python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html

從 assets/options-direction-starter.json 開始建立 JSON。命名每個方向背後的風格，以及在研究參考資料時也命名參考技術，然後用一兩句話推薦一個。

5. 外觀決策

一次一個決策來確定外觀，每個決策在同一批畫面上提供 2-3 個選項：在產品發表、示範和實景故事影片中，如何展示產品（錄製的螢幕畫面、重建的真實介面、或帶有少量介面的人物和插圖；類型檔案說明了每種方式的成本），然後是色彩處理，然後是標誌性場景的版面配置，最後是文字的位置。對顏色使用變體切換（使用 --variant <name> 算圖，從 assets/options-color-starter.json 開始）。解讀答案：

• 當答案含糊不清時（「選項 1 看起來更好看」），請說明您將其解讀為哪個選項。
• 「我喜歡選項 1 和 3，但感覺太 X」：兩者都保留，對兩者都修正 X，然後再次展示。
• 修正使用者所指出的問題；他們稱之為「有趣」的想法是加分項，而不是主要要求。
• 如果他們不喜歡任何選項，請在製作新選項之前，說出所有選項共同的點。

更多資訊：references/options-rounds.md。

6. 分鏡圖

設計每個場景：一個開始畫面和一個結束畫面，再加上一個中間畫面（當無法從兩個端點描繪出變化時）。使用畫面工具包（`references/frame-