플러그인 설치: 설정 또는 갱신 명령 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따르십시오. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
먼저, 이 스킬을 최신 상태로 유지하세요 — 사용자에게 실행 전 확인:
npx hyperframes skills update pr-to-video. 모든 것이 최신 상태이면 빠른 무동작; 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 사용하기 전에 새로 고칩니다.
media-use: 오디오/이미지/로고를 소싱하기 전에,
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인하십시오. 먼저--adopt를 실행하여 기존 자산을 등록하십시오./media-use스킬을 참조하세요.
PR to HyperFrames
이 스킬을 사용하여 GitHub 풀 리퀘스트를 수집하고, 변경 사항을 이해하며, 코드 변경 설명자를 계획하고, HyperFrames에서 프레임별로 구축하십시오. 입력은 (gh를 통해 읽은) 코드 변경이며 웹사이트가 아닙니다 — 캡처 단계나 기여자의 아바타 외에는 실제 자산이 없습니다.
관문은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 후에만 계속하십시오. 이 스킬은 GitHub 풀 리퀘스트(코드 변경)용입니다. 다른 의도, 단순히 "비디오 만들기", 또는 불확실성 → 먼저/hyperframes를 읽으십시오 — 의도 레이어가 모든 경로 결정을 소유하며,BRIEF.md없이 여기에 도착한 새로운 생성은 어쨌든 이를 거칩니다(설정의 시작 규칙).
당신은 오케스트레이터입니다. 확인된 외부 PROJECT_DIR에서 작업하며, 기본적으로 호출자 저장소에서는 작업하지 마십시오. 단계를 순서대로 실행하고 계속하기 전에 각 게이트를 통과하십시오. 사용자 게이트 단계는 0단계, 3단계, 6단계입니다. 0단계 전에 ../hyperframes/references/brief-contract.md를 읽으십시오 — 게이트 유형과 BRIEF.md의 flow/storyboard가 3/4/6단계 게이트를 제어하는 모드를 도출하는 방법을 정의합니다. 5단계를 제외한 모든 단계를 직접 수행하십시오. 5단계에서는 제한된 프레임 작업자 풀을 파견합니다. 디자인 또는 모션 규칙을 여기에 두지 마십시오. 해당 규칙은 프레임 작업자 하위 에이전트, 이 스킬의 로컬 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, 그리고 hyperframes-creative에 있습니다.
워크플로우: 0단계 설정 → hyperframes.json; 1단계 수집 → capture/extracted/ + assets/<login>.png; 2단계 디자인 시스템 → frame.md; 3단계 스토리보드/대본 → STORYBOARD.md 및 SCRIPT.md; 3.1단계 오디오 → audio_meta.json; 4단계 비주얼 디자인 → 보강된 STORYBOARD.md; 5단계 프레임 → compositions/frames/NN-*.html 및 index.html; 6단계 최종 렌더링 → renders/video.mp4.
0단계: 설정
목표: 확인된 브리프(PR 참조 포함 — 전체 URL, <owner>/<repo>#<N> 참조, 또는 체크아웃된 저장소의 "this PR")로 시작하여 HyperFrames 프로젝트를 생성하고 브리프를 지속 가능하게 만듭니다. 스타일은 항상 code-editorial(2단계에서 고정, 절대 묻지 않음)입니다.
브리프는 여기서 질문하는 것이 아니라 의도 레이어에 의해 확인됩니다. 시작 규칙, 순서: (1) BRIEF.md가 존재함 → 읽고 아무것도 묻지 마십시오 — 브리프가 확정되었으며, 그 flow/storyboard가 모드를 도출합니다(브리프 계약 § 1). (2) BRIEF.md는 없지만 프로젝트가 존재함(디스크에 hyperframes.json / STORYBOARD.md 있음) → 스토리보드의 프론트매터와 기록된 기본 설정에서 재개하십시오; 절반만 구축된 프로젝트를 다시 질문하지 마십시오. (3) 둘 다 아님 — 여기에 직접 도착한 새로운 생성 요청 → /hyperframes를 읽고 해당 의도 레이어(references/intent-interview.md)를 실행하십시오: 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(PR 크기 → 길이 교리를 포함하며, 이는 ../hyperframes/references/routes/pr-to-video.md 전체에 있음)을 수행한 다음 잠긴 브리프를 반환합니다. 편집 요청은 이 모든 것을 건너뜁니다 — 편집을 수행하십시오.
다른 작업을 수행하기 전에 프로젝트 디렉토리를 확인하십시오. 사용자가 제공한 프로젝트 디렉토리는 유지하십시오; 그렇지 않으면 리졸버가 출력하는 지속 가능한 외부 캐시 위치를 사용하십시오. 호출자 저장소에 videos/를 절대 생성하지 마십시오:
PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs
기능 사전 점검은 가져오기, 스토리 작업, 오디오 또는 프레임 디스패치 전에 실행됩니다. 설치된 CLI가 이 스킬에 필요한 유효성 검사 명령을 실행할 수 없으면, 실행 컨텍스트를 먼저 소비하지 말고 업그레이드 지침과 함께 중지하십시오.
$PROJECT_DIR/hyperframes.json이 없는 경우에만 초기화하십시오. 기본 이름은 PR에서 가져옵니다(예: acme-sdk-pr-1842); 워크스페이스 이름이나 타임스탬프를 절대 사용하지 마십시오.
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init은 설치된 스킬을 GitHub의 최신 버전과 비교하고, 오래된 것이 있으면 전역 세트를 업데이트합니다.
아래의 모든 상대 경로 명령은 $PROJECT_DIR을 작업 디렉토리로 사용하여 실행됩니다. 명시적인 서브쉘이 없는 예제는 (cd "$PROJECT_DIR" && …)를 의미합니다; 호출자 저장소의 작업 트리를 절대 변경하지 마십시오.
init 직후에 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를 프로젝트에 복사하고(2단계는 건너뜀) 3단계가 초안을 작성할 스켈레톤을 반환합니다. 레시피는 답변을 채우고 승인은 채우지 않습니다; 검토 게이트는 여전히 실행됩니다.
설정을 진행하기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status를 실행하고 출력을 그대로 전달하십시오. 음성/BGM이 HeyGen을 사용할지 로컬 엔진을 사용할지, 그리고 로그아웃된 경우 로그인 방법을 보고합니다. 한 분기를 적용하십시오:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다리십시오. - 자율: 상태를 명시하고 사용 가능한 로컬 엔진을 통해 계속하십시오.
오프라인 제공자가 없는 경우 필수 기능을 조용히 생략하지 마십시오; 차단기를 표면화하십시오. 이 결정을 다른 질문에 통합하거나 저장소별 .env에 키를 작성하지 마십시오. 인증 소유권 및 오프라인 폴백: /media-use references/setup-providers.md § 제공자.
게이트: hyperframes.json 및 BRIEF.md가 존재합니다; PR 참조가 브리프에 캡처되었습니다; 기본 설정 기반 답변이 기록되었습니다(브리프 계약 § 2); 로그인 상태가 표시되었습니다(로그인됨 또는 오프라인 계속).
1단계: PR 수집(캡처 없음)
목표: PR의 사실을 가져와 정보 소스로 프로젝트에 통합합니다. 웹사이트 캡처는 없습니다. fetch-pr.mjs는 결정론적으로 gh를 실행합니다 — 페이지가 매겨진 gh api를 통해 파일 목록을 완성하여 대규모 PR이 약 100개 파일에서 잘리지 않도록 하고, capture/pr.json + capture/diff.patch(스크래치 디렉토리 없음)만 씁니다. MERGED PR의 경우 최선의 shipped_version(+ version_source)을 pr.json에 확인하여 엔드 카드가 가짜 버전을 발명하는 대신 실제 버전을 인용할 수 있도록 합니다. 그런 다음 ingest.mjs가 이를 오프라인에서 합성 캡처 패키지로 통합합니다.
PR="<url | owner/repo#N | N>"
# PR을 결정론적으로 가져옴: gh를 실행하고, 페이지가 매겨진 gh api를 통해 파일 목록을 완성하여
# 대규모 PR이 약 100개 파일에서 잘리지 않도록 하고, capture/pr.json + capture/diff.patch만 씁니다
# — 스크래치 디렉토리 없음. gh auth / not-found / private 오류는 여기서 exit 1로 종료됩니다.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
# 오프라인 변환 → capture/extracted/{tokens.json (colors:[] → code-editorial 팔레트),
# visible-text.txt (브리프), people.json (기여자, 봇 필터링, name+login,
# avatarFile=assets/<login>.png)}.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
--pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)
# 사람 전면의 유일한 네트워크 단계 — 크레딧 클로즈를 위해 각 기여자의 GitHub 아바타를
# assets/<login>.png에 다운로드합니다. 최선 노력; 항상 0으로 종료됩니다.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
fetch-pr.mjs가 1로 종료되면(gh auth / not-found / private), 해당 stderr를 보고하고 중지하십시오 — PR 내용을 조작하지 마십시오. ingest.mjs가 1로 종료되면, stderr(일반적으로 잘못된 pr.json)를 읽고, 수정한 후 다시 실행하십시오(결정론적). fetch-people-avatars.mjs는 항상 0으로 종료됩니다; 아바타가 없으면 작성자에게 크레딧 클로즈가 없다는 의미일 뿐입니다.
people.json은 gh가 이미 이름을 지정한 기여자(PR 작성자, 커밋 작성자, mergedBy)에 대해 name을 전달합니다 — 나머지(리뷰어/댓글 작성자/할당자, gh pr view는 항상 bare login만 제공)는 null입니다. 3단계에서 크레딧 클로즈를 작성하기 전에, 해당 프레임에 실제로 나타날 1-6명에 대한 null 이름을 직접 확인하십시오: gh api users/<login> --jq .name(이미 gh가 있음 — 스크립팅할 필요 없음). GitHub에도 해당 사용자의 공개 이름이 없으면, 화면의 로그인으로 대체하고 해당 인물을 음성 대사에서 제외하십시오(story-design.md의 크레딧 섹션 참조 — 나레이션은 여전히 이름을 말해야 하며, 원시 핸들은 절대 안 됨).
게이트: capture/pr.json, capture/diff.patch, capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/people.json이 존재합니다; PR의 변경 사항을 한 문장으로 명확하게 설명할 수 있습니다. assets/<login>.png는 최선 노력 — 없는 것은 실패가 아닙니다.
2단계: 디자인 시스템
목표: code-editorial 프레임 프리셋을 채택합니다; 스크립트가 이를 이 비디오의 frame.md + 캡션 스킨으로 변환합니다.
스타일은 고정 — code-editorial(따뜻한 편집 스타일; diff용으로 제작된 네이비 코드 표면). 실행:
node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
스크립트는 code-editorial 프리셋의 FRAME.md를 frame.md로 복사하고, capture/extracted/tokens.json의 모든 브랜드 토큰(PR에는 없음 → colors:[]/fonts:[]는 code-editorial 자체 팔레트, 완전한 디자인 유지)에 리믹스하고, 프리셋의 캡션 스킨을 .hyperframes/caption-skin.html에 복사하고, 자체 검증합니다(손상된 매핑에서 1로 종료). 0으로 종료되면 진행하십시오 — 수동 편집 없음.
게이트: build-frame.mjs가 0으로 종료됨 — frame.md가 code-editorial 프리셋에서 존재하고, .hyperframes/caption-skin.html이 캡션 스킨 소스로 존재합니다.
3단계: 스토리보드 및 대본
목표: PR을 승인된 프레임별 설명 계획으로 전환합니다.
../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에서 설정하십시오 — 대략적인 예상; 어셈블리는 실제 컷이 어디에 있는지 보고합니다.
PR 아키타입(변경 로그 / 기능 소개 / 버그 수정 설명 / 리팩터링 워크스루), PR 고유 프레임 유형, 훅, 설득, 비트, 프레임별 단어 예산, 크레딧 클로즈에 story-design.md를 사용하십시오. 순서는 내러티브 디자인에서 비롯되며, diff의 파일 순서가 아닙니다 — 변경 사항을 설명하고, diff를 소리 내어 읽지 마십시오. 소프트 가이드로서, ../hyperframes-animation/blueprints-index.md의 역할→청사진 메뉴를 참조하십시오: 각 비트에 대해, 후보 청사진이 암시하는 형태로 나레이션을 작성하고, 하나가 맞을 때 해당 후보 blueprint: id를 태그하십시오(스토리 진실은 여전히 어떤 비트가 존재하는지 결정함 — 비트를 억지로 형태에 맞추지 마십시오). 24개의 실제 diff 헹크(6개의 capture/diff.patch에서)를 특징으로 하며, 각각 작고 읽기 쉬운 스니펫입니다; 각 프레임의 scene에서 원하는 code-* 블록의 이름을 지정하십시오. 프레임에는 credits 클로즈(1assets/<login>.png 아바타)를 제외하고 asset_candidates가 없습니다. 스토리보드 및 대본 참조의 정확한 필수 필드를 사용하십시오.
초안 작성 후, 검토 루프의 계획 단계를 실행하십시오 — ../hyperframes/references/review-loop.md § 1: 계획을 제안으로 제시하고 두 가지 질문을 하십시오 — 승인 또는 변경, 그리고 먼저 스케치(권장) 또는 건너뛰기. 피드백은 채팅 응답으로 도착합니다; 승인될 때까지 반복하십시오. 이는 체크포인트 게이트(브리프 계약 § 1)입니다: 자율 모드에서는 질문할 것이 없습니다 — 동일한 요약을 헤드업으로 게시하고 진행하십시오; 스케치는 빌드에 통합되고, 하나의 질문이 있는 최종 미리보기는 6단계에서 제공됩니다.
게이트: STORYBOARD.md가 존재하고, 모든 프레임에 필요한 내러티브 필드가 있으며, 나레이션이 필요할 때 SCRIPT.md가 존재하고, 사용자가 계획을 승인했습니다(자율: 요약이 헤드업으로 게시됨).
3.1단계: 오디오
목표: 승인된 대본에서 나레이션, 단어 타이밍, 음악, 오디오 메타데이터를 생성합니다.
3단계 승인 후 오디오를 시작하십시오. 백그라운드에서 실행한 다음 4단계로 계속하십시오.
호출 전 사용자의 요청에 따라 나레이션 음성을 선택하십시오. 요청이 음성, 성별 또는 톤을 지정한 경우, 일치하는 음성 ID를 찾아 --voice <id>와 함께 전달하십시오. 파이프라인 기본값은 HeyGen의 Marcia(여성) / Kokoro의 am_michael 입니다 — 따라서 "남성 음성"과 같은 요청은 플래그를 전달하지 않으면 자동으로 무시됩니다. 음성 ID는 제공자별로 다릅니다; 0단계의 로그인 상태가 선택한 제공자에 대해 확인하십시오: HeyGen(로그인됨) via node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(또는 GET /v3/voices?engine=starfish); Kokoro(오프라인) via <MEDIA_DIR>/audio/references/tts.md의 음성 테이블(접두사 am_/bm_ 남성, af_/bf_ 여성). 사용자가 선호도를 표현하지 않은 경우, 파이프라인 기본값 이전에 기억된 음성(브리프 계약 § 2)으로 대체하십시오. node <MEDIA_DIR>/scripts/prefs.mjs get --hyperframes . --key narrationVoice가 값을 반환하면 해당 음성을 사용하십시오; 그렇지 않으면 파이프라인 기본값을 사용하십시오.
# TTS 오디오 생성
rm -f ./audio_meta.json 2>/dev/null
node <MEDIA_DIR>/audio/scripts/hyperframes-tts.mjs \
--script ./SCRIPT.md \
--hyperframes . \
[--voice "<voice_id>"] \
--out-dir ./audio/output
# 결과 메타데이터 확인
cat ./audio_meta.json
게이트: ./audio/output/에 오디오 파일이 있고, ./audio_meta.json에 단어 수준 타임코드가 있습니다.
4단계: 비주얼 디자인
목표: diff 헹크에서 화면 요소를 매핑하고, 각 프레임에 비주얼 스펙을 추가하여 스토리보드를 보강합니다.
../hyperframes-animation/rules/ 및 ../hyperframes-animation/blueprints/의 참조를 사용하십시오. 각 프레임에 대해, 나타나는 모든 코드 스니펫(정확한 소스 범위)을 확인하고, 프레임의 scene 배열에서 elements를 채우고, ../hyperframes-animation/blueprints-index.md의 형식을 따르는 visual 필드를 설정하십시오. phase: 태그를 포함하여 각 프레임이 생성 워크플로우에서 어떻게 렌더링되는지 나타냅니다(프레임 팩토리 참조). 모든 code 요소에는 해당하는 diff 헹크가 필요하며, 합성되거나 요약된 코드(확장된 diff 보기)가 아니라 캡처된 diff에서 직접 발췌한 것입니다. 시각적 요소는 각 프레임의 내러티브 목적에 직접적으로 기여해야 합니다. 요소 설명은 frame.md 프리셋에서 허용하는 유형 및 속성과 일치해야 합니다.
이 단계는 수동 편집 단계가 아닙니다 — 생성 규칙을 따르고 화면 요소를 설명하거나 특정 좌표를 할당하지 마십시오.
게이트: 모든 프레임에 scene이 채워져 있고, visual 필드가 있으며, 모든 코드 블록이 캡처된 diff의 소스 범위를 참조합니다.
5단계: 프레임 생성
목표: 스토리보드를 HTML 프레임 파일로 렌더링합니다.
중요: 이 단계는 프레임을 생성하지만 여기서 미리보기하거나 검토하지 마십시오. 작업 증분을 주의 깊게 관리하십시오—compositions/frames/을 생성하기 전에 다음을 정리하는 데 실패하지 마십시오: 스토리보드의 기존 프레임(이전 실행에서 남은)을 지우고, 새 프레임을 작성한 후에만 미리보기를 하십시오. 프레임 생성을 프레임 팩토리 하위 스크립트에 위임하십시오:
# 기존 프레임 정리
rm -rf ./compositions/frames/
mkdir -p ./compositions/frames
# 프레임 팩토리 실행 — 프레임 작업자는 이 스킬 디렉토리에 있으며 승인된 스토리보드를 읽습니다.
node <SKILL_DIR>/scripts/frame-factory.mjs --hyperframes .
성공하면 compositions/frames/에 NN-*.html 파일이 생성됩니다. 각 파일은 자체 포함된 HTML 문서이며 특정 프레임을 나타냅니다. 비디오 에셋은 포함하지 않습니다—정적 HTML입니다.
프레임을 검토할 때, 전체 세트가 생성된 후에만 검토하십시오. 개별 프레임을 검토하지 마십시오. 최종 제작 전에 살펴볼 의향이 있음을 사용자에게 알리십시오. 오류가 발생하면 프레임 팩토리에게 맡기고 여기서 프레임을 수동으로 생성하지 마십시오.
게이트: compositions/frames/index.html 및 모든 NN-*.html 파일이 존재합니다.
6단계: 최종 렌더링
목표: 프레임을 오디오와 합성하여 최종 비디오 파일을 만듭니다.
렌더링하기 전에 프레임 결과를 미리 볼 수 있는 옵션을 사용자에게 제공하십시오. 전체 실행을 실행하기 전에 최종 제품의 스냅샷을 제공하십시오. 이것은 사용자 게이트입니다: 렌더링하기 전에 승인을 받으십시오.
# 조립 명령 실행
npx hyperframes assemble . --out-dir ./renders
조립이 완료되면, 생성된 비디오가 renders/video.mp4에 있어야 합니다. 출력을 확인하고 비디오 파일이 있는지 확인하십시오.
# 출력 확인
ls -la ./renders/video.mp4
비디오가 성공적으로 생성되면, 오디오와 프레임의 성공적인 조립을 확인하십시오. 생성된 비디오의 경로를 사용자에게 제공하십시오.
게이트: renders/video.mp4가 존재하며 유효한 비디오 파일입니다.