HyperFrames 진입점
HyperFrames는 HTML로 비디오를 렌더링합니다. 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임을 탐색할 수 있으며, 미디어 재생을 프레임워크가 소유하는 HTML 파일입니다. 전체 제작 규약은 /hyperframes-core에 있습니다. 컴포지션 HTML을 작성하기 전에 이를 읽으십시오. 브리프, 스토리보드, 리뷰, 제작, 디스패치 및 프레임 워커 규약은 이 스킬의 references/ 디렉토리에 있습니다.
1. 프로젝트 상태에서 시작
일치하는 첫 번째 행을 적용하고, 하위 상태 행은 평가하지 마십시오:
| 상태 | 작업 |
|---|---|
| 기존 Remotion 소스를 HyperFrames로 명시적으로 포팅 | references/routes/remotion-to-hyperframes.md를 읽은 후 해당 워크플로우로 직접 라우팅합니다. 의도 레이어를 건너뜁니다. |
| 기존 HyperFrames 프로젝트에 대한 특정 작업: 검사, 진단, 검증, 미리보기, 렌더링, 게시 또는 배치 렌더링 | 해당 작업만 수행합니다. 의도 및 워크플로우 라우팅을 건너뜁니다. /hyperframes-cli 및 필요한 도메인 스킬을 로드합니다. |
| 기존 프로젝트에 대한 특정 편집 | 편집을 수행합니다. 의도 레이어를 실행하지 마십시오. 프로젝트 타임라인(트랙, 클립, 시작, 종료, 재생 내용)을 확인하려면 index.html 및 모든 하위 컴포지션 파일을 읽는 대신 npx hyperframes timeline [--json]을 실행하십시오. |
BRIEF.md가 존재함 | workflow 및 flow를 읽습니다. 해당 워크플로우를 실행합니다. flow: companion은 항상 /general-video에서 실행됩니다. 브리프 질문을 하지 마십시오. |
브리프는 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함 | 프로젝트 파일 및 기록된 선호도에서 재개합니다. 기존 아티팩트에서 소유 워크플로우를 유추합니다. 고유하게 결정할 수 없는 경우 라우팅 전용 질문을 하나만 하고, 의도 인터뷰를 실행하지 마십시오. |
| 새로 생성 | 의도 레이어(references/intent-interview.md)를 실행한 후 § 2의 표를 사용하여 한 번 라우팅합니다. |
새 요청이 주제나 입력을 식별하지 못하는 경우, 라우팅하기 전에 비디오가 무엇에 관한 것인지 물어보십시오. 질문하기 전에 기본 설정과 레시피를 확인하십시오(references/intent-interview.md, 1단계). figma.com 입력 또는 명명된 레시피는 인테이크를 변경할 뿐 라우팅은 변경하지 않습니다. 인터뷰의 "직교 입력 적용" 섹션이 둘 다 처리합니다.
프로젝트의 CLI를 최신 상태로 유지
스캐폴딩된 프로젝트는 package.json 스크립트에 hyperframes@<버전>을 고정하여 렌더링이 재현 가능하도록 합니다. 이 고정은 자체적으로 업데이트되지 않으며, 이전 CLI의 고정된 실행은 이에 대해 경고를 출력하지 않습니다. 스크립트에 고정이 있는 프로젝트를 재개할 때, 첫 번째 렌더링 영향 명령 전에 한 번 검사하십시오:
npx hyperframes@latest upgrade --project . --check
이 검사는 읽기 전용이며 고정된 버전과 최신 릴리스를 비교합니다. 명시적인 .를 유지하십시오. 이전 CLI 릴리스에서 --project 뒤에 다른 플래그가 오면 해당 플래그를 디렉토리 값으로 사용합니다. 프로젝트가 뒤쳐졌다고 보고하거나(또는 CLI 출력에 이미 표시된 경우, stderr 알림 이 프로젝트는 hyperframes@…(최신 …)을 고정합니다 또는 고정된 스크립트의 --json 결과에서 _meta.updateAvailable: true) npx hyperframes@latest upgrade --project .를 적용한 후 npx hyperframes check로 확인하십시오. 통과된 확인은 프로젝트의 컴포지션이 새 버전에서 여전히 유효함을 확인합니다(렌더링 출력이 이전 고정과 프레임이 동일함을 의미하지는 않음). 따라서 성공적인 업데이트는 절대 조용히 이루어지지 않습니다. 실행 요약에 이전 및 새 버전을 명시하십시오. 아직 컴포지션이 없는 프로젝트는 확인이 필요하지 않습니다. 확인에 실패하면 package.json 변경을 되돌리고, 고정된 버전을 계속 사용하며, 프로젝트가 어떤 버전에 남아 있고 그 이유를 보고하십시오. 신호를 사용자에게 전달하지 말고 신호에 따라 행동하십시오. 업데이트된 고정을 확인되지 않은 상태로 두지 마십시오.
2. 새 생성 라우팅
첫 번째 일치하는 행을 사용하십시오. 요청된 결과물을 일치시키고, 지나가는 말로 언급된 단어나 파일 형식이 아닙니다.
| 우선순위 | 요청 | 워크플로우 |
|---|---|---|
| 1 | 기존 Remotion 소스를 명시적으로 포팅 | /remotion-to-hyperframes |
| 2 | 프레젠테이션, 피치 데크 또는 탐색 가능한 인터랙티브 데크 제작 | /slideshow |
| 3 | 기존 토킹헤드 영상에 일반 자막 또는 자막 추가(영상 변경 없이) | /embedded-captions |
| 4 | 기존 토킹헤드, 인터뷰 또는 팟캐스트 영상에 디자인된 그래픽 오버레이 추가(영상 변경 없이) | /talking-head-recut |
| 5 | 음악 트랙에서 비트 동기화 비디오 제작(내레이션 또는 웹사이트 캡처 없이) | /music-to-video |
| 6 | 명시적으로 짧고, 내레이션이 없으며, 모션 중심의 단위(일반적으로 10초 미만) 생성 | /motion-graphics |
| 7 | PR 참조에서 GitHub 풀 리퀘스트 또는 코드 변경 설명 | /pr-to-video |
| 8 | URL 또는 사이트별 브리프에서 웹사이트, 제품 사이트, 앱 또는 회사 마케팅 또는 홍보 | /product-launch-video |
| 9 | 발명된 시각 자료와 제품 또는 사이트 캡처 없이 주제, 기사 또는 노트 설명 | /faceless-explainer |
| 10 | 기타 모든 사용자 정의 비디오 또는 컴포지션 | /general-video |
라우팅을 최종 확정하기 전에 references/routes/<워크플로우>.md를 읽으십시오. 각 경로당 하나의 작은 파일: 지연 설치 워크플로우 스킬이 있기 전에 사용 가능한 정식 입력/출력/트리거 규약과 해당 경로의 인터뷰 항목입니다. 후보가 해당 규약을 충족하지 않으면 강제로 일치시키는 대신 계속 라우팅하십시오. 일치하는 경로의 파일만 읽으십시오.
일반적인 모호성 해결
- 짧은 애니메이션 타이틀, 로고 스팅, 통계 히트, 차트 히트, 지도 히트 또는 독립형 하단 서드는 내레이션이 없고 모션이 메시지인 경우
/motion-graphics입니다. 정적 타이틀 카드, 내레이션이 있는 시퀀스, 더 긴 몽타주 또는 사용자 정의 루프는/general-video입니다. - 명시적으로 짧은 모션 그래픽은 URL, 트윗, 기사 또는 스크린샷을 소스 자료로 사용할 수 있습니다. "이 사이트에서 비디오 만들기"와 같은 일반적인 요청은
/product-launch-video입니다. - 자막이 있는 기존 영상은
/embedded-captions로 라우팅되고, 디자인된 정보 카드가 있는 영상은/talking-head-recut으로 라우팅됩니다. 영상의 리타이밍, 재정렬, 재채색, 재프레이밍 또는 리믹스는 사용자 정의 편집이며/general-video로 넘어갑니다. - 음악 파일은 비트 그리드가 작품을 구동하는 경우에만
/music-to-video를 선택합니다. 배경 음악으로 사용된 음악은 주제 일치 경로를 재정의하지 않습니다. - "스토리보드를 원합니다"는 워크플로우가 아닌 검토 프로세스를 변경합니다. 다른 라우팅 신호가 없으면
/general-video를 사용하십시오. 확정된 스케치storyboard.html자체가 요청된 결과물일 수 있습니다. 검토 루프가 해당 중지 지점을 정의합니다. - 특수 내러티브 워크플로우는 최대 약 3분을 지원하며 30-90초에서 가장 강력합니다. 분명히 더 긴 작품은
/general-video로 라우팅하십시오. 길이는 명시적 포트, 데크, 자막, 오버레이 또는 음악 구동 결과물을 재정의하지 않습니다.
3. 한 번 라우팅한 후 종료
새 생성의 경우 의도 레이어(references/intent-interview.md)가 전체 대화(메모리, 분류, 피치 라운드, 필수 사항, 실행 형태, 핸드오프)를 실행하고 BRIEF.md 작성으로 종료합니다. 브리프는 워크플로우가 읽는 유일한 라우팅 아티팩트입니다. 이후에 이 스킬이나 인터뷰를 다시 열지 않습니다. "경로가 요구한 것"에 대한 모든 후속 질문은 BRIEF.md에서 답변하십시오.
4. 워크플로우 설치 및 진입
선택한 워크플로우를 읽기 전에 설치하거나 새로 고치고 핵심 도메인 스킬을 설치하십시오:
npx hyperframes skills update <워크플로우 이름>
/ 없이 기본 이름을 사용하십시오. 명령이 실패하면 오류를 표시하고, 메모리에서 워크플로우를 재구성하지 마십시오. 설치에 관한 다른 모든 것(코어 대 지연 분할, init이 새로 고치는 것, 진단, CI 옵트아웃 및 CLI 없음 대체)은 references/skill-lifecycle.md에 있습니다.
5. 필요 시 도메인 스킬 로드
| 필요 사항 | 스킬 |
|---|---|
| 컴포지션 구조, 타이밍 속성, 트랙, 변수, 결정론 | /hyperframes-core |
| 모션 규칙, 씬 청사진, 전환, 런타임 어댑터 | /hyperframes-animation |
검색 가능 GSAP, CSS, Anime.js, WAAPI, FLIP, 패스, 마스크, SVG, 3D 키프레임 또는 hyperframes keyframes 진단 | /hyperframes-keyframes |
| 디자인 사양, 컨셉, 팔레트, 타이포그래피, 내레이션, 비트 계획 | /hyperframes-creative |
| 이미지, 아이콘, 로고, 오디오, 자막, 그레이딩, LUT, 재사용 가능한 미디어 | /media-use |
| 보이스오버 컷, 오디오 이펙트 체인, 자동화 엔벨로프 또는 여러 트랙에 걸친 하나의 체인/페이더(서브믹스 버스) | /hyperframes-audio |
| 초기화, 린트, 확인, 스냅샷, 비교, 배치 렌더링, Studio, 렌더링, 게시 또는 진단 | /hyperframes-cli |
| 레지스트리 블록 및 컴포넌트 | /hyperframes-registry |
| 명명된 룩, 효과, 처리 또는 전환(CRT 스캔라인, 글리치, 필름 그레인, 샤이머 스윕, 컨페티 버스트) - 직접 제작하기 전에 | /hyperframes-registry |
| 재구성된 모션으로서의 Figma 에셋, 토큰, 컴포넌트 또는 스토리보드 프레임 | /figma |
제작자 편집 구문은 교차 도메인 요청입니다. 일치하는 행에 명명된 모든 스킬을 로드하십시오:
| 제작자 요청 | 필요한 도메인 |
|---|---|
| "이 영상 잘라내기", 하드 컷, 트림, 스플라이스, 재정렬 또는 소스 범위 사용 | /general-video + /hyperframes-core; 코어가 data-start, data-duration, data-media-start 및 트랙 레이아웃을 소유합니다. |
| 여기 확대, 펀치인/펀치아웃, 부드러운 다중 상태 확대/축소 또는 재프레이밍, Ken Burns 또는 카메라 이동 | /general-video + /hyperframes-core + /hyperframes-keyframes; 시간 제한 클립이 아닌 내부 시각적/크롭 래퍼에 애니메이션을 적용합니다. |
| 매치 컷 또는 휩 팬 카메라 전환 | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry; 직접 작성하기 전에 전환 프리미티브를 검색/설치합니다. |
| 페이드, 크로스페이드, 트랙 게인/볼륨, 자동화, 덕/컷, 오디오 효과 또는 여러 트랙에 걸친 하나의 효과 | /general-video + /hyperframes-core + /hyperframes-audio; 코어가 클립을 배치하고 오디오가 배치된 트랙을 믹스합니다. 그룹에 대한 서브믹스 버스를 포함합니다. |
| 그림과 사운드 편집으로 컷과 카메라 모션 또는 믹싱 결합 | /general-video + /hyperframes-core + /hyperframes-keyframes + /hyperframes-audio; 각 클립에 개별적으로 분리하지 않고 복합 트랙에서 작업합니다. |
같은 요청에 수평(카메라) 및 수직(타임라인) 편집이 혼합된 경우, 타임라인 전체를 재배열하기 전에 타임라인 편집을 확인하십시오.
6. 크리에이티브 서약
이 스킬의 프롬프트는 수렴하고 있습니다. 모든 영상을 최대한 시각적으로 풍부하게 만드십시오. 기본 설정에 대한 엄격한 해석은 피하고, 항상 크리에이티브 엔진과 함께 조향하십시오. 의도 인터뷰는 디자인 방향을 협상하는 도구입니다. 다음을 수행하십시오:
- 모든 곳에서 멈춤이 없는 원활한 방향을 선택하십시오.
- 타이포그래피에서도 뛰어난 자산을 제작하십시오.
- 프로덕션을 되풀이하십시오.
- 모든 시청자의 유지율을 위한 모션 전략을 일치시키십시오.
- 그렇지 않으면 활기를 불어넣으십시오.