Motion Agent 모범 사례
Motion Agent 작업의 라우팅 계층으로 사용하세요. 심층적인 AE 실행 계약은 여전히 저장소의 skill/SKILL.md에 있습니다. After Effects를 다루기 전에 반드시 읽으세요.
핵심 원칙
Motion Agent를 "JSX를 생성하고 희망하는" 방식으로 취급하지 마세요. 생산 워크플로우로 취급하세요:
- 브리핑, 참조 자료, 제품 및 전달 컨텍스트를 이해합니다.
- 적절한 워크플로우 스킬을 선택합니다.
- 일회용 레이어가 아닌 편집 가능한 AE 구조를 구축합니다.
- 캡처된 프레임, 샘플링된 값 및 구체적인 증거로 검증합니다.
- 재사용 가능한 패턴을 케이스 또는 스킬로 승격합니다.
스킬 라우팅
| 사용자 요청 | 로드 |
|---|---|
| 새 비디오, 쇼트, 애니메이션 또는 컴포지션 | motion-create |
| 런치 비디오, 캠페인 필름, 제품 발표, 소셜 프로모션 | motion-promo-video |
| UI 애니메이션, 제품 데모, 대시보드 플로우, 카드/슬라이더/스크린 모션 | motion-ui-demo |
| 재사용 가능한 AE 컨트롤, 표현식, 리그, 프리셋, 컴포넌트화된 모션 | motion-ae-rig |
| 검토, 폴리싱, 비교, 디버그, 검증, 참조 일치 확인 | motion-qa |
| 렌더링, 내보내기, 미리보기 캡처, 전달 패키징 | motion-render |
| 저장소 문서, 예제, 케이스 레시피, AE 기초 찾기 | motion-docs |
작업이 여러 영역에 걸쳐 있는 경우 가장 작은 유용한 세트를 로드하세요. 예를 들어, 제품 런치 데모는 일반적으로 motion-promo-video, motion-ui-demo, motion-ae-rig 및 motion-qa가 필요합니다.
AE 편집 전
저장소의 원본 skill/SKILL.md를 읽고 사전 점검 목록을 실행하세요. 특히 다음을 수행하세요:
- JSX에는
ae_scripts/tools/run_jsx.sh를 사용합니다. - AE의 ES3 ExtendScript 제한 사항을 준수합니다.
- 표시 이름을 추측하는 대신 효과
matchName을 조회합니다. - 스크립트 배치당 하나의 논리적 변경만 유지합니다.
- 사용자 변경 사항과 기존 컨트롤러 값을 보존합니다.
생산 계약
모든 Motion Agent 결과는 다음을 남겨야 합니다:
- 편집 가능한 AE 프로젝트 구조
- 반복 조정을 위한 명명된 컨트롤
- 미리보기 증거
- 무엇이 변경되었고 무엇이 검증되었는지 설명하는 짧은 노트
- 패턴이 반복될 가능성이 있는 경우 재사용 가능한 스크립트 또는 케이스 노트
편집 가능한 출력 규칙
- 레이어, 프리컴프, 컨트롤, 마커 및 출력 파일을 사람을 위해 명명합니다.
- 사용자 대면 컨트롤은 명확한
AI_Controls또는 작업별 컨트롤 레이어에 배치합니다. - 표현식을 읽기 쉽게 유지하고 지역화합니다. 전체 재작성보다 정밀한 편집을 선호합니다.
- 숨겨진 마법을 피합니다: 타이밍이나 레이아웃이 생성된 경우 중요한 조정 변수를 노출합니다.
- 사용자가 명시적으로 최종 전용 출력을 원하지 않는 한 모든 것을 베이크된 키프레임으로 축소하지 마십시오.
검증 규칙
"완료"라고 말하기 전에 증거를 수집하세요:
- 대표 프레임을 캡처합니다.
- 변경된 레이어, 표현식 또는 컨트롤러 값을 검사합니다.
- 모션 품질이 중요한 경우 타이밍/이징을 샘플링합니다.
- 텍스트 경계, 로고 가독성 및 컴포지션 안전 영역을 확인합니다.
- 검증되지 않은 가정을 기록합니다.
패턴 승격
워크플로우가 반복되는 경우 채팅에 묻어두지 마십시오:
cases/<category>/<case>/아래에 케이스를 추가하거나 업데이트합니다.RECIPE.md, 재사용 가능한 JSX 및 전후 증거를 저장합니다.- 규칙이 광범위하게 유용한 경우 축약 버전을
skill/SKILL.md또는 이러한 에이전트 스킬 중 하나로 승격합니다. - 저장소 워크플로우에 따라 동기화하고 커밋합니다.