Communitygithub.com

motionable:製作

內部 motionable 影片製作流程(企劃、審核、場景、音樂、評論、渲染)。請以 /motionable:scratch、:website 或 :project 開始使用。

motionable:製作 是什麼?

此技能會將產品事實、使用者回答、圖片與品牌個性轉化為獨一無二的宣傳影片。它遵循一套嚴謹的製作流程,從分析產品證據開始,建立方向文檔與劇本,然後生成場景、音樂與標誌性時刻。它支援在本地資料夾中以特定前綴建立影片,並提供自動化檢查、評論和渲染功能。技能包含多次迭代與使用者反饋流程:先以「四行治療」與節奏網格取得一次企劃核准,再逐步構建場景、SVG 插圖與音效,最後透過 check、sheet、audio 與 compare 腳本進行自我審查,確保品質高於門檻。輸出可包括 15 秒短片、A/B 測試鉤子變體、啟動安全結尾與純效果版本,並支援 App Store 與 Google Play 徽章下載。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

在你喜歡的 AI 中提問

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

說明文件

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:

  1. 證據板與個性。
  2. 故事: 承諾、標誌性時刻、3 個鉤子 → 1 個。
  3. 每個設定轉盤及其理由。
  4. 相對於工作室的獨特性: 閱讀其他影片的 DIRECTION.md › 指紋。v0.2 之前製作的影片沒有指紋;將它們視為 120 BPM A 小調 House 音樂,搭配左對齊的標題顯示在卡片上。
  5. 撰寫 DIRECTION.md 和 SCRIPT.md,使用所選的節奏。

不要要求使用者挑選風格。方向來自證據。

3. 一次核准

顯示四行治療(感覺 · 聲音 · 外觀 · 標誌性時刻)和一個緊湊的節奏網格(時間 · 畫面 · 文字 · 接合)。然後提問,如果可用則使用 AskUserQuestion(否則在聊天中進行):

  1. 計劃: 核准,或更改某些內容。
  2. 插圖: 「我應該為這部影片繪製插圖嗎?」是的,請繪製插圖 / 少量點綴 / 不,僅使用螢幕截圖和文字。推薦一個並附上理由(PLAN.md §5)。
    • 繪製它們是免費的:Claude 會撰寫 SVG。
    • 僅當工作階段連接了圖片生成工具時,才將其作為選項加入,並說明可能需要付費。

在核准之前,不要撰寫任何場景程式碼。此時的修改成本很低。

4. 建構

  1. 插圖(如果選擇「是」):將 SVG 寫入 assets/drawn/,使用品牌的顏色和統一的線條粗細(ENGINE.md › 繪製插圖)。將每個插圖顯示在一張紙上,並重新繪製任何粗糙的圖形。
  2. 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 檔案中。
  3. 音效: 方向中的「配方」+「段落」透過 s.compose 實現,並為每個畫面事件加入 s.cue,使用標誌性音效。
  4. 檢查是否能建構: bash ROOT/scripts/run.sh <film> sheet(不指定時間:檢查整部影片及每個接合)。修正編譯錯誤(ENGINE.md › 陷阱)。

5. 草稿、修正,然後展示給使用者

以草稿方式進行,切勿無止盡地循環:

  1. 草稿 1 是第一個完整的建構:場景、音樂和每個提示。從影片本身(以下步驟)進行審查;您不需要影片檔案即可進行審查。(run.sh <film> draft 如果使用者想要提前預覽,則會渲染一個較小的快速 MP4。)
  2. 自我審查:一次通過,並檢查每一項。
    • 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>)(每秒一個畫面)。尋找單張靜止畫面會隱藏的內容:一個逐漸空無一物的場景、一個沒有動感的節拍、一個令人不快的接合、一個在場景切換時才出現的台詞。
  3. 草稿 2。 一次性修正所有發現的問題,然後再次執行 check 和 sheet。
    • 如果仍有失敗項目,最多允許再進行一次修正。
    • 如果之後仍然失敗,請不要繼續:告訴使用者剩餘的問題及其原因。
    • 在 SCRIPT.md 中保留簡短的評論記錄:更改了什麼以及原因。
  4. 渲染真實檔案: run.sh <film> video,30 秒的影片約需 45 秒。
  5. 展示並提問(如果可用則使用 AskUserQuestion)。傳送 MP4、四行治療和評論記錄,然後針對這個剪輯提出 3–4 個針對性問題。每個問題都需要一個推薦選項,而「其他」讓使用者可以說任何內容:
    • 節奏: 感覺剛好 / 慢一點,減少台詞 / 快一點,更有衝擊力。
    • 音效: 保留 / 更有能量 / 更平靜 / 不同的樂器。
    • 鉤子: 保留它,或是企劃模式中其他兩個鉤子候選選項中最強的一個,並命名。
    • 結尾: 保留它 / 啟動安全結尾(例如,在應用程式上線前不要顯示「下載」徽章)/ 加入價格。
  6. 每輪回答後修改一次,重新執行 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),用於搭配平台音效或授權曲目發布。

Individual skills in this repo

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

相關技能