MotionCraft — 애니메이션 설명 동영상 및 쇼츠 16개 카테고리를 위한 범용 에이전트 스킬
독립형 스킬(제로 앱 의존성)으로, 1문장짜리 스토리 아이디어를 시각적 방향 추천, 단계별 대본(HOOK → 장면 1 → 장면 2 → ... 최대 10분), 독립형 <슬러그>.html 파일(더블 클릭으로 브라우저에서 바로 실행, 9:16 ↔ 16:9 종횡비 전환 버튼 및 WebAudio SFX 포함), 소스 코드 패키지 <슬러그>-source.zip, 그리고 .mp4 비디오 렌더링으로 변환합니다.
필수 작업 흐름 (5단계)
1단계 — 시각적 추천 및 대본 계획 (HOOK → 장면 1..N)
사용자가 스토리 아이디어를 제공하면 (종횡비나 시간이 명시되지 않은 경우, 짧은 사실 설명에는 기본값 9:16 쇼츠 30–45초, 심층 논의에는 16:9 비디오 60–600초 사용):
- 16개 공식 카테고리 중 가장 적합한 1개 카테고리 선택:
3D·아이소메트릭·하우스 디스어셈블리·3D 스틱맨·천문학·동물의 왕국·해양·과학 & 자연·역사·지도·이슬람·지리·해부학·민담·만화·2D 애니메이션. - 구체적인 시각적 추천 수립:
- 객체 및 소품 (
objek): 질감/관절이 있는 주요 주제 + 최소 3개의 크기 비교/증거용 소품. - 카메라 및 전환 (
kamera): 멀티 샷 패턴 (와이드→클로즈업디테일 →오빗/whipTo/pull-back). - 분위기 및 조명 (
suasana): 하늘/공간 분위기, 안개/볼류메트릭 라이트, 색상 팔레트, 내레이션 톤.
- 객체 및 소품 (
- 단계별 대본 작성 (
0초부터DUR초까지 빈틈없이) :- 첫 부분은 반드시
HOOK이어야 함 (호기심을 유발하는 3~10초 오프닝). - 그 다음
장면 1,장면 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:16쇼츠 &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, -대본.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": "장면 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
],
"sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}
그런 다음 독립형 빌드 스크립트(순수 내장 Node.js, npm 의존성 0개!)를 실행합니다:
node "<스킬-경로>/scripts/build.mjs" --spec path/to/spec.json --out-dir path/to/output
이 스크립트는 sceneCode의 구문과 결정론을 검증하고, ./assets/motion-engine.js, ./assets/sfx-synth.mjs 및 (지도를 사용하는 경우) ./assets/land-110m.json을 임베드한 후 다음을 생성합니다:
<슬러그>.html— 모든 브라우저에서 볼 수 있는 독립형 파일 1개 (자동 루프 + 스크러브 바 +9:16↔16:9전환 버튼 + WebAudio SFX).<슬러그>-source.zip— 전체 소스 코드 아카이브 (index.html,src/scene.js,src/project.json,대본-및-스토리보드.md,engine/).<슬러그>-대본.md— 깔끔한 대본 및 시각적 추천 문서.
셸/웹 채팅 없는 경우: 에이전트 환경에 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/to/output/<슬러그>.html --verify-only
# 전체 MP4 비디오로 렌더링 (H.264 + AAC SFX 자동, 선택 사항 --vo narration.mp3):
node "<스킬-경로>/scripts/export-mp4.mjs" --html path/to/output/<슬러그>.html --fps 30 --scale 1
확인 스크린샷에서 오류나 텍스트 겹침이 발견되면 sceneCode를 수정하고 scripts/build.mjs로 다시 빌드한 후 결과를 사용자에게 제출하세요.