플러그인 설치: 설정 또는 신규 명령 전에 이 스킬이 HyperFrames 플러그인 내에 있을 경우 플러그인 설치 규칙을 따릅니다. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
일반 비디오
워크플로우가 방금 읽은 경우가 아니라면 시작 시 npx hyperframes usage --json을 실행하고, 드래프팅 후와 렌더링 전과 같은 중요한 단계에서 다시 확인합니다. 사용 가능한 시간과 초기화 시간을 읽습니다. 사용량을 알 수 없으면 추측하지 않고 알리며, 사용자와 범위 및 워크플로우 선택을 조정합니다.
이 워크플로우에 의존하기 전에 다음을 실행합니다:
npx hyperframes skills update general-video
성공적인 no-op은 스킬이 최신 상태임을 의미합니다. 메모리에서 계속 진행하는 대신 업데이트 실패를 표시합니다.
1. 교차 적용 소스 어댑터
- 미디어: 오디오, 이미지, 아이콘, 로고, 음성, 그레이딩, LUT, 트리트먼트/효과, 자막 또는 미디어 작업 요구 사항이 있을 경우
/media-use를 로드하고../media-use/references/resolve.md(해결, 채택, 재사용)와../media-use/references/setup-providers.md(공급자, 인증)를 따릅니다. 모호한 푸티지 피드백과 명명된 스타일은 편집 전에../media-use/references/media-treatments.md를 사용합니다. CSS/SVG/불투명도로 지원되는 미디어 효과를 즉흥적으로 만들지 마십시오. 첫 번째 인증된 공급자 작업 전에npx hyperframes auth status를 실행하고 출력을 그대로 전달합니다. 로그아웃된 경우../hyperframes/references/brief-contract.md의 게이트를 적용합니다: 협업 모드는 로그인 또는 명시적 오프라인 선택을 기다립니다. 자율 모드는 상태를 알리고 사용 가능한 오프라인 공급자를 통해 계속 진행합니다. 필요한 기능을 충족할 수 있는 오프라인 공급자가 없으면 차단기를 표시합니다. 로컬 채택 단독으로는 인증 게이트가 필요하지 않습니다. - Figma: 입력이
figma.comURL인 경우 먼저/figma를 실행합니다. 내보낸 에셋, 토큰, 구성 요소 또는 스토리보드 프레임에서 빌드합니다. SVG 살균, 미디어 출처, 브랜드 토큰 바인딩을 건너뛰므로 원시 Figma 커넥터 호출을 사용하지 마십시오.
이러한 어댑터는 /hyperframes에서 선택한 워크플로우를 변경하지 않습니다.
2. 프로젝트 상태에서 시작
일치하는 첫 번째 행을 적용합니다. 하위 상태 행을 평가하지 마십시오:
| 상태 | 작업 |
|---|---|
| 특정 편집 | 편집을 수행하고 기존 프로젝트 결정을 유지한 후 영향을 받는 검사를 다시 실행합니다. 발견을 다시 열지 마십시오. |
BRIEF.md가 존재함 | 읽습니다. workflow가 다른 워크플로우를 지정하고 flow가 companion이 아니면 인계합니다. 브리프 질문을 하지 마십시오. |
브리프는 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함 | 파일과 기록된 선호도에서 재개합니다. 알려진 사실에서만 BRIEF.md를 백필합니다. |
| 새 생성 | /hyperframes와 의도 레이어를 실행합니다. workflow: general-video 또는 flow: companion인 경우에만 여기로 돌아옵니다. |
새 프로젝트의 경우 브리프에서 케밥 케이스 디렉토리 이름을 선택하고 브리프를 작성하기 전에 스캐폴드합니다:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
그런 다음 ../hyperframes/references/brief-format.md를 사용하여 프로젝트 루트에 BRIEF.md를 작성합니다. 기존 프로젝트에서 루트는 hyperframes.json이 포함된 디렉토리입니다. 브리프 형식에서 지정된 확인된 선호도 기반 필드만 기록하고, node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>를 사용합니다. 추론된 기본값을 기록하지 마십시오. 여기서 <MEDIA_DIR>은 설치된 /media-use 스킬 디렉토리이고 <PROJECT_ROOT>는 hyperframes.json이 포함된 디렉토리입니다. 의도 레이어가 레시피를 채택한 경우 지금 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>을 적용하고 다시 묻지 마십시오.
3. 실행 형태 해석
../hyperframes/references/brief-contract.md의 표준 용어만 사용합니다:
| 필드 | 의미 | 효과 |
|---|---|---|
flow | 주도권 | automation: 경로를 선택하고 실행합니다. companion: 대화에서 공동 창작합니다. |
storyboard | 빌드 전 계획, 스케치, 검토 | yes: 계획 및 스케치 검토 실행(storyboard.html). no: 없이 빌드합니다. |
파생된 mode | 체크포인트 게이트 동작 방식 | 브리프 계약을 따릅니다. 사용자에게 모드 이름을 묻지 마십시오. |
이러한 상태에 대한 동의어를 만들지 마십시오. 진행 중인 "그냥 빌드" 신호는 의도 레이어에서 처리되며 flow: automation, storyboard: no로 전달됩니다.
flow: automation의 경우 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 표시합니다.- 특정 편집의 경우 새 경로를 만들지 않고 편집을 수행합니다.
기존 푸티지의 하드 컷, 트림, 접합 또는 재정렬의 경우 동일한 비디오 소스를 여러 클립 요소로 복제합니다. 각 복사본에서 data-media-start와 data-duration으로 소스 범위를 설정한 다음 data-start로 작성된 배치/순서를 설정합니다. 각 비디오 세그먼트는 사운드를 유지합니다: 사운드는 클립(data-has-audio="true")에 유지되므로 비디오를 자르면 사운드도 잘립니다. /hyperframes-core가 이 시간 편집을 소유합니다. /hyperframes-keyframes는 내부 래퍼에서 줌, 펀치, 팬, 크롭, 마스크 또는 clip-path와 같은 시각적 속성 애니메이션에만 사용합니다. 전체 계약은 ../hyperframes-core/references/creator-editing-recipes.md에서 복사합니다.
협업 흐름
flow: companion인 경우:
BRIEF.md를 읽고 수락된## Assets및## Customizations를 프로젝트 아티팩트와 조정합니다. 아직 보류 중인 수락된 작업을 완료합니다. 완료된 작업은 그대로 둡니다. 수락된 기능을 새 것처럼 다시 제공하지 마십시오.- 계약자가 아닌 감독으로 도착하십시오. 협업을 선택한 사용자는 참여와 품질을 선택한 것입니다. 정직한 응답은 방어할 수 있는 가장 작은 버전이 아니라 설계할 수 있는 최상의 버전입니다. 첫 번째 계획은 천장 치료법입니다: 스토리 아크(가장 가까운 장르 렌즈 빌림 — 메뉴 § 장르 렌즈), 디자인 사양, 각 장면의 모션 트리트먼트 이름 인용(§ 5의 계획 규율), 전환, 오디오 아이덴티티 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 설계된 오프닝과 클로징. 각 레이어가 한 줄로 추가하는 내용을 말하고, 비용이 많이 드는 것(렌더링 시간, 로그인, 청구)을 이름을 지정할 때 표시합니다. 사용자는 치료법을 다듬습니다. 승인별로 조립할 필요가 없어야 합니다.
- 천장은 개념에 속하며 도구 상자에 속하지 않습니다. 모든 레이어는 브리프의 메시지를 제공해야 합니다. 모든 비디오를 동일하게 꾸미는 치료법은 장식입니다. 장인 정신은 천장까지 올라갑니다. 콘텐츠는 요청된 것 이상으로 성장하지 않습니다(§ 6).
- 체크포인트 사이에
../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 입력을 언급하거나 빌드가 필요에 도달할 때 관련 기능을 제공합니다. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("장면 3의 통계는 카운트업 트리트먼트를 원합니다"). 제공하기 전에 읽습니다. 전체 카탈로그를 덤프하지 마십시오. - 사용자가 기능을 수락한 후 해당 아티팩트를 생성하고 일치하는
BRIEF.md본문 섹션에 즉시 결정을 기록합니다. 사용자가 명시적으로 변경하는 경우에만 프론트매터 필드를 다시 작성하고 확인된 선호도를 기록합니다. - 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지합니다. 협업은 조종자를 변경할 뿐 품질 요구 사항을 변경하지 않습니다.
4. 각 단계 전에 필요한 지식 로드
조건이 일치할 때 다음 읽기는 필수입니다:
| 조건 | 행동 전에 읽기 |
|---|---|
| 모든 컴포지션 HTML 또는 장면 레이아웃 | /hyperframes-core; 레이아웃 계약에 references/determinism-rules.md 사용 |
| 모든 중요한 생성 또는 시각적 트리트먼트 | /hyperframes-creative → references/house-style.md 및 references/video-composition.md |
| 모든 모션, 애니메이션 또는 장면 전환 | /hyperframes-animation; 일치하는 규칙, 어댑터, 청사진 또는 전환 참조로 라우팅 따름 |
storyboard: yes | ../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/review-loop.md |
| 모든 미디어 에셋 또는 작업(내레이션, BGM, SFX, 자막, 그레이딩, 변환 포함) | /media-use(호스트 앱의 자체 음악 및 사운드 효과 도구가 먼저 옴); 프레임워크 재생 및 배치의 경우 /hyperframes-core → references/variables-and-media.md도 읽음 |
| 다중 장면 어셈블리 | ../hyperframes/references/production-loop.md |
flow: companion, 첫 번째 계획 전 | /hyperframes-creative → references/story-spine.md 및 references/house-style.md; 가장 가까운 장르 렌즈와 전체 ../hyperframes/references/capability-menu.md — 천장 치료법은 이것들에서 설계되며 기억되지 않음 |
| 협업 기능 제공, 캡처, 비트 그리드, 생성 비디오, 맵, 게시 또는 교차 워크플로우 기능 | ../hyperframes/references/capability-menu.md |
| 디자인 사양이 존재하며 최종 승인 전 | /hyperframes-creative → references/design-adherence.md |
이러한 읽기를 회상으로 대체하지 마십시오. 점진적 공개는 일치하는 참조가 실제로 로드된 경우에만 컨텍스트를 저장합니다.
5. 컴포지션 실행
이 종속성 순서를 사용합니다. 입력이 없을 때만 단계를 건너뜁니다.
-
계획. 뷰어 아크, 구조, 리듬, 지속 시간 드라이버를 명시합니다. 짧은 단일 장면에는 하나의 파일을 사용합니다. 세 번 이상의 하드 장면 컷이나 재사용된 장면에는 하위 컴포지션을 사용합니다. 내레이션 아크의 경우
/hyperframes-creative→references/story-spine.md, 리듬의 경우references/beat-direction.md, 구조의 경우/hyperframes-core→references/composition-patterns.md를 읽습니다. 개방형 다중 장면 브리프의 경우/hyperframes-creative→references/prompt-expansion.md를 통해 프롬프트를 확장합니다. 다중 장면 계획은 각 장면의 형태를 인용합니다:/hyperframes-animation→blueprints-index.md의 청사진 ID(해당되는 경우) 또는rules-index.md의 명명된 규칙(해당되는 경우) — 모션 이름은 해당 인덱스에서 가져오며 결코 발명되지 않습니다. 스토리 진실이 어떤 장면이 존재하는지 결정합니다. 인용이 장면을 꾸밉니다. 직접 명명된 룩을 구축하기 전에 라이브 카탈로그를 검색하십시오: 브리프가 명명한 모든 룩, 효과, 트리트먼트 또는 전환("CRT 스캔라인", "글리치", "필름 그레인", "반짝임 스윕", "폭죽 폭발")에 대해npx hyperframes catalog --query "<룩, 일반 영어로>" --json을 실행하고 계획이 해당 룩이 어떻게 구축되는지 명명하기 전에 상위 결과를 읽습니다. 검색에는 설치가 필요하지 않습니다: 프로젝트, 이전add, 계정이 필요 없습니다. 모든 디렉토리에서 전체 호스팅 레지스트리(~400개의 블록 및 구성 요소)의 순위를 매기므로 사용자가 빌드 중간에 요청하는 룩에도 적용됩니다. 계획이 명명한 블록은 3단계에서 설치됩니다. 검색 결과에 적합한 것이 없을 때만 룩을 직접 작성합니다. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다:STORYBOARD.md에 장면당 하나의## Frame N블록 —status: outline, 선언된src:, 청사진/규칙 인용, 상태(draft,review,final,dropped). -
에셋. 미디어 타임라인을 어셈블합니다.
/media-use를 사용하여 모든 미디어 참조를 확인하고 충족시킵니다. 지정된 소스 어댑터를 통해. 운영 제약 조건에 대해/hyperframes-core→references/variables-and-media.md를 읽습니다. -
구축. 하이퍼프레임스 HTML을 생성합니다.
/hyperframes-core→references/composition-patterns.md를 참조하여 적절한 패턴을 선택합니다. 빌드를 진행하기 전에 이전 디자인 사양(있는 경우)에 대한 준수를/hyperframes-creative→references/design-adherence.md에서 확인합니다./hyperframes-core→references/determinism-rules.md에서 정의된 대로 레이아웃 결정에 엄격합니다. 각 단계에는 있습니다.`를 유지합니다. -
애니메이션.
/hyperframes-animation을 읽고 각각에 대해 일치하는 규칙 또는 청사진을 찾습니다. 명명된 각 장면 모션: 장면 전환, 텍스트 애니메이션, 시각적 효과./hyperframes-keyframes를 사용하여 개별 속성 애니메이션을 만듭니다./hyperframes-core→references/determinism-rules.md에 대한 패턴을 따릅니다. -
스토리보드.(선택 사항). 스토리보드가 필요한 경우
../hyperframes/references/storyboard-format.md를 읽고../hyperframes/references/review-loop.md를 따릅니다. 스토리보드 검토를 실행합니다. -
렌더링 및 내보내기.
npx hyperframes render <output-dir>을 사용하여 최종 비디오를 렌더링합니다. 렌더링하기 전에npx hyperframes validate를 실행하여 컴포지션을 검증합니다. 사용자에게 최종 승인을 요청합니다.
계획 규율
다중 장면 계획의 경우 각 장면은 ## Frame N 블록으로 설명됩니다. src: 필드는 장면 유형(stock, ai-gen, screen-capture, upload)을 선언합니다. motion: 필드는 사용된 애니메이션 청사진 또는 규칙을 인용합니다. audio: 필드는 사운드 디자인 요소를 설명합니다. 각 장면에 대해 상태(outline, draft, review, final, dropped)를 추적합니다.
[참고: 원본의 잘린 텍스트는 여기서 복구되었습니다. 나머지 스킬 문서는 계속됩니다.]