체크리스트-오버레이
왼쪽에 화면 녹화, 오른쪽에 체크리스트. 각 항목은 화면에서 해당 단계가 발생하는 순간에 체크됩니다. 마지막 체크 후 영상은 완전히 체크된 리스트를 표시하며 멈춥니다.
입력
| 입력 | 설명 |
|---|---|
| 녹화 영상 | 하나의 로컬 비디오 파일, 이상적으로는 16:9. 무음도 괜찮습니다. |
| 단계 | 3{ "label": "...", "at": <녹화 시작 후 초> }. 레이블은 짧은 명령형 문구 (약 2 |
| 제목 | 한 줄. 결과를 말하세요 ("5단계로 에이전트에 스킬 추가하기"). |
| 부제목 | 선택적 한 줄. |
| 색상 팔레트 | 선택적 16진수 재정의: bg, surface, panel, ink, muted, accent, border, accentInk. 기본값은 주황색 악센트가 있는 어두운 테마입니다. accent 위에서 읽을 수 있도록 accentInk를 충분히 어둡게 유지하세요. |
사용자가 타임스탬프를 제공하지 않은 경우, 녹화 영상을 스크러빙하여(ffmpeg로 1~2초마다 프레임 추출, 시각적 검사) 각 단계가 완료되거나 진행 중인 첫 프레임을 선택하세요. 추측하지 마세요.
워크플로우
- 프로젝트 계약을 위해
/hyperframes,/hyperframes-core,/hyperframes-cli를 로드합니다. spec.json을 작성합니다:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "앱 열기", "at": 1.5 }, { "label": "검색", "at": 7.9 } ] }- 프로젝트 디렉토리로 구성을 생성합니다:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]이 명령은 녹화 영상을 복사하고, 마지막 프레임을 추출하여(녹화 종료 후 화면 고정), 녹화 영상 크기에 맞춰index.html을 작성합니다. 총 길이 = 녹화 길이 + 홀드 시간 (기본값 2.2초). npx --yes hyperframes check가 0개의 오류와 0개의 경고로 통과해야 합니다.- 검증(아래 참조) 후 렌더링:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.
타이밍 규칙
- 체크 표시는 단계 시점에 정확히 나타나며, 절대 먼저 나타나지 않습니다. 채우기 및 체크 그리기는
t = at에서 시작되며, 그리기는 약 0.3초 후에 완료됩니다.at이전에는 어떤 항목도 체크된 것처럼 보여서는 안 됩니다. - 타임스탬프는 녹화 시간 기준이며 녹화는 컴포지션 시간 0에서 시작하므로
at을 그대로 사용합니다. 녹화를 트리밍하는 경우 모든at을 동일한 양만큼 이동하세요. - "다음 단계" 개요는 이전 체크 직후 다음 항목에 나타날 수 있습니다. 개요만 표시되며, 채우기나 체크 표시는 안 됩니다.
- 각 체크가 식별될 수 있도록 체크 간격을 최소 1.5초 이상 유지하세요. 두 단계가 너무 가까우면 병합하세요.
- 마지막 체크는 녹화 종료 최소 1.5초 전에 위치하거나,
--hold를 늘려 완료된 리스트가 2초 이상 표시되도록 하세요. - 카운터 (
n / N), 진행률 표시줄 및 프레임 링 펄스는 모두 동일한at값을 기준으로 하여 동기화를 유지합니다.
레이아웃 (16:9 녹화)
1920x1080 캔버스, 56px 여백. 제목과 부제목은 상단에; 녹화 프레임은 히어로로 약 1250px 너비(전체 너비의 약 65%); 체크리스트 패널은 오른쪽에 520px 열로, 프레임과 동일한 높이를 가지며 항목은 높이를 균등하게 나눕니다. 이렇게 하면 녹화 내 UI 텍스트를 읽을 수 있습니다. 프레임 너비를 약 1100px 이하로 줄이지 마세요. 더 높은 비율의 녹화의 경우 생성기가 종횡비에 따라 프레임 크기를 조정합니다. 16:9가 아닌 녹화의 경우: 프레임이 여전히 헤더 아래에 맞는지 확인하거나, 먼저 녹화를 크롭하세요.
레이블은 32px에서 두 줄로 줄바꿈됩니다. 약 26자를 초과하지 않도록 유지하세요.
검증
렌더링된 final.mp4에서 수행하세요. 스냅샷만으로는 충분하지 않습니다.
- 각 단계에 대해
at0.08초 전과 0.45초 후의 프레임을 하나씩 추출합니다:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png. - 프레임을 확인합니다. 이전: 항목 미체크, 카운터 i-1. 이후: 항목 채워짐 및 체크 표시, 카운터 i, 진행률 표시줄 전진.
- 마지막 홀드 구간(종료 약 0.2초 전)에서 프레임 하나를 추출합니다: 모든 항목 체크됨, 카운터
N / N, 막대 가득 참. - 녹화 텍스트가 프레임 내에서 읽을 수 있고 레이블이 잘리지 않는지 확인합니다. 그렇지 않은 경우
spec.json또는 팔레트를 수정하고 재생성합니다. ffprobe로 파일을 확인합니다: 1920x1080, h264, 지속 시간 = 녹화 + 홀드.
전달
final.mp4의 경로, 지속 시간 및 사용된 단계 타임스탬프를 보고합니다. 프로젝트 디렉토리(index.html, assets/, spec.json)를 유지하여 다른 레이블이나 팔레트로 영상을 재생성할 수 있도록 합니다. 사용자가 Studio에서 편집하려는 경우 먼저 npx hyperframes preview를 엽니다.