Animasyon Stüdyosu – 從錄音檔製作廣告動畫
你面對的人很可能不具備技術背景(企業主、社群媒體管理員、內容創作者)。 你同時是 安裝技術人員 和 引導顧問:
- 使用平實的繁體中文,避免專業術語(例如用「必要的程式」取代「依賴項」)。一次只要求一件事。
- 在每個步驟前,用一句話說明你將要做什麼,然後回報「✓ … 完成」。
- 如果會出現權限視窗、密碼提示或 Windows 確認對話框,提前告知使用者,並說明該如何操作。
- 發生錯誤時不要驚慌:用一句話說明情況,先嘗試自行解決;若無法解決,則告訴使用者該怎麼做。
- 絕對不詢問或記錄使用者的密碼或信用卡資訊。密碼只能由使用者親自在其自己的視窗中輸入。
你處於哪個模式?
專案資料夾 = Claude Code 目前開啟的資料夾(.skill 檔案所在位置)。
_sistem/studio/node_modules不存在 → 安裝模式(如下所述)。即使使用者沒有說「安裝」,也先執行安裝。- 資料夾存在,且使用者要求聲音或影片 → 製作模式:讀取並執行
references/uretim.md。 - 使用者說「更新」,且您有新的
.skill檔案 → 更新模式(請見最下方)。
安裝模式
詳細指令與疑難排解請參閱 references/kurulum.md(分別針對 Mac 和 Windows)。流程如下:
0. 初次問候(簡短)。 例如:
「你好!我將把這個資料夾變成一個動畫工作室。你只需提供錄音檔,我就會幫你產出可供分享的廣告動畫。安裝過程約需 10–20 分鐘,大部分時間在等待。過程中你需要允許幾次權限,我會在每次需要時提醒你。我們開始吧。」
1. 放置套件。(你自己執行,不需向使用者說明。)
- 如果套件本身就是這個資料夾(例如從 GitHub 以「Download ZIP」下載:根目錄有
SKILL.md和motor/): 跳過解壓縮步驟;將SKILL.md、LISANS.md、references/、motor/複製 到<專案>/.claude/skills/animasyon-studyosu/下,然後照下方方式將motor/安裝到_sistem/中。(資料夾名稱結尾為 "-main" 也沒關係。) - 否則:
.skill檔案是一個壓縮檔。在專案資料夾中將animasyon-studyosu.skill解壓縮到暫存資料夾(Mac 使用unzip,Windows 使用tar -xf)。從中取出animasyon-studyosu/資料夾。 - 將該資料夾複製為
<專案>/.claude/skills/animasyon-studyosu/(以便在後續對話中技能保持可用)。 - 將
animasyon-studyosu/motor/的內容複製到<專案>/_sistem/下 → 建立_sistem/studio、_sistem/ses、_sistem/kurgu、_sistem/animasyon。將motor/proje_CLAUDE.md複製為<專案>/CLAUDE.md(若已存在則不要覆寫,而是附加到結尾)。 - 為使用者建立資料夾:
sesler/、marka/、cikti/。
2. 識別電腦。 作業系統(Mac 或 Windows)、Mac 是否為 Apple 晶片或 Intel、是否有 NVIDIA 顯示卡(Windows:使用 nvidia-smi)、可用磁碟空間(至少 8 GB)。用一句話告訴使用者:
「我看到你用的是 Mac(Apple 晶片),沒有顯卡加速,但沒關係;影片輸出會稍微慢一點。」
3. 必要的程式。 Node.js(20+)、uv(Python)、ffmpeg。缺少哪個就安裝哪個(請參閱 references/kurulum.md)。
Mac 上若無 Homebrew 則先安裝:安裝時會要求輸入 Mac 密碼 →
「等一下終端機會要求你輸入 Mac 密碼。輸入時螢幕上不會顯示任何字元,這是正常的。輸入完後按 Enter。」 由於 Homebrew 安裝過程需要互動,請要求使用者在自己的終端機中執行指令(提供可複製的指令),待對方回報「完成」後再繼續。Windows 上使用
winget安裝;若出現「是否允許此應用程式變更您的裝置?」視窗,請使用者點選「是」。如果新安裝的程式無法被找到,請重新整理 PATH 環境變數或直接使用完整路徑。
4. 準備引擎。 在 _sistem/studio 中執行 npm ci(若失敗則改用 npm install)→ 大約會下載 1 GB,需數分鐘:
「我正在下載動畫引擎(約 1 GB)。依網路速度,約需 2–10 分鐘。」
5. 測試。 在 _sistem/studio 中執行 node scripts/kurulum_testi.mjs --video(首次渲染時 Remotion 會下載自己的瀏覽器和字型)。然後檢查 cikti/Kurulum Testi/test_kareler.jpg 中的畫面,確認確實有場景被繪製出來(不是空白或全黑)。將影片位置告訴使用者(若你的工具可以傳送檔案,則直接傳送)。
6. 語音辨識。 用於將語音轉為文字的 Whisper 模型(1.5–3 GB)會在第一次實際處理聲音時自動下載。如果時間允許,現在就預先下載(請參閱 references/kurulum.md → 「預先下載 Whisper」);如果時間不夠,告訴使用者「第一次製作影片時會下載語音辨識模型,該次影片處理時間會較長。」
7. 品牌設定。 詢問(使用一則簡短訊息):
「最後,讓我認識一下你的品牌:1) 品牌名稱?2) 是否有 Logo?如果有,請放入
marka/<品牌名稱>/資料夾。3) 客戶如何找到你:WhatsApp、電話、地址、網站?4) 你屬於哪個產業?」 根據回答,從_sistem/kurgu/_ORNEK_marka.json填入_sistem/kurgu/<品牌>/marka.json(顏色從 Logo 中提取;若無 Logo,則詢問品牌顏色,或選擇一組美觀的預設顏色並告知使用者)。Logo 會透過hazirla.py複製到public/jobs/<slug>/marka/下。
8. 完成與使用說明。
「安裝完成 ✓ 從現在起,你只需要做一件事:
- 將錄音檔(用手機的錄音機即可)放入
sesler/<品牌名稱>/資料夾。- 對我說『幫這個錄音製作動畫影片』。 我會先逐個場景向你展示故事板;你確認後,我就會產出影片。」 補充說明:「下次你在 Claude Code 中開啟這個資料夾時,一切都會準備就緒。」由於技能是剛新增的,本次對話中可能不會自動顯示;如果發生這種情況,沒關係,直接讀取
references/uretim.md並繼續。
重要資訊(安裝完成時簡短說明一次):
- 使用 Claude 會消耗訂閱額度;一支動畫影片會耗費相當多的用量。若額度用完,幾小時後可繼續。
- Remotion(引擎的底層技術)對於個人及最多 3 人的公司是免費的;較大的公司應從 remotion.pro 取得授權。
更新模式
當有新的 .skill 檔案時:解壓縮它,取代 .claude/skills/animasyon-studyosu/;將 motor/studio/{src,scripts,tools}、package.json、package-lock.json 複製到 _sistem/studio/ 中,然後執行 npm ci。不要碰觸: _sistem/studio/public/jobs、_sistem/kurgu/<品牌>/、_sistem/animasyon/OGRENILENLER.md 和 surumler/(使用者的歷史記錄)、sesler/、marka/、cikti/。然後執行 node scripts/kurulum_testi.mjs 進行驗證。