플러그인 설치: 설정 또는 최신 상태 확인 명령 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따르십시오. 독립 설치의 경우 아래 업데이트 지침을 유지하십시오.
먼저, 이 스킬을 최신 상태로 유지하십시오 — 사용자에게 확인 후 실행:
npx hyperframes skills update pr-to-video. 모든 것이 최신 상태이면 빠른 no-op입니다. 그렇지 않으면 이 스킬과 이에 의존하는 핵심 도메인 스킬을 업데이트합니다.
media-use: 오디오/이미지/로고를 소싱하기 전에
/media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인하십시오. 기존 자산을 등록하려면--adopt를 먼저 실행하십시오./media-use스킬을 참조하십시오.
PR to HyperFrames
이 스킬을 사용하여 GitHub 풀 리퀘스트를 가져오고, 변경 사항을 이해하고, 코드 변경 설명자를 계획하고, HyperFrames에서 프레임별로 구축하십시오. 입력은 코드 변경(gh를 통해 읽음)이며, 웹사이트가 아닙니다 — 캡처 단계가 없고 기여자의 아바타 외에 실제 자산도 없습니다.
시작점은
/hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 후에만 계속 진행하십시오. 이 스킬은 GitHub 풀 리퀘스트(코드 변경)를 위한 것입니다. 다른 의도, 단순히 "비디오 만들기", 또는 불확실한 경우 → 먼저/hyperframes를 읽으십시오 — 의도 레이어가 모든 경로 결정을 소유하며,BRIEF.md없이 여기에 도착한 새로운 생성은 어쨌든 이를 거쳐야 합니다(설정의 시작 규칙).
당신은 오케스트레이터입니다. 해결된 외부 PROJECT_DIR에서 작업하고, 기본적으로 호출자 저장소에서는 작업하지 마십시오. 단계를 순서대로 실행하고 각 게이트를 통과한 후에 계속하십시오. 사용자 게이트 단계는 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/extracted/ + assets/<login>.png; 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: 설정
목표: 확인된 브리핑 — PR 참조(전체 URL, <owner>/<repo>#<N> 참조 또는 체크아웃된 저장소의 "this PR") 포함 — 으로 시작하고, HyperFrames 프로젝트를 생성하고, 브리핑을 지속적으로 유지합니다. 스타일은 항상 code-editorial(Step 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를 프로젝트에 복사하고(Step 2는 건너뜀) Step 3 초안을 작성할 스켈레톤을 반환합니다. 레시피는 답변을 채우고 승인은 채우지 않습니다. 검토 게이트는 여전히 실행됩니다.
Setup을 통과하기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status를 실행하고 그 출력을 그대로 전달하십시오. 음성/BGM이 HeyGen 또는 로컬 엔진을 사용할지 여부와 로그아웃 시 로그인 방법을 보고합니다. 한 분기를 적용하십시오:
- 협업: 사용자가 로그인하거나 명시적으로
offline/go를 선택할 때까지 기다리십시오. - 자동: 상태를 명시하고 사용 가능한 로컬 엔진으로 계속 진행하십시오.
오프라인 제공자가 없을 때 필요한 기능을 묵시적으로 생략하지 마십시오. 장애물을 표면에 드러내십시오. 이 결정을 다른 질문에 통합하거나 저장소별 .env에 키를 작성하지 마십시오. 인증 소유권 및 오프라인 폴백: /media-use references/setup-providers.md § 제공자.
게이트: hyperframes.json 및 BRIEF.md가 존재합니다. PR 참조가 브리핑에 캡처되었습니다. 기본 설정 기반 답변이 기록되었습니다(브리핑 계약 § 2). 로그인 상태가 표시되었습니다(로그인했거나 오프라인으로 계속).
Step 1: PR 수집(캡처 없음)
목표: PR의 사실을 가져와 정보 소스로 프로젝트에 통합합니다. 웹사이트 캡처가 없습니다. fetch-pr.mjs는 gh를 결정론적으로 실행합니다 — 페이지가 매겨진 gh api를 통해 파일 목록을 완성하여 큰 PR이 ~100개 파일에서 잘리지 않도록 하고, capture/pr.json + capture/diff.patch만 기록합니다(스크래치 디렉토리 없음). 병합된 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로
# 다운로드하여 클로즈 크레딧에 사용합니다. 최선의 노력; 항상 exit 0입니다.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
--people ./capture/extracted/people.json)
fetch-pr.mjs가 exit 1이면(gh auth / not found / private), 해당 stderr를 보고하고 중지하십시오 — PR 내용을 조작하지 마십시오. ingest.mjs가 exit 1이면, 해당 stderr를 읽고(일반적으로 잘못된 형식의 pr.json), 수정하고, 다시 실행하십시오(결정론적). fetch-people-avatars.mjs는 항상 exit 0입니다. 아바타가 없으면 단순히 작성자에 대한 크레딧 클로즈가 없다는 의미입니다.
people.json은 gh가 이미 이름을 지정한 기여자(PR 작성자, 커밋 작성자, mergedBy)에 대해 name을 전달합니다. 나머지(리뷰어/댓글 작성자/담당자, gh pr view가 항상 순수한 login만 제공)에 대해서는 null입니다. Step 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는 최선의 노력입니다 — 없어도 실패가 아닙니다.
Step 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로 복사하고, 자체 유효성을 검사합니다(매핑이 깨지면 exit 1). exit 0이 되는 즉시 진행하십시오 — 수동 편집하지 마십시오.
게이트: build-frame.mjs가 exit 0입니다 — frame.md가 code-editorial 사전 설정에서 존재하고, .hyperframes/caption-skin.html이 캡션 스킨 소스로 존재합니다.
Step 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에서 설정하십시오 — 대략적인 기대치; 어셈블리는 컷이 이에 대해 어디에 위치하는지 보고합니다.
story-design.md를 PR 아키타입(변경 로그 / 기능 공개 / 수정 설명 / 리팩터링 워크스루), PR 고유 프레임 유형, 훅, 설득, 비트, 프레임별 단어 예산 및 크레딧 클로즈에 사용하십시오. 순서는 내러티브 디자인에서 오며, diff의 파일 순서가 아닙니다 — 변경 사항을 설명하고, diff를 소리 내어 읽지 마십시오. 소프트 가이드로 ../hyperframes-animation/blueprints-index.md의 역할→청사진 메뉴를 참조하십시오: 각 비트에 대해 후보 청사진이 암시하는 모양으로 음성 해설을 작성하고, 하나가 맞으면 해당 후보 blueprint: ID를 태그하십시오(스토리 진실은 여전히 어떤 비트가 존재하는지 결정합니다 — 비트가 모양에 맞도록 강제하지 마십시오). capture/diff.patch의 실제 diff 덩어리 2-4개를 특징으로 하며, 각각 작고 읽기 쉬운 조각입니다. 각 프레임의 scene에서 원하는 code-* 블록의 이름을 지정하십시오. 프레임은 credits 클로즈(1-6 assets/<login>.png 아바타)를 제외하고 asset_candidates를 전달하지 않습니다. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.
초안 작성 후, 검토 루프의 계획 패스를 실행하십시오 — ../hyperframes/references/review-loop.md § 1: 계획을 제안으로 제시하고 두 가지 질문을 하십시오 — 승인 또는 변경, 그리고 스케치 우선(권장) 또는 건너뛰기. 피드백은 채팅 응답으로 도착합니다. 승인될 때까지 반복하십시오. 이것은 체크포인트 게이트(브리핑 계약 § 1)입니다: 자동 모드에서는 물을 것이 없습니다 — 동일한 요약을 예고로 게시하고 진행하십시오. 스케치는 빌드에 통합되고, 하나의 질문이 있는 최종 미리보기는 Step 6에서 제공됩니다.
게이트: STORYBOARD.md가 존재하고, 모든 프레임에 필수 내러티브 필드가 있으며, 내레이션이 필요한 경우 SCRIPT.md가 존재하고, 사용자가 계획을 승인했습니다(자동: 요약이 예고로 게시되었습니다).
Step 3.1: 오디오
목표: 승인된 대본에서 내레이션, 단어 타이밍, 음악 및 오디오 메타데이터를 생성합니다.
Step 3 승인 후 오디오를 시작하십시오. 백그라운드에서 실행한 다음 Step 4로 계속 진행하십시오.
호출 전에 사용자의 요청에서 내레이션 음성을 선택하십시오. 요청이 음성, 성별 또는 톤을 지정한 경우 일치하는 음성 ID를 선택하고 --voice <id>와 함께 전달하십시오. 파이프라인 기본값은 그렇지 않으면 HeyGen에서 Marcia (여성) / Kokoro에서 am_michael입니다 — 따라서 "남성 음성"과 같은 요청은 플래그를 전달하지 않으면 자동으로 무시됩니다. 음성 ID는 제공자별로 다릅니다. Step 0의 로그인 상태가 선택한 제공자에 대해 해결하십시오: HeyGen(로그인됨)의 경우 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list(또는 GET /v3/voices?engine=starfish); Kokoro(오프라인)의 경우 <MEDIA_DIR>/audio/references/tts.md의 음성 테이블(접두사 am_/bm_ 남성, af_/bf_ 여성). 사용자가 선호도를 표현하지 않은 경우, 기본값 전에 기억된 음성(브리핑 계약 § 2)으로 대체하십시오.
오디오 생성을 실행하십시오:
(cd "$PROJECT_DIR" && node <MEDIA_DIR>/audio/scripts/build-audio.mjs \
--script ./SCRIPT.md --hyperframes . --voice <선택된_음성_ID>)
스크립트는 SCRIPT.md를 처리하고, 텍스트를 문장으로 분할하고, 각 문장의 타이밍을 생성하고, TTS 엔진을 호출하고, 배경 음악을 선택 및 혼합하고, 모든 것을 audio_meta.json에 기록합니다. 오프라인 모드에서는 로컬 엔진을 사용합니다. 오류가 발생하면 명확한 오류 메시지와 함께 중지하십시오.
게이트: audio_meta.json이 존재하고, 오디오 파일이 생성되었습니다(내레이션 및 배경 음악). 오디오가 Step 6에서 최종 렌더링에 사용됩니다.
참고: 실제 SKILL.md의 나머지 단계(Step 4~6)는 제공된 내용에 포함되어 있지 않지만, 위의 단계를 기반으로 워크플로우가 완료됩니다.