cartoon 是做什麼的?
給它一個故事,它就會從程式碼製作出一個短篇動畫電影:簡單的描邊角色、深藍夜色調與溫暖的燈光窗戶、真實的鏡頭運動與音效。完全不使用 AI 影像或影片生成器。Claude 負責編寫電影,而此資料夾中的引擎則繪製每個影格。
它也能提供故事點子、為 ElevenLabs 撰寫旁白稿,以及建議 YouTube 標題與縮圖提示。
所需條件: Claude 需開啟程式碼執行功能。一部完整的電影代表大量的程式碼與長時間的渲染,因此在 Claude 的免費方案中,使用限制通常會在電影完成前耗盡;付費方案才是實際可行的使用方式。僅在需要旁白時才需要 ElevenLabs(或您自己錄製的聲音)。
以下所有內容皆相對於此技能所在的資料夾(存放此檔案的資料夾)。請找到其絕對路徑,並在每個腳本中使用。在 Claude Code 中,此路徑為 ${CLAUDE_SKILL_DIR}。在以下命令中將其稱為 SKILL。請使用 python3,在 Windows 上則使用 python。
步驟 1:確認使用者需求
使用者可能想要完整的套件或只想要其中一部分。只執行被要求的項目:
| 請求 | 執行內容 |
|---|---|
| 故事點子 | 執行下方的「故事點子」,然後停止 |
| 製作影片 | 步驟 2-6 |
| 撰寫旁白稿 | 閱讀 references/script-playbook.md,交付腳本,停止 |
| 標題或縮圖 | 閱讀 references/packaging-playbook.md,交付建議組合,停止 |
| 完整套件 | 腳本,接著影片,接著標題與縮圖提示 |
故事點子
如果未指定長度,請先詢問影片應多長。然後提供 5 個點子,編號列示,讓使用者可以透過編號選擇。每個點子需包含一個簡短名稱、一句話描述發生的事,以及結局。每個點子需符合該長度:少於 20 秒代表一個角色與一個簡單轉折。點子必須容易以 references/engine.md 中的內容進行動畫化,且每個點子須為原創。後續的「製作點子 3」即代表該點子。
步驟 2:建構前先詢問
除非請求已說明清楚,否則請在同一則訊息中一次詢問下列問題,並使用問題工具(若有的話)。跳過任何已回答的問題。若無人可回答,則使用預設值並告知。
- 長度: 多長?預設 30 秒。若有 MP3,則以旁白長度為主。
- 旁白: 是或否?若已附加 MP3 則跳過此問題。若為是,使用者需提供 MP3 及其腳本文字,或要求您為 ElevenLabs 撰寫腳本並稍後帶回 MP3。不需要 SRT。
- 音效: 是或否?預設為是。
- 背景音樂: 是或否?預設為否。若為是,若使用者有上傳音軌則使用該音軌,否則使用程式碼產生的音樂背景。
- 分鏡圖: 您是否想先看分鏡圖?除非請求已說明,否則一律詢問此問題。若無人可回答,則跳過。
不要預設音樂、音效或旁白。安靜的房間環境音不是音樂。
步驟 3:設定
python3 SKILL/scripts/doctor.py
python3 SKILL/scripts/new_film.py film
doctor.py 會安裝任何缺少的套件。若 Chromium 完全無法執行,請前往「若無法進行渲染」。
接著,依序閱讀:
references/style-bible.md:視覺風格與永不妥協的規則。references/production.md:快速路徑與已知陷阱。references/engine.md:工具組,以便重複使用而非重新繪製。references/film-craft.md:無對白或短片的敘事與鏡頭技巧。
另在相關時閱讀:references/script-playbook.md 用於撰寫腳本,references/voiceover.md 用於 MP3,references/sound.md 用於混音,references/symbolic-beats.md 用於約一分鐘或更長的影片。
步驟 4:規劃影片
在編寫任何繪圖程式碼之前,先撰寫以下內容,因為在程式碼內規劃會產出幻燈片而非影片:
- 一句話概括,讓分心的觀眾也能理解。
- 一個節奏表,每個節拍包含動作、感受、鏡頭與音效。
- 一個世界: 所有角色與道具的固定位置清單。每個鏡頭僅是該世界上的攝影機。
- 一個鏡頭清單,使用影格數而非秒數。目標為每 30 秒 8-11 個鏡頭,並包含一個顯示地理環境的遠景。
- 若要求的是套件,則包含縮圖時刻,使其作為真實場景存在。
若要求分鏡圖,請在渲染前遵循步驟 5 中的「分鏡圖」。
步驟 5:建構
- 取代
film/film.js,保留引擎檔案。從入門影片中的模式開始。 - 在最忙碌的時刻檢查靜態畫面,並檢視圖片:
python3 SKILL/scripts/stills.py film sheet.jpg 1 4.5 9 ...。正常需要兩輪。 - 分鏡圖(若要求)。 執行
python3 SKILL/scripts/storyboard.py film。它會寫出film/storyboard.jpg,每個鏡頭一個編號預覽,使用與最終影片相同的程式碼繪製。向使用者顯示一個表格,每行一個鏡頭(鏡頭、時間、發生什麼、鏡頭、音效),並顯示或傳送圖片。若無法在此處顯示圖片,則傳送檔案,或僅提供表格並告知。然後停止並等待。根據他們的要求修改影片,若修改幅度大則重新執行分鏡圖,並僅在他們核准後才渲染。 - 編輯
film/audio_mix.py中標記的區塊,以符合聲音簡報。 - 使用一個命令進行渲染、混音、合併與稽核:
python3 SKILL/scripts/build.py film --out my-film.mp4
若環境限制命令時間,請在背景執行此命令並輪詢。再次執行相同命令會從中斷處繼續,因為每個鏡頭都是獨立的檔案。修正後,使用 --shots 3 7 僅重新渲染那些鏡頭,或使用 --audio-only 重新混音。
步驟 6:檢查,然後交付
build.py 在結束時會進行稽核。修正每個 ISSUE,或說明為何某個標記出的時刻是刻意為之。然後檢視 film/contact_sheet.jpg,此檔案來自編碼後的檔案。因稽核無法檢查,請目視檢查下列項目:
- 臉部表情符合預期的情緒,且眉毛不應意外地顯現憤怒。
- 手部觸摸到應握持的物品,且沒有任何物體越過臉部。
- 每個行走動作中手臂彎曲方向正確。
- 門先打開,然後角色才走進去。
- 在不同鏡頭中,角色與物體的距離保持一致。
- 任何地方都沒有裝飾性的圓圈。
交付 MP4 並附上簡短說明。明確表示您無法聽到混音:您已測量過,因此使用者應自行聆聽。不要聲稱您未執行的檢查。若使用者要求標題與縮圖,請從包裝手冊中加入建議組合。
若無法進行渲染
若無法執行程式碼或沒有瀏覽器可用,請在可行時執行 python3 SKILL/scripts/bundle_player.py film,此命令會寫出一個 HTML 檔案,該檔案可播放影片並即時錄製 WebM。若您完全無法執行任何操作,請說明缺少什麼,並提供腳本、標題與縮圖提示(這些不需要渲染)。切勿將 WebM 重新命名為 MP4。
關於原創性的規則
使用者分享的參考影片、標題、縮圖或逐字稿僅供參考通用模式:長度、措辭、結構、節奏。切勿複製或保存任何特定於他人作品的內容,也切勿重複使用任何前提、角色、情節、台詞或外觀。每部影片都擁有自己的故事。