HR 제품 비디오은(는) 무엇을 하나요?
HR을 위한 나레이션 제품 비디오를 코드로 작성하여 사용자 컴퓨터에서 렌더링합니다. 대상은 직원이므로 언어는 전문적이고 평이하며 명확하게 사용하고, 조직의 브랜드 가이드라인을 따릅니다.
이 스킬은 실제 HR 어시스턴트 출시 비디오를 기반으로 구축 및 테스트되었습니다. references/lessons.md의 모든 규칙은 제품 소유자가 제공한 노트에서 비롯되었습니다. 제작 전에 반드시 읽어야 합니다.
먼저 읽어야 할 문서
| 시점 | 읽을 문서 |
|---|---|
| 항상, 스크립트 작성 전 | references/hr-context.md (HR 영역, 대상, 톤, 민감한 주제) |
| 항상, 제작 전 | references/lessons.md (음성, 타이밍, 자막, 발음, QC) |
| 출시 전 | references/qc-checklist.md |
| 나레이션이 없는 3D 또는 모션 중심 작품 | 대신 이 저장소의 motion-design 스킬 |
폴더
| 폴더 | 용도 |
|---|---|
brand/<org>/ | brand.js (색상, 폰트, 로고), 가이드라인 PDF, 로고, 폰트, 인트로 및 아웃트로 비디오 |
references/ | 참고 비디오, 전환 효과, 음악, 사용자가 좋아하는 음성 샘플 |
projects/<name>/ | 하나의 비디오: brief.md, script.js, scenes.js, project.json, assets/, audio/, out/ |
.claude/skills/hr-product-video/engine/ | 장면 엔진 (각 프로젝트에서 편집하지 말고, 필요한 동작은 scenes.js로 복사) |
.claude/skills/hr-product-video/tools/ | 렌더, 음성, 음악, 조립, QC 도구 |
워크플로
한 번에 한 단계씩 작업합니다. 각 단계의 결과를 보여주고 다음 단계 전에 승인을 받습니다. 변경은 초기일수록 비용이 적게 듭니다.
| # | 단계 | 결과물 | 게이트 |
|---|---|---|---|
| 1 | 브리프 | brief.md: 제품, 대상, 채널, 길이, 지역, 승인 사항, 라이브 상태 | 사용자 확인 |
| 2 | 브랜드 | 가이드라인에서 추출한 brand/<org>/brand.js (PDF에서 색상 샘플을 추출하며 추측 금지) | 사용자 확인 |
| 3 | 스크립트 | script.js: 장면, show(자막) 및 say(음성) 텍스트 | 사용자가 문안 승인 |
| 4 | 스토리보드 | 각 장면별 한 줄: 시각, 동작, 화면 내 텍스트 (두 가지 형태가 필요한 경우 모두 포함) | 사용자 승인 |
| 5 | 실제 콘텐츠 | 개인 데이터를 제거한 실제 제품 답변 및 화면 | 사용자 제공, 검토 |
| 6 | 제작 | scenes.js, 검토용 각 장면 스틸 이미지 | 사용자가 스틸 승인 |
| 7 | 음성 | tools/voice.py (단일 테이크), 특이한 단어가 있으면 발음 샘플 | 사용자 청취 |
| 8 | 음악 | 사용자의 라이선스 트랙 또는 tools/music.py | 사용자 청취 |
| 9 | 렌더링 | tools/render.js, tools/assemble.py | |
| 10 | QC | tools/qc.py --transcribe, 콘택트 시트 확인 후 체크리스트 확인 | 확인 후 사용자에게 |
새 프로젝트는 projects/_template을 projects/<name>으로 복사하여 시작합니다.
명령어 (저장소 루트에서 실행)
node .claude/skills/hr-product-video/tools/render.js projects/<name> land --stills 2,8,15 # 스틸 검토
python3 .claude/skills/hr-product-video/tools/voice.py projects/<name> # 음성 + timing.js
python3 .claude/skills/hr-product-video/tools/music.py projects/<name> # 선택 사항, 크레딧 사용
node .claude/skills/hr-product-video/tools/render.js projects/<name> land # 무성 본편 비디오
python3 .claude/skills/hr-product-video/tools/assemble.py projects/<name> land # 최종 비디오
python3 .claude/skills/hr-product-video/tools/qc.py projects/<name> land --transcribe # 검사
불가침 원칙
- 라이브 상태인 것만. 로드맵, 향후 기능, 내부 프로젝트 용어는 금지.
- 실제 제품 출력만. 제품이 제공한 실제 답변을 자르지 말고 보여주세요. 답변을 절대 만들어내지 마세요. 틀리거나, 모순되거나, 추측하고 있음을 인정하거나, 급여 등급이나 기타 민감한 데이터를 노출하는 답변은 모두 버리세요. 표시할 내용을 콘텐츠 소유자에게 확인받으세요.
- 실제 인물 데이터는 금지. 가상의 직원으로 화면을 재구성하세요. 사용자 계정의 이름, 사진, 채팅, 연락처는 사용하지 마세요.
- 브랜드 우선. 조직의 가이드라인이 모든 스타일 아이디어보다 우선합니다 (사용자가 달리 결정하지 않는 한).
- 텍스트가 음성보다 앞서지 않음. 자막과 헤드라인은 해당 단어가 발화될 때 나타납니다.
- 유료 도구는 사용자의 크레딧을 사용합니다. 단계를 실행하기 전에 비용을 알려주세요. 키는
.env파일에 있으며, 커밋되는 파일에는 절대 포함되지 않습니다. - 벤더, 가격, 법률, 제품 기능에 대해 확인 후 진술하세요. 확인되지 않은 내용은 명확히 표시하세요.