플러그인 설치: 설정 또는 최신 상태 유지 명령을 실행하기 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 설치 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
첫째, 이 스킬을 최신 상태로 유지하세요 — 실행 전 사용자에게 확인:
npx hyperframes skills update product-launch-video. 모든 것이 최신 상태이면 빠르게 아무 작업도 하지 않습니다. 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 사용하기 전에 업데이트합니다.
미디어 사용: 오디오/이미지/로고를 가져오기 전에
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인하세요. 기존 에셋을 등록하려면 먼저--adopt를 실행하세요./media-use스킬을 참조하세요.
피그마 소스: 소스가 figma.com URL인 경우 먼저
/figma를 실행하세요 — 에셋 내보내기, 브랜드 토큰, 필요한 경우 컴포넌트/스토리보드 재구성 — 그런 다음 이 워크플로우를 그 출력물을 기반으로 구축하세요. 원시 MCP 도구를 통해 직접 Figma를 구동하지 마세요. SVG 삭제,.media/manifest.jsonl출처, 브랜드 토큰var()바인딩을 건너뛰므로 이후 브랜드 변경 시 전체 재가져오기 없이 전파할 수 없습니다.
제품 출시를 HyperFrames로
이 스킬을 사용하여 제품을 캡처하고, 브랜드를 이해하며, 출시 비디오를 계획하고 HyperFrames에서 프레임별로 구축하세요.
시작점은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 후에만 다음 단계로 진행하세요. 이 스킬은 마케팅, 출시, 홍보 또는 소개되는 제품을 위한 것입니다. 목적이 프로모션인 경우 "사이트 프로모션"과 같은 요청을 포함합니다. 사이트 둘러보기/소개 요청도 여기에 속합니다.BRIEF.md는 있는 그대로 보여주는 의도를 담고 있으며, 캡처된 스크린샷이 비디오가 특징으로 삼는 에셋이 됩니다. 다른 의도, 단순히 "비디오 만들기", 또는 불확실한 경우 → 먼저/hyperframes를 읽으세요 — 의도 레이어가 모든 경로 결정을 소유하며,BRIEF.md없이 여기에 도착한 새로운 제작 요청도 어쨌든 그것을 거칩니다(설정의 시작 규칙).
당신은 오케스트레이터입니다. videos/<project>/ 디렉토리에서 작업하세요. 단계를 순서대로 실행하고 각 게이트를 통과한 후에 계속 진행하세요. 사용자 게이트 단계는 Step 0, Step 3, Step 6입니다. Step 0 전에 ../hyperframes/references/brief-contract.md를 읽으세요 — 게이트 유형과 BRIEF.md의 flow/storyboard가 Step 3/4/6 게이트를 제어하는 모드를 도출하는 방법을 정의합니다. Step 5를 제외한 모든 단계를 직접 수행하세요. Step 5에서는 프레임당 하나의 하위 에이전트를 파견합니다. 디자인 또는 모션 규칙을 여기에 두지 마세요. 그것들은 프레임 작업자 하위 에이전트, 이 스킬의 로컬 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, 그리고 hyperframes-creative에 있습니다.
워크플로우: Step 0 설정 -> hyperframes.json; Step 1 캡처 -> capture/; Step 2 디자인 시스템 -> frame.md; Step 3 스토리보드/스크립트 -> STORYBOARD.md 및 SCRIPT.md; Step 3.1 오디오 -> audio_meta.json; Step 4 시각 디자인 -> 보강된 STORYBOARD.md; Step 5 프레임 -> compositions/frames/NN-*.html 및 index.html; Step 6 최종 렌더링 -> renders/video.mp4.
Step 0: 설정
목표: 확인된 브리핑을 가지고 시작하여 HyperFrames 프로젝트를 생성하고 브리핑을 영구적으로 만듭니다.
브리핑은 여기서 질문하는 것이 아니라 의도 레이어에서 확인됩니다. 시작 규칙, 순서대로: (1) BRIEF.md가 존재함 → 읽고 아무것도 묻지 않음 — 브리핑은 확정되었으며, 그 flow/storyboard가 모드를 도출합니다(브리핑 계약 § 1). (2) BRIEF.md는 없지만 프로젝트가 존재함(hyperframes.json / STORYBOARD.md가 디스크에 있음) → 스토리보드의 머리말과 기록된 기본 설정에서 재개합니다. 절반만 구축된 프로젝트를 다시 질문하지 마십시오. (3) 둘 다 없음 — 여기에 직접 도착한 새로운 제작 요청 → /hyperframes를 읽고 그 의도 레이어(references/intent-interview.md)를 실행합니다. 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(../hyperframes/references/routes/product-launch-video.md)을 수행하며, 잠긴 브리핑을 반환합니다. 편집 요청은 이 모든 것을 건너뜁니다 — 편집을 수행하세요.
hyperframes.json이 없는 경우에만 초기화합니다. 브랜드 또는 도메인에서 케밥 케이스로 <project> 이름을 지정하세요(예: acme-promo). 작업 공간 이름이나 타임스탬프를 사용하지 마십시오.
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=product-launch-video — init는 설치된 스킬을 GitHub의 최신 버전과 비교하고 오래된 경우 전역 세트를 업데이트합니다.
초기화 후 <PROJECT_ROOT>를 videos/<project>로 설정하고 모든 후속 상대 경로 명령을 해당 디렉토리를 작업 디렉토리로 하여 실행합니다. 아래 명령에서 .은 <PROJECT_ROOT>를 의미합니다. 호출자 디렉토리에 .media, capture 또는 출력 파일을 절대 쓰지 마십시오.
초기화 직후 BRIEF.md를 작성하십시오(절대 그 전에 작성하지 마십시오 — init는 비어 있지 않은 디렉토리를 거부합니다): 의도 레이어의 잠긴 브리핑, 형식은 ../hyperframes/references/brief-format.md를 따릅니다. <MEDIA_DIR>을 설치된 /media-use 스킬 디렉토리로 결정합니다. 그런 다음 각 기본 설정 기반 답변을 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes .로 기록합니다(brief-format.md가 하위 집합을 지정합니다). 의도 레이어가 레시피를 채택한 경우 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>을 실행합니다. 레시피는 frame.md를 프로젝트에 복사하고(Step 2는 건너뜁니다) Step 3에서 초안을 작성할 스켈레톤을 반환합니다. 레시피는 답변을 채우지만 승인은 채우지 않습니다. 검토 게이트는 여전히 실행됩니다.
설정을 진행하기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status를 실행하고 그 출력을 그대로 전달합니다. 음성/BGM이 HeyGen 또는 로컬 엔진을 사용할지 여부를 보고하고, 로그아웃된 경우 로그인 방법을 알려줍니다. 종료 코드 계약에 유의하십시오: auth status는 로그인되지 않은 경우 종료 코드 1을 반환합니다(저장된 자격 증명이 거부된 경우도 포함). 이 0이 아닌 종료는 정상적인 로그아웃 상태이므로 명령 실패로 처리하지 말고, 재시도하지 말며, 워크플로우를 중단시킬 수 있는 &&/set -e와 연결하지 마십시오. 한 가지 분기를 적용하십시오:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다립니다. - 자율: 상태를 명시하고 사용 가능한 로컬 엔진으로 계속 진행합니다.
오프라인 공급자가 없는 경우 필수 기능을 조용히 생략하지 마십시오. 차단기를 표면화하십시오. 이 결정을 다른 질문에 포함시키거나 저장소별 .env에 키를 쓰지 마십시오. 인증 소유권 및 오프라인 폴백: /media-use references/setup-providers.md § 공급자.
게이트: hyperframes.json 및 BRIEF.md가 존재함; 기본 설정 기반 답변이 기록됨(브리핑 계약 § 2); 로그인 상태가 표시됨(로그인되었거나 오프라인으로 계속 진행 중).
Step 1: 에셋 캡처
목표: 소스 자료, 브랜드 신호, 비디오에 사용할 수 있는 에셋을 수집합니다.
입력을 분류하고 경로를 선택합니다. 명시적 URL -> 캡처하고 내레이션 및 에셋에 사이트를 사용합니다. 붙여넣은 스크립트/브리핑 -> user_script.txt로 그대로 저장합니다. VO_MODE(그대로 또는 재구성)는 BRIEF.md에서 가져옵니다 — 의도 레이어는 스크립트가 도착할 때 이를 묻습니다(브리핑에 없는 경우에만 여기서 한 번 묻습니다). 그런 다음 캡처 대상을 결정합니다. 텍스트의 URL -> 사용합니다. 브랜드 이름만 -> WebSearch, 한 줄로 URL 확인, 그런 다음 크롤링합니다. URL/사이트 없음(또는 브리핑이 스크랩하지 말라고 지시함) -> 캡처 안 함 경로.
다음으로 캡처를 실행합니다: npx hyperframes capture "<URL>" -o ./capture --json. 호출자가 더 작은 마감일을 소유하지 않는 한 기본 사후 탐색 예산을 유지합니다. 그런 다음 다운스트림 작업을 위한 시간을 남기는 양수 --capture-budget <milliseconds>를 전달합니다. --timeout은 페이지 탐색만 제어합니다. 선택적 이미지 캡셔닝이 의도적으로 비활성화된 경우에만 --skip-vision을 사용합니다.
명령 결과와 출력 디렉토리를 즉시 검사합니다. 0이 아닌 종료, JSON ok: false, 또는 capture/BLOCKED.md는 캡처 경로에 대한 하드 중지입니다. 기록된 이유를 보고하고 부분 스크린샷, DOM, 토큰 또는 에셋을 소비하지 마십시오. 실패한 URL 캡처 후 인조적인 캡처 안 함 대체를 생성하지 마십시오. 원래 브리핑이 소스 자료를 제공했거나 사용자가 실패 후 제공된 스크린샷 또는 브리핑으로 명시적으로 전환한 경우에만 캡처 안 함 경로를 통해 계속 진행하십시오.
매우 적은 텍스트 콘텐츠와 같은 경고와 함께 빈 에셋 카탈로그는 사용 가능한 페이지의 증거가 아닙니다. 사이트 둘러보기 또는 있는 그대로 보여주는 브리핑의 경우 신뢰할 수 있는 캡처된 구조 또는 제공된 스크린샷이 필요합니다. 둘 다 없으면 중지하십시오. 캡처를 사용할 수 없다는 이유만으로 페이지를 발명하거나 재구축하지 마십시오.
사이트 둘러보기 또는 있는 그대로 보여주는 브리핑의 경우 캡처된 페이지는 시각적 진실의 근원입니다. 전체 웹사이트를 HTML로 재구축하는 대신 실제 스크린샷을 사용하십시오. 샷에 내부 움직임이 필요한 경우 스크린샷을 베이스로 유지하고 측정된 위치에 실제 캡처된 에셋을 오버레이하거나 움직이는 구성 요소 하나만 재구축하십시오. 스크롤 샷의 경우 뷰포트를 capture/screenshots/full-page.png 위에 애니메이션화합니다. 전체 문서의 1x 플레이트로, 1920 너비 뷰포트가 아래로 이동할 때 픽셀 정확합니다. 페이지가 한 조각으로 캡처하기에는 너무 긴 경우에는 없습니다. 동일한 디렉토리의 겹치는 스크롤 위치 샷으로 대체하십시오. 1:1 이상으로 확대하려면 대신 해당 영역의 자체 2x 캡처가 필요합니다. 플레이트에는 1x 이상의 여유 공간이 없기 때문입니다. 사용자가 명시적으로 양식화된 해석을 요청한 경우에만 전체 페이지를 재생성하십시오. 사용할 수 없는 캡처만으로는 권한이 부여되지 않습니다.
GEMINI_API_KEY, GOOGLE_API_KEY 또는 OpenRouter 키가 존재하는 경우 캡처는 자동으로 에셋에 캡션을 추가하여 capture/extracted/asset-descriptions.md에 기록합니다. 이것은 검토 게이트가 아닙니다. 비전 키가 없으면 DOM 컨텍스트를 사용하고 계속 진행하십시오.
캡처 안 함 경로: 수동으로 capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md, capture/assets/를 생성합니다. tokens.json은 { "title": "", "description": "", "colors": [], "fonts": [] } 형식이어야 합니다. 가능하면 브리핑에서 제목/설명을 채웁니다. visible-text.txt에는 전체 브리핑 또는 스크립트가 포함됩니다. 사용자가 에셋 노트를 제공하지 않는 한 asset-descriptions.md에는 캡처된 에셋이 없다고 명시해야 합니다.
게이트: 캡처 JSON이 ok: true를 보고함; capture/BLOCKED.md가 존재하지 않음; capture/extracted/tokens.json, capture/extracted/visible-text.txt,
capture/extracted/asset-descriptions.md, capture/assets/가 존재함; 브랜드를 명확한 한 문장으로 말할 수 있음. asset-descriptions.md를 기본 에셋 인벤토리로 취급하십시오. 실제 캡처 후에 누락된 경우 중지하고 캡처가 불완전하다고 보고하십시오. 이 구조적 게이트가 여전히 통과하는 경우에만 선택적 단계의 저하에 대한 경고가 허용됩니다.
Step 2: 디자인 시스템
목표: 제공된 프레임 프리셋 하나를 선택합니다. 스크립트가 이 비디오의 frame.md + 캡션 스킨으로 변환합니다.
BRIEF.md가 style_preset을 지정하는 경우 — 사용자가 의도 레이어의 쇼케이스에서 눈으로 선택한 것 — 사용하십시오. 판단은 브리핑이 침묵할 때만 당신의 몫입니다. 그런 다음 한 가지 결정을 내리십시오 — 어떤 프리셋을 사용할지: ../hyperframes-creative/references/design-spec.md를 읽고 브랜드와 브리핑에 가장 잘 맞는 프리셋을 선택하십시오. 그런 다음 다음을 실행하십시오:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
스크립트는 나머지를 결정론적으로 수행합니다. 프리셋의 FRAME.md를 frame.md로 복사하고 캡처된 capture/extracted/tokens.json의 브랜드 토큰에 리믹스합니다(브랜드 색상이 역할별로 프리셋의 색상 키에 매핑됨 — 잉크, 캔버스, 악센트 — 키/구조/컴포넌트 유지; 프리셋의 디스플레이 + 본문 글꼴이 브랜드의 것으로 교체됨), 프리셋의 캡션 스킨을 .hyperframes/caption-skin.html에 복사하고, 자체 검증합니다(매핑이 깨지면 종료 코드 1). 0으로 종료되는 즉시 다음 단계로 진행하십시오. 사양을 수동으로 편집하지 마십시오.
브랜드 색상/글꼴이 없는 tokens.json(예: 캡처 없음) → 스크립트는 프리셋의 자체 팔레트를 유지하며, 이는 완전히 제공 가능한 디자인입니다. 브리핑이 캡처에서 누락된 브랜드 색상/글꼴을 지정하는 경우 실행하기 전에 capture/extracted/tokens.json에 추가하거나(또는 사용자의 design.md를 사용하여 채움) 매핑이 실제로 필요한 경우에만 이후에 수동으로 frame.md를 조정하십시오.
게이트: build-frame.mjs가 0으로 종료됨 — frame.md가 명명된 프리셋에서 존재함, 그리고 (프리셋이 제공하는 경우) .hyperframes/caption-skin.html이 캡션 스킨 소스로 존재함. 선택한 프리셋이 기본 설정으로 기록됨(--key style_preset --workflow <this workflow>, 브리핑 계약 § 2).
Step 3: 스토리보드 및 스크립트
목표: 브리핑과 캡처된 자료를 승인된 프레임별 스토리 계획으로 전환합니다.
../hyperframes-creative/references/story-spine.md(훅 언어, 증거 이전의 가치, 제안으로서의 스토리보드, 소스 추적 가능한 시각 자료), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md, ../hyperframes/references/script-format.md를 읽으십시오. 이를 사용하여 STORYBOARD.md와, 내레이션이 필요할 때 SCRIPT.md를 작성하십시오. 머리말 duration:을 브리핑의 length에서 설정하십시오 — 대략적인 기대치이며, 조립 시 컷이 그것에 대해 어디에 도달하는지 보고합니다.
story-design.md를 스토리 청사진, 훅, 설득 논리, 비트, VO_MODE 및 에셋 선택에 사용하십시오. 소프트 가이드로 ../hyperframes-animation/blueprints-index.md의 역할→청사진 메뉴를 참조하십시오. 각 비트에 대해 하나의 청사진이 적합할 때 후보 청사진 ID를 기록하십시오. 스토리 진실은 여전히 어떤 비트가 존재하는지 결정합니다. 청사진에 맞추기 위해 비트를 강제로 적용하지 말고, 입증된 형태를 사용할 수 있다는 이유만으로 비트를 발명하지 마십시오. 각 시각적 프레임의 asset_candidates를 capture/extracted/asset-descriptions.md(정식 인벤토리)에서 선택하십시오. 원시 capture/assets/를 탐색하지 마십시오. 해당 인벤토리가 없거나 사용할 수 없는 경우가 아니면 사용자에게 에셋을 선택하도록 요청하지 마십시오. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.
초안을 작성한 후 검토 루프의 계획 패스를 실행하십시오 — ../hyperframes/references/review-loop.md § 1: 계획을 제안으로 제시하고 두 가지 질문을 하십시오 — 승인 또는 변경, 그리고 스케치 먼저(권장) 또는 건너뛰기. 피드백은 채팅 응답으로 도착합니다. 승인될 때까지 반복하십시오. 이것은 체크포인트 게이트(브리핑 계약 § 1)입니다: 자율 모드에서
…
[번역을 위해 잘림]