MotionCraft — 16カテゴリの動画解説&Shortsを生成するユニバーサルエージェントスキル
ゼロ依存のスタンドアロンスキル。たった1文のアイデアから、ビジュアル方向性の推奨、段階的スクリプト(HOOK → ADEGAN 1 → ADEGAN 2 → …(最大10分))、スタンドアロンHTMLファイル <slug>.html(ダブルクリックでブラウザで動作、9:16 ↔ 16:9 切り替えボタン、WebAudio SFX対応)、ソースコードZIP <slug>-source.zip、そしてMP4動画レンダリングを生成します。
必須ワークフロー(5ステップ)
ステップ 1 — ビジュアル推奨とスクリプト計画(HOOK → ADEGAN 1..N)
ユーザーがアイデアを提供したら(アスペクト比や長さが指定されていない場合、簡潔なファクトの場合はデフォルトで 9:16 Shorts 30–45秒、深い議論の場合は 16:9 動画 60–600秒 を使用):
-
16の公式カテゴリから最も適切なものを1つ選択:
3D·アイソメトリック·家の解体·スティックマン3D·天文学·動物·海·科学と自然·歴史·地図·イスラム·地理·解剖学·民話·漫画·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上のトゥイーン、時間tの純粋関数としてのMF.onTick((t) => ...)を使用してください。 - フレーム0からすぐに表示:
HOOKのステージ要素とオープニングタイトルは、最初のフレームが空白/暗くならないようにat: 0を使用する必要があります。 - アンチPPT:同時に表示するのは最大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組み込みモジュールのみ、npm 依存関係ゼロ!)を実行します:
node "<スキルへのパス>/scripts/build.mjs" --spec path/ke/spec.json --out-dir path/tujuan
このスクリプトは sceneCode の構文と決定論を検証し、./assets/motion-engine.js、./assets/sfx-synth.mjs、および(地図を使用する場合は)./assets/land-110m.json を埋め込み、以下を生成します:
<slug>.html— 任意のブラウザで視聴可能なスタンドアロンファイル(自動ループ + スクラブバー +9:16↔16:9切り替えボタン + WebAudio SFX)。<slug>-source.zip— 完全なソースコードアーカイブ(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。<slug>-naskah.md— スクリプトとビジュアル推奨のドキュメント。
シェル/Webチャットがない場合のフォールバック:エージェント環境にNode.jsターミナルへのアクセスがない場合は、
./assets/starter-template.htmlの内容をコピーし、プレースホルダー/*__MOTION_ENGINE__*/、/*__SFX_SYNTH__*/、/*__PROJECT_JSON__*/ nullを直接置き換えて、完全なindex.htmlファイルを生成してください。
ステップ 5 — フレーム検証とMP4動画エクスポート(オプション / ヘッドレスブラウザが利用可能な場合)
環境にChrome/Edge + puppeteer-core(または puppeteer)がある場合は、自動検証を実行してランタイムエラーが 0 であることを確認し、スクリーンショットをチェックします:
# クイック検証(0エラーチェック + HOOKと中間のスクリーンショット保存):
node "<スキルへのパス>/scripts/export-mp4.mjs" --html path/tujuan/<slug>.html --verify-only
# 完全MP4動画へのレンダリング(H.264 + AAC SFX自動、オプションで --vo ナレーション.mp3):
node "<スキルへのパス>/scripts/export-mp4.mjs" --html path/tujuan/<slug>.html --fps 30 --scale 1
検証スクリーンショットでエラーやテキストの重なりが見つかった場合は、sceneCode を修正し、scripts/build.mjs で再ビルドしてから、結果をユーザーに提供してください。