교육용 비디오
목소리가 이끌고, 영상은 그 뒤를 따릅니다: 먼저 시나리오와 사운드, 그 다음 슬라이드나 녹화본이 각 대사의 길이에 맞춰 동기화됩니다.
누구와 대화하는가. 사용자는 기술적이지 않을 수 있습니다: 불가리아어(또는 사용자가 작성하는 언어)로, 간단한 말로, 명령어나 경로 없이 말합니다. 단, 사용자가 묻는 경우는 예외입니다. 기술적 단계는 여러분이 수행합니다. 사용자의 결정만 물어보십시오: 내용, 대상, 언어, 비주얼, 승인.
스크립트는 ${CLAUDE_SKILL_DIR}/scripts/에 있으며 python3 -B ${CLAUDE_SKILL_DIR}/scripts/<스크립트>.py ...로 실행합니다. Windows에서는 python3 대신 doctor.py가 "Python 명령" 줄에 알려주는 명령어(python 또는 py -3)를 사용합니다. 슬라이드와 렌더링은 node ${CLAUDE_SKILL_DIR}/deck/render.cjs ...로, 앱 녹화는 ${CLAUDE_SKILL_DIR}/screencast/로 수행합니다. 테마는 ${CLAUDE_PLUGIN_ROOT}/themes/에 있습니다. macOS와 Windows(Bash 및 PowerShell)에서 작동하며, 명령어는 파이프, &&, 리디렉션 없이 간단하게 유지됩니다.
프로젝트는 작업 중인 폴더(제품의 리포지토리 또는 문서 폴더)입니다. 각 프로젝트는 사용자 컴퓨터에만 저장되는 자체 Gemini 키를 가지고 있습니다(Keychain / Credential Manager). 프로젝트의 표시는 .training-video/project.json(id와 이름, 비밀 정보 없음)입니다.
네 가지 승인 — 이 승인 없이 비용과 시간을 낭비하지 않습니다
- 대본(대사 텍스트 및 슬라이드/화면 계획)
- 비용 —
cost.py의 표입니다. 소규모 샘플(최대 3-4개 대사)은 승인이 필요 없지만, 전체 음성 합성은 필요합니다. - 음성 샘플 — 처음 3개 대사(
narrate.py --sample 3); 사용자가 듣습니다. - 비주얼 — 전체 렌더링 전에 준비된 1-2개의 슬라이드 또는 녹화 프레임
진행 단계
- 환경 및 키 — 매번 실행할 때, 다른 모든 작업보다 먼저.
doctor.py <프로젝트>. 누락된 사항이 있으면 사용자 허가를 받아 해당 시스템(brew / winget)에 대해doctor.py가 제공하는 명령어로 수정합니다. 렌더링의 경우, Claude Code가 수행하지 않았다면${CLAUDE_PLUGIN_ROOT}에서npm ci를 실행하고npx playwright install chromium을 실행합니다.- 프로젝트 키:
key.py check <프로젝트>.OK→ 계속 진행합니다.프로젝트 없음→ 사용자에게 폴더에 작은 파일.training-video/project.json(프로젝트 이름과 번호, 비밀 정보 없음 — git에 포함 가능)이 생성된다고 알리고 프로젝트 이름을 물어보십시오(폴더 이름 제안). 그런 다음 마법사를 시작합니다.키 없음→ 기존 공통 키가 있다고 표시되면 "지금까지 사용하신 Gemini 키를 이 프로젝트에도 사용하시겠습니까?"라고 물어보십시오(예 →key.py setup <프로젝트> --use-legacy). 그렇지 않으면 마법사를 시작합니다.거부됨→--replace옵션과 함께 마법사를 시작합니다.
- 마법사: 먼저 간단히 설명합니다: "Google AI Studio 페이지가 열립니다. 이 프로젝트의 음성 비용을 지불할 계정에서 키를 생성(Create API key)하고 복사하세요. 그런 다음 키를 붙여넣을 창이 나타납니다. 키는 이 컴퓨터에만 저장됩니다."
key.py setup <프로젝트> [--name "<이름>"]을 실행합니다. 이 명령어는 페이지와 창을 열고, Gemini에서 키를 확인한 후 저장합니다. 채팅에서 키를 요청하지 마십시오 또한 어디에도 키를 작성하지 마십시오. 사용자가 채팅에 키를 붙여넣으면 Google AI Studio에서 키를 삭제하고 새 키를 만들라고 말하십시오. - 기술 사용자는 Vertex(
gcloud auth application-default login및GOOGLE_CLOUD_PROJECT)를 사용할 수 있습니다.GEMINI_API_KEY환경 변수는 모든 프로젝트에 적용되지만 CI 전용입니다.
- 접수 — 스스로 파악하고, 명확하지 않은 것만 물어보십시오.
- 무엇이 있는지: 채팅이나 디스크의 파일/폴더, Google Drive 링크(연결된 Google Drive 커넥터를 통해, 있는 경우), 웹 링크, 제품의 git 리포지토리(그 안에
.training-video/profile.md가 있으면 제품이 비디오 준비가 되었음을 의미합니다). - PDF가 있고
doctor.py가 "poppler (PDF): 없음"이라고 말하는 경우 → 한 가지 질문으로 물어보십시오: "PDF에서 텍스트와 이미지를 추출하려면 작은 프로그램(poppler, 약 35MB)이 필요합니다. 설치하시겠습니까?" "예"인 경우doctor.py의 명령어(brew / winget)를 실행하고, "아니오"인 경우 PDF를 직접 읽고 이미지는 추출하지 않습니다. - 모드: 자료 기반 →
reference/materials.md; 코드 기반(앱 녹화) →reference/code.md. 둘 다 있으면 비디오가 무엇인지 물어보십시오. - 코드 기반 — 어떤 역할인가. 비디오는 앱의 한 역할(운영자, 관리자, 관리자 등)을 대상으로 합니다. 녹화는 그 역할로 로그인하여 해당 역할의 화면만 보여줍니다. 역할은 제품 프로필이나 코드(
reference/code.md, "역할 — 코드에서")에서 가져오고, 준비된 답변 옵션(앱에서 사용하는 레이블)과 함께 질문하십시오. 역할로 조사(survey.cjs)를 마치기 전에는 대본을 작성하지 마십시오. - 한꺼번에 질문하십시오(준비된 답변 옵션 포함): 비디오 대상과 시청 후 습득해야 할 능력; 음성 언어(기본값 불가리아어); 자막 언어; 길이(기본값 3-8분); 테마(
themes/, 기본값 "중립"; 자료에 자체 브랜드가 있으면 해당 테마 제안); 완성된 파일 저장 위치(Drive 폴더 또는 컴퓨터).
- 무엇이 있는지: 채팅이나 디스크의 파일/폴더, Google Drive 링크(연결된 Google Drive 커넥터를 통해, 있는 경우), 웹 링크, 제품의 git 리포지토리(그 안에
- 비디오 폴더 — 플러그인과 제품 리포지토리 외부에 있으며, 기본값은 사용자의 "문서" 폴더:
<문서>/교육용 비디오/<짧은 이름>-<날짜>/(Mac의~/Documents, Windows의%USERPROFILE%\Documents, OneDrive에 있을 수 있음):video.json—{"name": "<출력 파일 이름>", "project": "<프로젝트의 절대 경로>", "lang": "bg", "voice": "Charon", "subtitles": ["bg", "en"], "theme": "neutral", "mode": "materials|code"}—project는 음성 비용을 지불할 키를 나타냅니다. "코드 기반"의 경우"product": "<repo>"및"role": "<역할>"도 추가됩니다.script.json— 대본(형식은scripts/lines.py참조).audio/,timeline.json,final/은 스크립트로 생성됩니다.sources/— 대본 작성에 사용된 자료의 복사본 또는 발췌문(extract.py가 분해)과sources/facts.md(출처가 포함된 사실).
- 대본. 텍스트 규칙은
reference/script.md에 있습니다(어조, 길이,say, 사실). 사용자에게 JSON이 아닌 읽기 쉬운 텍스트(장별)로 보여주십시오. 수정은 사용자가 "좋습니다"라고 말할 때까지 반복합니다. → 승인 1. - 비용.
lines.py <폴더>를 실행한 후cost.py <폴더>를 실행합니다. 표를 보여주십시오. → 승인 2. - 음성 샘플.
narrate.py <폴더> --sample 3을 실행합니다. 사용자에게 세 개의.wav파일 경로를 알려주거나 재생합니다(Mac:open <파일>, Windows:start "" "<파일>"). 어조가 마음에 들지 않으면video.json에서voice를 변경하고(음성 샘플:tts.py --probe --voice <이름>) 반복합니다. → 승인 3. - 비주얼. 모드에 따라: 1-2개의 슬라이드(
reference/materials.md) 또는 녹화 프레임(reference/code.md). → 승인 4. - 전체 음성.
narrate.py <폴더>를 실행합니다. 마지막에 보고서를 출력합니다. 각REDO <id>: ...줄에 대해narrate.py <폴더> --only <id> ...를REDO가 없을 때까지 실행합니다(예외는reference/voice.md참조). - 영상. 모드에 따라 — 슬라이드 렌더링 또는 화면 녹화.
timeline.json과final/<name>.mp4를 생성합니다. - 자막. 각 추가 언어에 대해 각 대사의
text를 직접 번역하여subs/<언어>.json에 저장합니다({"<id>": "번역"}). 동일한 기업 어조를 사용하고, 숫자는 숫자로, 이름은 자료에 나온 그대로 사용합니다. 그런 다음srt.py <폴더> <이름>을 실행합니다. - 검토 —
reference/voice.md, "최종 검토". 모든 항목을 통과하기 전에는 "완료"라고 말하지 마십시오. 통과하지 못한 항목은 직접 알리십시오. - 전달. 사용자가 Google Drive 폴더를 지정하고 Drive 커넥터가 연결된 경우 해당 폴더에 업로드하고, 그렇지 않으면
final/경로를 알려줍니다. 간략히 요약합니다: 길이, 언어, 비용, 확인되지 않은 사항.
어조 — 항상
전문적이고, 기업적이며, 성인 동료를 대상으로 합니다. 제품이 어린이용이더라도 마찬가지입니다. 유치하지 않고, 광고 같지 않으며, "초보자를 위한 설명"이 아닙니다. 자세한 내용은 reference/script.md를 참조하십시오. 대사 간에 음성이 변경되지 않습니다. 하나의 voice, 하나의 스타일, 하나의 온도가 전체 비디오에 유지됩니다(reference/voice.md 참조).