media-use
HyperFrames를 위한 미디어 OS: 해결(resolve) · 생성(generate) · 작업(operate) · 기억(remember) — 모든 미디어 유형을 하나의 스킬로, 제로 컨텍스트 노이즈.
첫 실행: heygen CLI를 설치하고 로그인(무료 사용 경로)한 후, node <SKILL_DIR>/scripts/resolve.mjs --doctor로 확인하세요. 설정 및 제공자: references/setup-providers.md.
해결(Resolve) — 하나의 동사
node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>
한 줄 출력: resolved <id> → <path> (<type>, <metadata>). 모든 검색 노이즈는 디스크에 남습니다.
| 유형 | 한 줄 설명 |
|---|---|
bgm | 배경 음악 (HeyGen 카탈로그, 10,000개 이상 트랙) |
sfx | 음향 효과 (19파일 번들 라이브러리 + 카탈로그) |
image | 사진, 배경 이미지 (HeyGen 자산 검색, 75,000개 이상 벡터) |
icon | 아이콘, 심볼 (투명) |
logo | 공식 브랜드 마크 (svgl → simple-icons → GitHub 아바타 → favicon 절대 다시 그리지 않음) |
voice | TTS 음성 해설 (HeyGen 무료 사용 경로, 선택적 로컬 Kokoro) |
grade | 측정 기반 보정 후보; 광범위한 다듬기/스타일화는 Media Treatments 참조 |
lut | 사용자 제공 또는 명시적으로 선택된 재사용 가능한 검증된 .cube 파일 |
새로 해결하기 전에 --candidates 플래그로 재사용 가능한 후보를 나열하고 직접 적합성을 판단하세요 — 재사용 규칙, 모든 플래그, 수집(--from), 채택에 대한 자세한 내용은 references/resolve.md를 참조하세요.
광범위한 시각적 피드백을 미디어 인텐트로 처리
사용자가 사진 미디어의 수정, 다듬기, 스타일화, 흐리게 처리, 강조, 공개를 명시적으로 요청하면, 컬러 그레이딩이나 효과 이름을 언급하지 않더라도 references/media-treatments.md를 읽으세요. 실제 <img>/<video>를 검사하고, 하나의 기본 인텐트를 선택한 후 결정론적 지속성과 검증을 사용하세요. 선택적 테스트 시드로 일치하는 레시피를 사용하거나 hyperframes media-treatment --capabilities --json을 검사한 후 --capability <id>로 관련 효과군을 요청하고 정식 컨트롤로 커스텀 트리트먼트를 조립하세요. 일반 편집 작업에서는 --all을 로드하지 마세요. 트리트먼트는 보정, 프리셋, 마무리, 호환되는 셰이더 효과, 지원되는 키프레임, 선택적 Registry 오버레이를 구성할 수 있습니다. 소스에 정당화된 범위 내 튜닝과 호환되는 부분만 추가하고, 단지 결과를 더 정교하게 보이게 하기 위한 효과는 추가하지 마세요. 최종 결합 페이로드는 hyperframes media-treatment로 지속하세요.
점진적으로 확장되는 워크플로우를 사용하세요. 비디오의 경우 개별 프레임을 읽는 대신 초기/중간/후반의 라벨이 지정된 콘택트 시트 하나를 검사하세요. 일반 보정 또는 다듬기의 경우 후보 하나를 적용하고 결과 시트를 하나 검사하세요. 결과가 모호하거나, 시간적이거나, 스타일화되었거나, LUT 기반이거나, HDR/LOG에 민감하거나, 비공개이거나, 브랜드에 중요한 경우에만 개별 프레임이나 움직이는 드래프트 증거로 확장하세요.
일반 보정 또는 다듬기의 경우 최종 트리트먼트의 프리셋/조정 JSON을 지속하세요.
노출, 그림자, 대비, 웜스만을 인코딩하기 위해 .cube LUT를 생성하지 마세요. 사용자가 LUT를 제공하거나 선택한 트리트먼트가 명시적으로 LUT를 소유하는 경우에만 LUT를 사용하세요. resolve --type grade --for ... --analyze는 측정 증거일 뿐, 선택한 트리트먼트를 생성된 LUT로 대체할 권한이 아닙니다. 지원되는 비네트, 그레인, 블러, 픽셀화, 색상, 트리트먼트 효과를 CSS/SVG 오버레이로 재현하지 마세요. 이는 Studio 컨트롤과 정식 미리보기/렌더 셰이더 경로를 우회합니다.
적극적으로 대응 — 미디어 기회 스캔 실행
사용자는 어떤 미디어가 작품을 향상시킬지 보통 알지 못합니다. 당신은 알 수 있습니다. 구성을 만들거나 검토할 때 한 번 근거 있는 스캔을 수행한 후 한 번만 질문하세요 — 자동으로 추가하지 말고, 자산마다 반복 요청하지 마세요.
구체적인 신호가 있을 때만 기회를 제시하세요:
| 감지된 신호 | 제안 |
|---|---|
| 화면상 텍스트/스크립트가 있고 음성 해설이 없는 경우 | TTS 음성 해설 (오디오 엔진) |
이모지 또는 아이콘처럼 스타일링된 <div> | 실제 icon 해결 |
| 플레이스홀더, 작거나 확대된 이미지 | 더 나은 image (및/또는 업스케일 — references/operations.md 참조) |
| 하드 컷/전환이 있고 소리가 없는 경우 | 전환 sfx |
| ~10초 이상 지속되는 부분에 배경 음악이 없는 경우 | bgm |
| 노출 부족/과다 또는 색상 캐스트가 있는 영상 | 보정 그레이드 (hyperframes media-treatment --selector '#hero' --analyze --json으로 검사) |
| 시각적으로 평범하거나 주제와 무관해 보이는 사진 미디어 | 하나의 특정 소스 적합 프리셋 또는 커스텀 트리트먼트, 의도된 대상 이름 포함 |
| 정적으로 느껴지는 중요한 미디어 등장/공개 | 하나의 지원되는 시크-세이프 트리트먼트 애니메이션; 요청이 프리셋도 정당화하지 않는 한 색상 유지 |
도움이 되고 방해가 되지 않도록 하는 규칙: 근거 있고 일반적이지 않음 (신호 없음 → 제안 없음); 의견 제시 + 구체적 (기본값이 포함된 특정 수정안 제안 — 사용자는 전체 / 일부 / 없음 승인); 프로젝트당 한 번 (한 번에 통합 요청; "그대로 두기" 존중); 표면화하고 자동 변경하지 않음 (특히 컬러 그레이드: 제안하고 미리보기 — 그레이-월드 "보정"은 의도적인 일몰이나 네온 효과를 망칩니다).
찾아보기 — 작업에 필요한 파일만 읽기
| 작업 | 읽을 파일 |
|---|---|
| 해결/재사용/채택/수집, 플래그, 캐스케이드, 인벤토리 | references/resolve.md |
컬러 그레이딩, LUT, 스마트 그레이드(--for), 그레이드 비교 | references/grading.md |
| 음성 해설/TTS, 음악, SFX, 캡션, 전사 (오디오 엔진) | references/audio.md |
| 기존 미디어 자르기/프레임 변경/변환, 정확한 에러 확산, HEVC | references/operations.md |
| 소스 인지 크리에이티브 트리트먼트, 실시간 효과, 오버레이, 공개 | references/media-treatments.md |
설치 + 인증, 제공자 테이블, RAM 래더, --local-only, --provider | references/setup-providers.md |
| 저장된 환경설정 + 고정 레시피 (사용자 메모리) | references/memory.md |
| 소유권 매트릭스, 사용 통계, 텔레메트리, 개인정보 (유지보수자 대상) | references/meta.md |