motionable:製作 是做什麼的?
您到達這裡時,擁有產品的相關事實(每項都有來源)、使用者的回答、圖片路徑、顏色以及其個性的筆記。您的工作是製作一部完成的影片,感覺像是這個產品,而且不像工作室裡的任何其他影片。
ROOT 是 motionable 根目錄:${CLAUDE_PLUGIN_ROOT}。如果該變數未被展開,請使用此檔案真實路徑 (realpath) 上方兩層的資料夾,該資料夾包含 engine/ 和 scripts/。
在規劃之前,請閱讀 ROOT/PLAN.md(企劃模式)、ROOT/ENGINE.md(組成要素)、ROOT/rules.md(硬性規則)和 ROOT/checklist.md(評論)。ROOT/examples/owly/ 展示了完成品的外觀。切勿複製其外觀、聲音或結構:它只是無盡方向中的一個方向。
1. 建立影片
- 存放位置: 影片存放在目前資料夾(通常是使用者的宣傳影片工作室)中,以
<slug>/的形式存在。- 如果目前資料夾是產品本身的儲存庫,請改用
motionable/<slug>/。 - 切勿寫入提供給
/motionable:project的產品資料夾。 - 如果
<slug>/已存在,請詢問:建立新版本 (<slug>-2/),還是繼續該部影片?
- 如果目前資料夾是產品本身的儲存庫,請改用
- 建立它: 執行
bash ROOT/scripts/new.sh <film> "<Product name>"。它會將引擎複製到影片中並寫入範本。 - 素材: 將圖片複製到
<film>/assets/中,並使用清晰的名稱(logo.png、screen-home.png……)。如果使用者有品牌字型檔案,則放入assets/fonts/。
2. 企劃模式(內部:無指令,無樣式選單)
從頭到尾遵循 PLAN.md:
- 證據板與個性。
- 故事: 承諾、標誌性時刻、3 個鉤子 → 1 個。
- 每個設定轉盤及其理由。
- 相對於工作室的獨特性: 閱讀其他影片的
DIRECTION.md› 指紋。v0.2 之前製作的影片沒有指紋;將它們視為 120 BPM A 小調 House 音樂,搭配左對齊的標題顯示在卡片上。 - 撰寫 DIRECTION.md 和 SCRIPT.md,使用所選的節奏。
不要要求使用者挑選風格。方向來自證據。
3. 一次核准
顯示四行治療(感覺 · 聲音 · 外觀 · 標誌性時刻)和一個緊湊的節奏網格(時間 · 畫面 · 文字 · 接合)。然後提問,如果可用則使用 AskUserQuestion(否則在聊天中進行):
- 計劃: 核准,或更改某些內容。
- 插圖: 「我應該為這部影片繪製插圖嗎?」是的,請繪製插圖 / 少量點綴 / 不,僅使用螢幕截圖和文字。推薦一個並附上理由(PLAN.md §5)。
- 繪製它們是免費的:Claude 會撰寫 SVG。
- 僅當工作階段連接了圖片生成工具時,才將其作為選項加入,並說明可能需要付費。
在核准之前,不要撰寫任何場景程式碼。此時的修改成本很低。
4. 建構
- 插圖(如果選擇「是」):將 SVG 寫入
assets/drawn/,使用品牌的顏色和統一的線條粗細(ENGINE.md › 繪製插圖)。將每個插圖顯示在一張紙上,並重新繪製任何粗糙的圖形。 scenes/Film.swift: 完全取代骨架。每個值都來自 DIRECTION.md 和 SCRIPT.md:- 時間放入
enum T; - 剪輯與接合放入
Reel; - 螢幕畫面透過取景呼叫處理(切勿裁剪到固定方框內);
- 標誌性時刻要重新繪製,使其動畫效果與實際 UI 一模一樣。首先測量其位置:
bash ROOT/scripts/inspect.sh <screenshot> find <its colour>(或row、column、pixel)會給出精確的環、條和文字邊緣。 - 方向所需的自訂元素放在各自的
scenes/*.swift檔案中。
- 時間放入
- 音效: 方向中的「配方」+「段落」透過
s.compose實現,並為每個畫面事件加入s.cue,使用標誌性音效。 - 檢查是否能建構:
bash ROOT/scripts/run.sh <film> sheet(不指定時間:檢查整部影片及每個接合)。修正編譯錯誤(ENGINE.md › 陷阱)。
5. 草稿、修正,然後展示給使用者
以草稿方式進行,切勿無止盡地循環:
- 草稿 1 是第一個完整的建構:場景、音樂和每個提示。從影片本身(以下步驟)進行審查;您不需要影片檔案即可進行審查。(
run.sh <film> draft如果使用者想要提前預覽,則會渲染一個較小的快速 MP4。) - 自我審查:一次通過,並檢查每一項。
run.sh <film> check:每個 ✗ 都必須修正。將時間線拉長、提早開始、刪減文字,或放棄該台詞。打字台詞需要其打字時間加上閱讀時間。也要遵循其 ⚠ 建議(第 1 幀、節奏),除非 DIRECTION.md 說明了不這麼做的原因。run.sh <film> sheet:根據 checklist.md 中的每個類別評分,並修正任何低於 8 分的項目。以全尺寸stills查看鉤子、標誌性時刻和結尾卡:UI 是否清晰易讀?是否有任何元素衝突?畫面的每個角落是正在發生作用還是刻意留空?- 觀眾會懲罰的內容(RESEARCH.md › 社群檢查):UI 太小難以閱讀、大型物體的彈跳、長度一致的鏡頭、聽起來像罐頭音樂的配樂、緩慢的標誌顯示時刻。
run.sh <film> audio,接著執行bash ROOT/scripts/compare.sh <film>:如果另一部影片過於相似,請基於某個理由更改配方。- 逐步播放整部影片:
run.sh <film> sheet $(seq 0.5 1 <length>)(每秒一個畫面)。尋找單張靜止畫面會隱藏的內容:一個逐漸空無一物的場景、一個沒有動感的節拍、一個令人不快的接合、一個在場景切換時才出現的台詞。
- 草稿 2。 一次性修正所有發現的問題,然後再次執行
check和sheet。- 如果仍有失敗項目,最多允許再進行一次修正。
- 如果之後仍然失敗,請不要繼續:告訴使用者剩餘的問題及其原因。
- 在 SCRIPT.md 中保留簡短的評論記錄:更改了什麼以及原因。
- 渲染真實檔案:
run.sh <film> video,30 秒的影片約需 45 秒。 - 展示並提問(如果可用則使用 AskUserQuestion)。傳送 MP4、四行治療和評論記錄,然後針對這個剪輯提出 3–4 個針對性問題。每個問題都需要一個推薦選項,而「其他」讓使用者可以說任何內容:
- 節奏: 感覺剛好 / 慢一點,減少台詞 / 快一點,更有衝擊力。
- 音效: 保留 / 更有能量 / 更平靜 / 不同的樂器。
- 鉤子: 保留它,或是企劃模式中其他兩個鉤子候選選項中最強的一個,並命名。
- 結尾: 保留它 / 啟動安全結尾(例如,在應用程式上線前不要顯示「下載」徽章)/ 加入價格。
- 每輪回答後修改一次,重新執行
check和audio和compare,然後展示新的剪輯。在使用者進行兩輪之後,提供是否停止或繼續的選項;由使用者決定。
6. 存放徽章(僅當產品已上線時)
- App Store 已上線且使用者想要徽章: 請求許可,將 Apple 官方徽章(約 11 KB,黑色,英文 SVG;URL 在 rules.md 中)下載到
assets/。- 使用
drawAppStoreBadge繪製,保持靜態且絕不加上動畫;強調效果來自glowRing。 - 如果使用者堅持要加上動畫,請解釋一次 Apple 的規則。如果他們仍然想要,請將其製作成一個獨立的、命名清晰的變體。
- 使用
- Google Play: 僅當應用程式在該平台上線且使用者核准下載時,才使用其徽章。否則,最多只能使用純文字行,並且僅在情況屬實時才能這麼做。
7. 交付
每次展示剪輯時,請包含:
- 幾行描述的治療內容;
- 自我審查修正了哪些內容;
- 比較結果和
check的判定; - 發布前需驗證的主張;
- 如何修改:編輯 SCRIPT.md 或 DIRECTION.md,或直接口頭說明。
在使用者滿意之後,提供接下來有用的項目:
- 15 秒的短片,或其他格式(1:1、16:9);
- 用於 A/B 測試的鉤子變體:以企劃模式中其他兩個鉤子候選選項作為開場的同一部影片;
- 啟動安全結尾(在應用程式上線前不顯示「下載」);
- 純效果版本(
run.sh <film> video effects),用於搭配平台音效或授權曲目發布。