Communitygithub.com

MotionCraft — 通用 AI 代理技能:16 種類別解說影片與 Shorts 生成器

將一句故事靈感轉化為程式碼驅動的電影級動畫解說影片與 Shorts(9:16 直式與 16:9 橫式,時長 15 秒至 10 分鐘),涵蓋 3D、等角透視、解剖圖、地圖動畫等 16 種工作室等級視覺類別。

MotionCraft — 通用 AI 代理技能:16 種類別解說影片與 Shorts 生成器 是什麼?

MotionCraft 是一個專為 AI 代理(如 Claude Code、Cursor 等)設計的獨立技能,無需任何外部應用程式依賴。它能將使用者提供的單一故事點子,自動產生完整的視覺方向建議、分階段劇本(從 Hook 到各場景)、一個可直接在瀏覽器中執行的獨立 HTML 檔案(含 9:16 ↔ 16:9 比例切換按鈕與 WebAudio 音效)、一份完整的原始碼 ZIP 壓縮檔,以及可選的確定性 MP4 影片渲染。此技能支援 16 種正式視覺類別,包括 3D、等角透視、3D 火柴人、天文學(GLSL 黑洞)、動物世界、3D 海洋、科學與自然、歷史、地圖(Natural Earth d3-geo)、伊斯蘭、地理、解剖學、民間傳說、卡通及 2D 動畫。其核心工作流程分為五個強制步驟:先根據故事點子推薦最佳類別與視覺方案;接著參考內建的金屬標準範例程式碼與引擎 API,確保動畫品質;再以嚴格規則撰寫場景程式碼(如強制雙響應式設計、避免使用亂數);然後透過純 Node.js 建置腳本產出獨立檔案;最後可進行自動化驗證並轉檔為 MP4。此工具特別適合製作教育 Shorts、產品解說、3D 模擬、歷史/地理地圖動畫、解剖學展示或任何需要電影級分鏡腳本的影片。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

在你喜歡的 AI 中提問

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

說明文件

MotionCraft — Universal Agent Skill 用於解說影片與 16 種分類 Shorts

獨立技能(零應用程式依賴),能將一句故事靈感轉化為 視覺方向建議、分階段劇本 (HOOK → ADEGAN 1 → ADEGAN 2 → 直到 10 分鐘)、獨立 <slug>.html 檔案(雙擊即可在瀏覽器中執行,內含 9:16 ↔ 16:9 比例切換按鈕與 WebAudio 音效)、原始碼套件 <slug>-source.zip 以及 渲染的 .mp4 影片。


強制工作流程(5 步驟)

步驟 1 — 視覺建議與劇本計畫 (HOOK → ADEGAN 1..N)

當使用者提供故事點子時(若未指定比例或時長,短篇事實預設為 9:16 Shorts 30–45 秒,深度內容預設為 16:9 影片 60–600 秒):

  1. 選擇 1 個最合適的分類,從 16 個正式分類中挑選: 3D · Isometrik · Bongkar Rumah · Stickman 3D · Astronomi · Dunia Hewan · Laut · Sains & Alam · Sejarah · Peta · Islami · Geografi · Anatomi · Cerita Rakyat · Kartun · Animasi 2D。
  2. 擬定具體的視覺建議:
    • 物體與道具 (objek): 主要主題(需具紋理/關節)+ 至少 3 個用於比例比較或證據的輔助道具。
    • 鏡頭與轉場 (kamera): 多鏡頭模式(wide → close-up 細節 → orbit / whipTo / pull-back)。
    • 氛圍與燈光 (suasana): 天空/空間氛圍、霧/體積光、色調及敘事語氣。
  3. 編寫階段式劇本 (0 到 DUR 秒,不留空白):
    • 第一部分必須是 HOOK(3–10 秒的開場,激起好奇心)。
    • 接著是 ADEGAN 1、ADEGAN 2,最後以強而有力的事實結論作結(約每秒 2.2 個詞)。
    • 若時長較長(超過 60 秒至 600 秒 / 10 分鐘),請閱讀 長篇幅 10 分鐘指南。

步驟 2 — 閱讀分類食譜與黃金範例程式碼(必要!)

請勿憑空猜測 sceneCode! 在編寫動畫程式碼之前:

  1. 閱讀 16 分類目錄 中的分類表與 style ID,以及 引擎 v4 API 參考 (MF) 中的執行階段函式清單。
  2. 閱讀 黃金範例參考程式碼 中與你的需求最接近的官方原始碼範例。
  3. 品質等同法則: 物體密度、紋理細節(CanvasTexture / 多層 SVG / world-atlas 海岸線 / GLSL 著色器)、燈光及鏡頭流暢度必須等同於 golden-showcases.md 中的範例。禁止繪製無紋理或無道具的單純方形/圓形!

步驟 3 — 黃金法則:編寫 sceneCode

sceneCode 會被執行為函式 (MF, stage, tl, W, H, DUR) 的內容:

  • 雙響應式設計 (9:16 Shorts & 16:9 影片): 始終使用 W 和 H 的比例(W * 0.5、H * 0.45、size: W < H ? 50 : 56、labelX: W < H ? W * 0.08 : W * 0.54),確保動畫在 1080×1920 或 1920×1080 下都能完整顯示而不被裁切。
  • **請勿覆蓋變數 H: ** 永遠不要寫 const { H } = MF;,因為這會覆蓋舞台的高度 H!一律透過前綴 MF. 呼叫(MF.H、MF.S、MF.T)。
  • 100% 確定性: 禁止使用 Math.random()、Date.now()、setTimeout 或 setInterval。請改用 MF.rng('固定種子')、tl 上的 tween 以及 MF.onTick((t) => ...) 作為時間 t 的純函數。
  • 第 0 幀直接活躍: HOOK 的舞台元素與開場標題必須使用 at: 0,確保第一幀不為空白或黑色。
  • 反簡報風格: 同一時間最多 1 行標題(MF.highlightHeadline)+ 1 個重點提示/數字(MF.leaderCallout / MF.bigStat)。故事必須透過物件/世界的動態變化與鏡頭運動來傳達,而非一連串的文字卡片!

步驟 4 — 組裝獨立檔案(.html、-source.zip、-naskah.md)

建立 JSON 規格檔案(例如 spec.json):

{
  "title": "影片標題",
  "idea": "使用者原始故事點子",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objek": "...",
    "kamera": "...",
    "suasana": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "ADEGAN 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

然後執行獨立的建置腳本(僅使用內建 Node.js,0 個 npm 依賴!):

node "<路徑到技能目錄>/scripts/build.mjs" --spec 路徑/到/spec.json --out-dir 輸出目錄

此腳本會驗證 sceneCode 的語法與確定性,嵌入 ./assets/motion-engine.js、./assets/sfx-synth.mjs,以及 ./assets/land-110m.json(若使用地圖),然後產生:

  1. <slug>.html — 1 個獨立檔案,可在任何瀏覽器中觀看(自動循環 + 進度條 + 9:16 ↔ 16:9 切換按鈕 + WebAudio 音效)。
  2. <slug>-source.zip — 完整的原始碼壓縮檔(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。
  3. <slug>-naskah.md — 整潔的劇本與視覺建議文件。

無 Shell / Web Chat 的備用方案: 若代理環境無法使用 Node.js 終端機,請直接複製 ./assets/starter-template.html 的內容,並將佔位符 /*__MOTION_ENGINE__*/、/*__SFX_SYNTH__*/ 及 /*__PROJECT_JSON__*/ null 替換掉,以產生完整的 index.html 檔案。

步驟 5 — 畫面驗證與 MP4 影片匯出(可選 / 當具備 Headless 瀏覽器時)

若環境中有 Chrome/Edge 及 puppeteer-core(或 puppeteer),請執行自動化驗證以確保 0 個執行時期錯誤並檢查畫面截圖結果:

# 快速驗證(檢查 0 錯誤 + 儲存 HOOK 與中間畫面截圖):
node "<路徑到技能目錄>/scripts/export-mp4.mjs" --html 輸出目錄/<slug>.html --verify-only

# 完整渲染為 MP4 影片(自動 H.264 + AAC 音效,可選新增 --vo narration.mp3):
node "<路徑到技能目錄>/scripts/export-mp4.mjs" --html 輸出目錄/<slug>.html --fps 30 --scale 1

若在驗證截圖中發現錯誤或文字重疊,請修正 sceneCode,使用 scripts/build.mjs 重新建置,然後將結果提交給使用者。

相關技能