紙片剪貼解說員

約 20-45 秒的垂直解說影片，外觀就像活過來的層層剪紙：帶有陰影的顆粒狀紙質道具、剛硬的剪裁動畫、緩慢的鏡頭推近搭配停格紙片晃動、每個節拍一個膠帶標題橫幅，以及逐字撕裂紙片的字幕標籤。基於 Remotion 建構，可選 AI 生成的紋理資產，以及任何 TTS 語音引擎。

每個節拍包含三條軌道：

旁白講述故事
膠帶橫幅添加一條旁白跳過的事實
新的一套紙片場景詮釋旁白的文字，並以粗糙的紙片剪貼重建產品 UI 來進行示範

請重複使用風格和說故事方式，而不是已完成的範例內容。每個範例中的產品、公司和數字均為虛構。風格規則位於 $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md（第 2 節為風格 DNA）。

前置檢查

函式庫。 解析 $MOTION_LIB，否則使用 ${XDG_CONFIG_HOME:-~/.config}/motion-explainer/config.env 中的 MOTION_LIB= 行，否則只詢問一次。永遠不要硬編碼機器路徑。階段 1 到 4 不需要函式庫。
安裝模式。 在承諾某個階段之前探測它（參見安裝模式）。
系列。 找到系列資料夾（它包含 episodes/）。如果存在，讀取其 SERIES.md。

執行模式（先詢問）

完整影片，從想法到 mp4：階段 1 到 8，然後在發佈後進行階段 9。
純腳本：策略、鉤子、腳本（在排練表之後停止）。
從現有腳本產出分鏡：motion-storyboard。請求腳本、事實和 HOOK 區塊。
為其他工具提供風格提示：給出 $MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md 中的正確區塊，然後停止。
修復或重建一個場景：motion-build（場景步驟），然後 motion-qa。

資訊收集（只詢問缺失的部分）

來源：通常是一個連結（儲存庫、產品網站、公告）。其他所有資訊都從中研究取得。
影片要證明的唯一主張，以及主題。
角色框架：誰或什麼來負責工作，誰提供建議或批准。與使用者確認，永遠不要發明產品行為。
CTA 關鍵字以及觀看者獲得的東西（交付物）。
長度：預設 22-30 秒。
受眾層級（來自 SERIES.md）以及任何強調色或吉祥物。

將答案寫成 episodes/NN-slug/research/facts.md 頂部的 BRIEF 區塊（格式見 motion-strategy）。

階段

#	階段	技能	讀取	寫入
1	策略	`motion-strategy`	`SERIES.md`，來源	`research/facts.md` 中的 BRIEF，`SERIES.md`
2	鉤子	`motion-hook`	BRIEF	`video/STORYBOARD.md` 頂部的 HOOK 區塊
3	腳本	`motion-script`	BRIEF，HOOK	`research/facts.md`，`narration/script.json`，`STORYBOARD.md` 中的排練表
4	分鏡	`motion-storyboard`	`script.json`，`STORYBOARD.md`	`STORYBOARD.md` 中的攝影機/剪輯表、場景區塊、音效計劃
5	支架與計劃	`motion-build`	`STORYBOARD.md`	專案，`episode.json`
6	語音與時序	`motion-voice`	`script.json`，`voice/voice.json`	`narration/` 錄製、`public/vo/captions.json`、`src/plan.json`
7	場景、聲音、渲染	`motion-build`	`plan.json`、`STORYBOARD.md`	`src/scenes/`、`tools/cues.json`、`out/.mp4`
8	品質檢查	`motion-qa`	靜止圖、`STORYBOARD.md`	修復、交付摘要
9	發佈後	`motion-strategy`（事後分析）、`motion-build`（收穫）	平台數據、專案	`research/analytics/`、函式庫推廣

專案檔案

流程存在於檔案中，而不是對話中。每個階段讀取上述檔案並寫入自己的檔案，所以新會話可以從任何階段繼續。

<series>/
  SERIES.md                  可選：受眾、語氣、調色板、吉祥物、關鍵字記錄
  voice/voice.json           可選：語音設定（複製 library/voice/voice.example.json）
  video-assets/              可選：疊加紋理和道具
  research/analytics/        可選：競爭對手研究和事後分析
  episodes/NN-slug/
    research/facts.md        BRIEF + 事實與來源
    narration/script.json    [{"id": "l1_hook", "text": "..."}, ...]
    video/
      episode.json           場景、橫幅、鉤子、間隙、背景音樂、剪輯
      STORYBOARD.md          鉤子、排練表、攝影機/剪輯表、場景區塊

函式庫目錄：style/$MOTION_STYLE/remotion/CATALOG.md（每個套件組件）和 $MOTION_LIB/core/audio/CATALOG.md（每個音效和背景音樂）。它們是自動生成的，所以新檢出的專案可能缺少它們或內容過時。執行 python3 $MOTION_LIB/core/tools/catalog.py 來重新建構。代理應讀取目錄，而不是套件源碼。

先重複使用再撰寫：套件組件、道具組或場景模板勝過新的繪圖程式碼。按名稱選擇音效和背景音樂。

安裝模式

最小化（僅技能）：策略、鉤子、腳本、分鏡、風格提示。無渲染。
標準：最小化 + 透過 $MOTION_LIB/core/tools/placeholder_vo.py 使用佔位語音（靜音或 macOS say）進行建置和渲染、靜止圖 QA、音效和背景音樂音訊、完整 mp4。
完整：標準 + 本地 Qwen3-TTS 語音和來自真實音訊的逐字字幕。

探測（唯讀）：

. "$(grep '^MOTION_LIB=' "${XDG_CONFIG_HOME:-$HOME/.config}/motion-explainer/config.env" | cut -d= -f2-)/env.sh"   # 填入 MOTION_PY, QWEN_TTS_PY
node -v; ffmpeg -version | head -1
"$MOTION_PY" -c 'import numpy, PIL, soundfile'
"$QWEN_TTS_PY" -c 'import qwen_tts'

前三行通過即表示標準。qwen_tts 導入也通過則表示完整。如果某個階段需要的資源超出安裝提供的範圍，用一行話說明，從儲存庫根目錄執行 ./install.sh --doctor，然後交給 motion-setup，而不是自行解決。使用 readlink 在已安裝的技能資料夾（位於 .claude/skills、.agents/skills、.config/opencode/skills 或其他框架的技能資料夾下）或設定檔中的 MOTION_HOME 來找到根目錄。

跨階段規則

策略註記優先於風格註記：22-30 秒，且不使用新聞框架的鉤子。
一次性地並行化獨立工作（場景組、背景和道具、重新渲染）給多個代理。
僅在被要求時才渲染。在 Remotion Studio 中預覽。

共享參考

$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md：風格 DNA，紙片剪貼繪圖，調色板，字體，紋理，攝影機與抖動，動作時間，字幕，音效。
$MOTION_LIB/style/$MOTION_STYLE/docs/style-prompt.md：可攜帶到其他代理和生成器的提示。
$MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md：將 12 個動畫原則映射到套件組件和輔助工具，並附有每個階段的使用說明。
$MOTION_LIB/style/$MOTION_STYLE/remotion/RECIPES.md：Remotion 組件草稿，用於當沒有函式庫時。
$MOTION_LIB/style/$MOTION_STYLE/docs/asset-prompts.md：哪些該生成、哪些該用程式碼建構，附有提示模板。
$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md：一個約 28 秒的已完成範例，解析度為 0.2 秒。複製其事件密度，而不是其內容。

交接

從階段 1 開始進行完整影片，或從執行模式指定的階段開始。資訊收集後，執行 motion-strategy；它讀取 SERIES.md 和 BRIEF，然後交接給 motion-hook。每個階段技能都會指出下一個技能。

紙片動畫解說員