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 個最合適的分類,從 16 個正式分類中挑選:
3D·Isometrik·Bongkar Rumah·Stickman 3D·Astronomi·Dunia Hewan·Laut·Sains & Alam·Sejarah·Peta·Islami·Geografi·Anatomi·Cerita Rakyat·Kartun·Animasi 2D。 - 擬定具體的視覺建議:
- 物體與道具 (
objek): 主要主題(需具紋理/關節)+ 至少 3 個用於比例比較或證據的輔助道具。 - 鏡頭與轉場 (
kamera): 多鏡頭模式(wide→close-up細節 →orbit/whipTo/pull-back)。 - 氛圍與燈光 (
suasana): 天空/空間氛圍、霧/體積光、色調及敘事語氣。
- 物體與道具 (
- 編寫階段式劇本 (
0到DUR秒,不留空白):- 第一部分必須是
HOOK(3–10 秒的開場,激起好奇心)。 - 接著是
ADEGAN 1、ADEGAN 2,最後以強而有力的事實結論作結(約每秒 2.2 個詞)。 - 若時長較長(超過 60 秒至
600秒 / 10 分鐘),請閱讀 長篇幅 10 分鐘指南。
- 第一部分必須是
步驟 2 — 閱讀分類食譜與黃金範例程式碼(必要!)
請勿憑空猜測 sceneCode! 在編寫動畫程式碼之前:
- 閱讀 16 分類目錄 中的分類表與
styleID,以及 引擎 v4 API 參考 (MF) 中的執行階段函式清單。 - 閱讀 黃金範例參考程式碼 中與你的需求最接近的官方原始碼範例。
- 品質等同法則: 物體密度、紋理細節(
CanvasTexture/ 多層 SVG /world-atlas海岸線 / GLSL 著色器)、燈光及鏡頭流暢度必須等同於golden-showcases.md中的範例。禁止繪製無紋理或無道具的單純方形/圓形!
步驟 3 — 黃金法則:編寫 sceneCode
sceneCode 會被執行為函式 (MF, stage, tl, W, H, DUR) 的內容:
- 雙響應式設計 (
9:16Shorts &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(若使用地圖),然後產生:
<slug>.html— 1 個獨立檔案,可在任何瀏覽器中觀看(自動循環 + 進度條 +9:16↔16:9切換按鈕 + WebAudio 音效)。<slug>-source.zip— 完整的原始碼壓縮檔(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。<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 重新建置,然後將結果提交給使用者。