더 리허설 (The Rehearsal)
회의를 예측한 다음, 실제 회의 전에 사용자가 그 내용을 듣고, 보고, 넘겨볼 수 있도록 합니다.
| 출력물 | 파일 | 설명 |
|---|---|---|
| 예측 | script.md | 예상되는 대화 내용 (한 턴에 한 줄씩, 슬라이드 마커 포함) |
| 음성 트랙 | out/rehearsal.mp3 | 각 측면을 대표하는 두 명의 목소리 |
| 비디오 | out/rehearsal.mp4 | 각 발언 섹션별 슬라이드, 오디오에 맞춰 동기화, 자막 포함 |
| 자막 | out/rehearsal.srt | 화자 이름이 포함된 문장 단위 캡션 |
| 프레젠테이션 | out/deck.html | 오프라인에서 넘겨볼 수 있는 덱; 각 섹션의 정확한 대사 표시 |
아래 경로는 이 스킬 폴더를 기준으로 합니다. 사용자 본인의 프로젝트 폴더(script.md, slides/, out/)에서 작업하십시오.
1. 회의 정보 수집
무엇이든 작성하기 전에 다음 정보를 수집하십시오: 상대방 (역할, 배경, 담당 업무), 회의 목표, 시간 및 형식, 사용자 자신의 정보 (이력서, 수치, 계획, 승인된 답변), 그리고 상대방이 집중적으로 물어볼 만한 사항. 사용자가 이미 가지고 있는 자료 (통화 시트, 계획, 연구 자료, 이메일, 직무 설명)를 읽으십시오.
스크립트를 바꿀 만한 사실만 물어보십시오. 사용자가 자신의 경험에서 답해야 하는 질문은 준비(Prepare) 항목이 됩니다. 절대 그 답을 지어내 채우지 마십시오. 리허설은 사용자의 대사가 진실할 때만 가치가 있습니다: 리허설에서 자신 있게 지어낸 숫자는 실제 회의에서 지어낸 숫자가 됩니다.
2. 대화 예측
references/script-format.md의 형식에 따라 script.md를 작성하십시오.
- 실제 회의 순서대로 정리하십시오: 인사, 상대방의 프레이밍, 사용자의 배경 설명, 심층 질문, 사용자의 계획 또는 피치, 까다로운 질문, 실무 사항, 사용자의 질문, 마무리.
- 상대방의 대사는 예측입니다. 스크립트 헤더에 그렇게 명시하십시오. 상대방 회사에 대한 사실을 지어내야 할 경우, 상대방의 대사를 일반적인 수준으로 유지하십시오 (예: "조건을 공유할 수 없습니다").
- 사용자의 대사는 사용자가 제공한 사실이나 소유한 문서에만 근거하며, 승인된 표현이 있을 경우 그대로 사용하십시오.
- 먼저 답하고, 예를 하나 들고, 멈추십시오. 대부분의 회의에 답변당 1~3문장이 적합합니다.
- 사람들이 말하는 방식대로 숫자를 작성하십시오 (예: "500만", "161퍼센트") 그래야 음성이 자연스럽게 읽습니다.
- 각 발언 섹션이 시작되는 턴 앞에
<!-- slide: id -->를 넣으십시오. 보통 질문 하나당 한 섹션입니다. - 파일 끝에 준비(Prepare) 목록을 추가하십시오: 사실로 답할 수 없었던 질문들입니다.
선택적으로 미디어 생성 전 스트레스 테스트: 한두 명의 검토자가 상대방과 상대방의 상사 역할을 맡아 (서브 에이전트로 시작 가능) 사용자의 답변이나 계획을 비판하게 할 수 있습니다. 사실이 뒷받침하는 변경 사항은 적용하고, 나머지는 사용자에게 목록으로 전달하십시오.
3. 음성 생성
pip install -r requirements.txt # edge-tts, pydub; ffmpeg는 설치되어 있어야 함
python scripts/make_audio.py script.md out --voice "Dana=en-US-AvaNeural" --voice "Sam=en-US-AndrewNeural"
두 측면에 명확히 다른 목소리를 지정하십시오 (edge-tts --list-voices 명령어로 목록 확인). 스크립트는 out/rehearsal.mp3와 자막용 문장 타이밍이 포함된 out/timeline.json을 작성합니다. Edge는 요청을 무작위로 몇 개 드롭합니다. 스크립트가 자동으로 재시도합니다.
4. 발언 섹션별 슬라이드 제작
모든 슬라이드 마커에 대해 references/slide-format.md의 형식에 따라 slides/<id>.html을 작성하십시오. 각 슬라이드는 해당 섹션을 그림으로 전환합니다: 질문을 제목으로, 답변을 타임라인, 번호 단계, 비교, 실제 숫자의 막대 차트, 결정 경로 또는 용어 표 등으로 표현합니다. 슬라이드의 <aside> 발표자 노트에 대화 내용을 그대로 넣으십시오. 사용자가 주의해야 할 부분 (예: "준비: '예'에서 서명까지의 기간")마다 콜아웃을 추가하십시오. 덱은 학습 보조 자료로도 사용되기 때문입니다.
5. 비디오 및 덱 렌더링
python scripts/render_video.py slides out --fonts "https://fonts.googleapis.com/css2?family=..."
python scripts/build_deck.py slides out --fonts "https://fonts.googleapis.com/css2?family=..." --title "리허설: <회의명>"
render_video.py는 Google Chrome 또는 Chromium (찾을 수 없는 경우 CHROME= 설정 필요)과 libass로 빌드된 ffmpeg가 필요합니다. --fonts는 슬라이드가 사용하는 하나의 Google Fonts URL입니다. 슬라이드가 시스템 폰트를 사용하는 경우 생략하십시오. Slides 아티팩트 유형을 사용할 수 있는 경우, 동일한 슬라이드 파일을 공유 가능한 덱으로 게시할 수 있습니다.
6. 확인 후 전달
- 슬라이드당 한 프레임씩 추출 (
ffmpeg -ss <초> -i out/rehearsal.mp4 -frames:v 1 frame.png)하여 확인하십시오: 텍스트가 상자 안에 있고, 자막 밴드 아래에 아무것도 없으며, 폰트가 로드되었는지 확인합니다. - 비디오 길이가 오디오 길이와 일치하는지 확인하십시오.
- 파일과 함께 다음 세 가지 주의사항을 명확히 전달하십시오: 상대방의 대사는 예측입니다. 준비 목록에는 사용자 자신의 사실이 필요합니다. 스크립트 텍스트가 Microsoft의 음성 서비스로 전송되었습니다.
개인정보 보호
edge-tts는 스크립트 텍스트를 Microsoft의 음성 서비스로 전송합니다. 오디오를 생성하기 전에 스크립트에 민감한 정보 (급여, 건강, 미발표 거래 또는 이름)가 포함되어 있는지 사용자에게 알리고 음성 버전에서 제외할 것을 제안하십시오. API 키나 유료 서비스는 사용되지 않습니다.
파일
scripts/make_audio.py- 시간이 동기화된 두 목소리 MP3 및timeline.json생성 스크립트scripts/render_video.py- 슬라이드와 오디오를 자막이 포함된 MP4 및 SRT로 렌더링하는 스크립트scripts/build_deck.py- 슬라이드를 오프라인에서 넘겨볼 수 있는deck.html로 빌드하는 스크립트references/script-format.md-script.md작성 방법references/slide-format.md- 슬라이드 작성 방법