모션 구현
개요
이 스킬은 Figma 애니메이션과 전환을 실행 가능한 코드(motion.dev, CSS 키프레임 또는 프레임워크별 라이브러리)로 변환하는 과정을 안내합니다.
Figma는 두 가지 도구를 통해 모션을 제공합니다:
get_motion_context— 권위 있는 모션 도구입니다. 완전한 애니메이션 노드 인벤토리, 미리 계산된 코드 스니펫(CSS@keyframes+ motion.dev), 스니펫을 사용할 수 없는 경우의 폴백 키프레임 바인딩, 그리고 재귀적 타임라인 조정 힌트(timelineCohorts)를 반환합니다. 애니메이션 데이터와 어떤 노드 ID가 애니메이션되는지에 대한 진실 공급원(source of truth)입니다.get_design_context— 디자인의 구조: 레이아웃, 크기 조정, 에셋, 스타일링, Code Connect 힌트, 스크린샷 컨텍스트, 그리고 때로는 애니메이션 요소에 대한 모션 배치 마커(data-node-id, 분할 노드의 경우data-motion-keys/data-motion-wrapper-for/data-motion-transform-template)를 제공합니다. 애니메이션 노드를 일반 요소(div,p,span등) 또는 모션 요소(motion.div)로 렌더링할 수 있습니다. 애니메이션 값은 인라인으로 포함하지 않습니다.
두 도구는 노드 ID로 연결되며, 이것이 전체 워크플로우입니다. get_motion_context는 어떤 노드가 애니메이션되는지 알려주고 키프레임 값, 이징, 타이밍 및 스니펫을 제공합니다. get_design_context는 해당 노드가 어떻게 보이고 어디에 위치하는지 알려줍니다. get_motion_context.nodes의 모든 노드에 대해 디자인 컨텍스트에서 일치하는 data-node-id를 찾아 모션을 해당 구조에 병합합니다. 구조적 요소가 일반 요소인 경우 motion.{tag}를 추가하거나 래핑합니다. 디자인 컨텍스트가 Figma 컴포넌트를 재사용한 경우 모션 노드에는 fallbackNodeId도 포함될 수 있습니다. 정확한 nodeId를 먼저 시도한 후에만 폴백으로 사용하십시오.
스킬 경계
- 사용자 저장소에 모션 코드를 제공하는 것이 결과물일 때 이 스킬을 사용하십시오.
- 사용자가 Figma 자체 내에서 애니메이션을 만들거나 편집하도록 요청하는 경우, figma-use로 전환하여 해당 스킬을 따르십시오.
- 이 스킬은 현재
get_motion_context가 내보내는 애니메이션(스니펫과 폴백 키프레임 트랙, 프리셋으로 작성된 모션을 해당 형태로 해결한 것을 포함)을 다룹니다. 더 광범위한 대화형 변형 플로우는 코드에서 제품별 상태 처리가 여전히 필요할 수 있습니다.
전제 조건
- Figma MCP 서버가 연결되어 있고 접근 가능해야 합니다.
- 사용자가 제공한 Figma URL에서 파싱된 노드 ID. URL 형식:
https://figma.com/design/:fileKey/:fileName?node-id=1-2—fileKey(/design/다음 세그먼트)와nodeId(node-id쿼리 매개변수의 값, 예:42-15)를 추출합니다. - 대상 코드베이스. 모션 출력 형식은 스택에 맞게 조정됩니다(프레임워크 권장 사항 참조).
도구 선택
모션 구현을 위해 두 도구를 각각 다른 역할로 사용하십시오:
| 상황 | 도구 | 이유 |
|---|---|---|
| 정적 구조, 에셋, 스타일, Code Connect 또는 시각적 레이아웃 이해 | get_design_context | 애니메이션 노드를 올바르게 배치하는 데 필요한 컴포넌트/페이지 코드 참조 및 에셋 URL을 제공합니다. |
| 모든 노드의 애니메이션 데이터 가져오기 | get_motion_context | 모션 전용으로 제작되었으며 타이밍, 이징, 스니펫 및 키프레임에 대한 진실 공급원입니다. |
노드에 모션 마커(data-motion-keys, data-motion-wrapper-for)가 있음 | 배치를 위한 마커는 분할, get_motion_context는 값을 위한 것 | 분할 마커는 어떤 트랙이 어떤 요소에 적용되는지 알려줍니다. 키프레임/이징/타이밍 및 애니메이션 노드 인벤토리는 get_motion_context에서 가져옵니다. |
get_motion_context는 한 번의 호출로 하위 요소의 모션이 필요할 때 recursive: true(최대 500개 노드로 제한)를 허용합니다.
필수 워크플로우
1단계: 정적 디자인 컨텍스트 사용 가능 여부 확인
get_design_context(fileKey=":fileKey", nodeId="<node-id>")
이 노드에 대해 get_design_context가 이미 호출된 경우 해당 출력을 재사용하십시오. 그렇지 않은 경우 지금 정상적으로 호출하십시오.
이를 기록 구조로 사용하십시오 — 계층, 크기 조정, 스타일링, 에셋, Code Connect 힌트, 스크린샷 컨텍스트 및 포함될 수 있는 모든 모션 배치 마커(3단계). 애니메이션 노드 인벤토리 및 애니메이션 값은 get_motion_context(2단계)에서 가져옵니다.
2단계: 권위 있는 모션 데이터 가져오기
get_motion_context(fileKey=":fileKey", nodeId="<node-id>", recursive=true)
응답 형태(애니메이션 노드당 하나의 항목):
codeSnippets— 사전 생성된 CSS@keyframes및 motion.dev 문자열입니다. 이것들을 직접 사용하십시오. 폴백 트랙 데이터에서 다시 생성하지 마십시오.keyframeBindings— 바인딩된 키프레임 트랙. 프리셋에서 파생된 모션이 트랙 데이터로 해결된 것을 포함하며, 두 스니펫 형식이 모두 누락된 경우에만 폴백 데이터로 포함됩니다.motionSummary— 애니메이션의 한 줄짜리 자연어 설명입니다. 스니펫이 없을 때만 제공됩니다(키프레임 바인딩 전용 모션 코드 생성이 CSS/motion.dev로 표현할 수 없는 경우). 있을 때 빌드에 사용하고, 스니펫이 있으면 무시하십시오.fallbackNodeId— 컴포넌트화된 디자인 컨텍스트 매칭을 위한 선택적 폴백 ID입니다.nodeId가I4005:6111;30:8005와 같은 인스턴스 한정 ID인 경우, D2R은 재사용 가능한 컴포넌트 본문을 대신 백업 컴포넌트 ID(예:4002:3957)로 렌더링할 수 있습니다. 이 경우fallbackNodeId는 정확한nodeId조회가 실패할 경우 찾을data-node-id입니다.
재귀 응답에는 timelineCohorts도 포함됩니다. 이는 하나의 타임라인을 공유하는 노드들의 최상위 배열(노드별 아님)입니다: { rootNodeId, durationMs, loopMode: 'once' | 'loop' | 'boomerang', memberNodeIds[] }. 조정된 다중 노드 모션의 경우, durationMs(초로 변환하려면 ÷1000)와 loopMode를 사용하여 모든 memberNodeIds를 하나의 공유 수명 주기로 구동하십시오. 형제 순서에서 타이밍을 유추하지 마십시오.
LLM에 중요한 구현 세부 사항:
- 스니펫이 존재하는 경우, 페이로드를 줄이기 위해
motionSummary,timelineDurationMs및transformOrigin이 생략될 수 있습니다. 스니펫에는 이미 duration + transform-origin(motion.devduration/style={{ transformOrigin }}또는 CSSanimation/transform-origin)이 포함되어 있고 코호트에는durationMs가 포함되어 있습니다. 누락된 필드가