/video-setup
워크벤치를 새 클론에서 passed N, failed 0 상태로 한 번에 만듭니다. setup.sh가 작업을 수행합니다. 여러분의 역할은 이를 설명하고, 동의를 얻고, 실행하고, 모든 FAIL 줄을 수정하는 것입니다.
먼저 워크벤치를 찾습니다(워크벤치나 제품 폴더에서 모두 작동합니다):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
사용자와 그들의 언어로 대화하세요. 간결하게 유지하십시오. 사용자는 둘러보기가 아닌 작동하는 설정을 원합니다.
check 인자 사용 시
bash "$PVS_HOME/setup.sh" --check를 실행하고 결과를 보여줍니다. 아무것도 설치하지 않고, 다운로드하지 않으며, 아무것도 쓰지 않습니다. 각 FAIL 줄에 대해 해당 줄 끝에 표시된 수정 방법을 제시하십시오. 거기서 멈춥니다.
그 외의 경우
1. 머신 보고
먼저 bash "$PVS_HOME/setup.sh" --check를 실행합니다. 각 항목당 한 줄씩 ok, warn 또는 FAIL과 정확한 수정 방법을 출력합니다.
- Machine 아래의 줄이 실패하면(node 22+, python 3.9+, ffmpeg, git), 설정을 계속할 수 없습니다. 줄에서 수정 방법(예:
brew install ffmpeg)을 사용자에게 알려주고 사용자의 터미널에서 실행하도록 요청한 후, 점검을 다시 실행하도록 하십시오. 시스템 패키지 설치는 사용자의 몫이므로, 사용자가 요청하지 않는 한brew나apt를 직접 실행하지 마십시오. - Claude Code의
warn은 정보 제공용입니다. - Toolchain 아래의 FAIL 줄은 setup이 설치할 항목입니다. 첫 번째 실행에서는 예상된 결과입니다.
2. 다운로드될 내용을 알리고 한 번 묻기
사용자에게 점검에서 누락된 것으로 보고된 항목만 짧은 목록으로 알립니다:
| 항목 | 크기 | 위치 |
|---|---|---|
| 고정된 버전의 HyperFrames CLI와 종속성 | 약 128 MB | node_modules/ |
| HyperFrames가 렌더링하는 Chrome 빌드 | 약 195 MB (캐시된 경우 생략) | HyperFrames 캐시 |
| 동일 릴리스 태그의 HyperFrames 에이전트 스킬 | 수 MB | vendor/hyperframes/skills/ |
| Python 패키지(주로 음성-텍스트용 torch) | 약 339 MB | .venv/ |
QA에서 사용하는 whisper small.en 음성 모델 | 484 MB | ~/.cache/whisper/ |
한 가지 폐쇄형 질문을 합니다: "지금 설치하시겠습니까? (예 / 아니오)". 설정은 첫 번째 /video-setup에서 한 단계로 이루어져야 하므로, 여러 번 확인으로 나누지 마십시오.
3. 실행
'예'인 경우 bash "$PVS_HOME/setup.sh" --yes를 실행합니다(--yes는 이미 주어진 사용자의 답변입니다). 첫 번째 실행 시 몇 분이 걸리고 모든 것이 캐시된 경우 몇 초가 소요됩니다. 최소 10분의 타임아웃을 사용하십시오. 이 명령은 멱등성을 가집니다. 다시 실행해도 누락된 부분만 다시 수행합니다.
4. 각 FAIL 처리
모든 FAIL 줄은 해당 수정 방법을 명시합니다. 일반적인 경우:
| FAIL | 조치 |
|---|---|
npm install failed | 네트워크 또는 레지스트리 문제. 로그의 마지막 몇 줄을 보여주고 setup을 다시 실행하십시오 |
hyperframes browser ensure failed | 워크벤치에서 npx hyperframes browser ensure --force를 실행한 후 setup을 다시 실행하십시오 |
could not clone heygen-com/hyperframes | 네트워크 또는 GitHub 접근 문제. git ls-remote https://github.com/heygen-com/hyperframes를 확인한 후 setup을 다시 실행하십시오 |
python3 -m venv failed | Debian 또는 Ubuntu: sudo apt install python3-venv (사용자가 실행) |
pip install -r requirements.txt failed | 로그의 끝부분을 보여주십시오. 고정된 버전보다 최신 Python은 최신 wheel이 필요할 수 있습니다. 고정 버전을 수정하지 말고 보고하십시오 |
hyperframes doctor: ... | 줄은 실패한 점검과 그 수정 방법을 명시합니다. 버전, Docker 및 선택적 로컬 음성 및 음악 점검은 의도적으로 무시됩니다 |
tests/run.sh: passed N, failed M | bash "$PVS_HOME/tests/run.sh"를 실행하고 실패한 테스트와 그 출력을 보여주십시오 |
hyperframes upgrade 또는 hyperframes skills update를 실행하여 FAIL을 "수정"하지 마십시오. 워크벤치는 하나의 HyperFrames 릴리스를 고정하고 동일한 태그에서 스킬을 가져옵니다. CLI와 스킬이 다른 릴리스에서 오면 구성 계약이 일치하지 않기 때문입니다. 버전 변경은 tests/run.sh를 통과하는 풀 리퀘스트로 이루어집니다. 가드 훅은 두 명령을 모두 차단합니다.
5. 음성 키
Setup은 .env.example에서 .env를 생성하고 ElevenLabs 키가 설정되었는지 출력합니다(키 자체는 출력하지 않음). 키가 비어 있으면 사용자에게 알립니다:
- 워크벤치 폴더에 있는
.env를 사용자 자신의 편집기에서 열고ELEVENLABS_API_KEY=뒤에 키를 붙여넣으십시오. 채팅에서 절대 하지 마십시오. 채팅의 모든 내용은 기록에 저장됩니다. 사용자가 여기에 붙여넣으면 키를 교체하라고 알리십시오. - 키가 없으면 제품의
product.yaml에서voice.provider: say가 무료 macOS 음성을 사용합니다. 초안 및 테스트에는 충분합니다.
절대 .env를 열거나 읽거나 출력하지 마십시오. 설정이 이를 금지하고 가드 훅이 차단하며, 스크립트는 lib/pvs.py를 통해 키를 자체적으로 로드합니다.
6. 마무리
출력의 마지막 줄에 passed N, failed 0 및 Setup done이 있는지 확인하십시오. 그런 다음 다음 단계를 한 줄로 제시하십시오: /product-new <slug>로 제품을 가져오거나, /video-ask로 현재 상태를 확인하십시오.