설명 영상(Explainer video)
레포지토리 루트에서 uv run으로 작업합니다. README.md에 명령어와 파일 형식이, EDITORIAL.md에 표준 규칙이 있습니다. 다음은 작업 순서이며, 사용자의 체크포인트가 표시된 단계입니다.
0. 영상의 시작, 대화
영상은 소유자가 생각하는 바를 검증한 결과에서 나오며, 주제 목록에서 나오지 않습니다. 조사 전에 먼저 소유자와 인터뷰하세요.
- 한 번에 한두 개의 질문을, 평범한 대화 형식으로, 짧게 하세요. 소유자는 받아쓰기로 답변하며, 한 번에 다섯 개는 너무 많아 답하거나 기억하기 어렵습니다. 여러 라운드에 걸쳐 다양한 유형의 질문을 섞으세요: 개방형 질문("각 측이 무엇을 보호하고 있나요?"), 당신이 답을 찾기 전에 소유자에게 추측하게 하는 퀴즈("얼마나 될 것 같나요?"), 스틸맨 테스트("상대방의 주장을 그들이 서명할 수 있을 정도로 제시해 보세요"), 그리고 미끼: 소유자가 방금 말한 것에 대한 가장 강력한 반론을 노골적으로 제시하세요. 다음 질문 목록을 따르지 말고, 당신을 놀라게 한 답변을 따라가세요.
- 소유자의 잘못된 추측은 화면에 나올 수 있습니다. 소유자가 이에 동의했습니다. 그러나 숫자는 소유자가 추측으로 제시한 경우에만 추측입니다. 예시 안의 숫자("그들이 수입의 70%를 고정비에 쓴다면...")는 설명을 위한 것입니다: 그렇게 기록하고, 절대 점수를 매기거나 추측으로 표시하지 말며, 어떤 경우인지 명확하지 않으면 물어보세요.
- 답변 아래에 숨은 주장을 들어보세요: 틀릴 수 있는 명제, 소유자가 계속 강조하는 구분, 자신의 이야기 같은 것. 그것들이 바로 영상입니다. "낙태"라는 주제는 아이디어가 아닙니다. "양측이 다른 질문에 답하고 있다"는 것이 아이디어입니다.
- 소유자의 말을 그대로 보존하세요. 답변을 원문 그대로 날짜와 함께
notes/<주제>.md에 저장하세요. 이 파일은 git에서 무시됩니다: 노트는 날것이고 비공개이며, 대본이 공개된 형태입니다. 자신의 요약은 여러분의 것이라고 표시하세요. - 대본에 필요한 기준으로 소유자가 말한 것을 분류하세요. 확인할 수 있는 것은 조사로 넘어가고, 그다음
fact,estimate또는view비트가 됩니다. 소유자의 개인적인 것은opinion또는speculation이 됩니다. 더 나아가기 전에 함축된 단어를 정확히 짚으세요("설계된": 누가, 어떻게 알 수 있나요?), 그리고 출처가 소유자가 믿는 것을 뒷받침하지 않을 때는 분명히 알려주세요. - 하나의 명제(thesis), 그것을 전달하는 세네 가지 전개, 그리고 그것에 대한 가장 강력한 반론이 나오면 멈추세요. 몇 줄로 요약해 다시 말해보고, 조사에 들어가기 전에 동의를 얻으세요.
소유자는 현재 작동 방식을 원합니다. 어떤 것이 어디서 왔는지는 영상 안에서 짧은 삽입일 뿐, 영상 자체가 아닙니다.
1. 대본 전, 조사
- 영상이 답하는 질문을 한 문장으로 정하고, 시청자가 이후에 말할 수 있어야 하는 세네 가지를 정하세요.
- 사실 시트(fact sheet)를 작성하세요: 한 줄에 하나의 주장, 각 주장마다 이번 세션에서 가져와 읽은 출처와 이를 뒷받침하는 구절을 포함하세요. 첫날부터 출처는
videos/NAME/sources.toml에 보관하세요(해당 파일만 있는 폴더는 조사 중이거나 보류 중인 영상입니다). 주장은notes/NAME.md에 보관하세요. 하위 에이전트에서 조사하는 것은 괜찮지만, 원문 인용문을 반환하고 뒷받침할 수 없는 것은 표시하라고 지시하세요. 에이전트가 열지 않은 URL은 절대 수락하지 마세요. - 논쟁이 되는 주제의 경우, 각 측의 주장을 해당 측의 가장 강력한 옹호자로부터 수집하고, 어떤 의견 차이가 사실에 관한 것이고 어떤 것이 가치관에 관한 것인지 기록하세요.
- 출처가 뒷받침하지 않는 것을 기록하세요. 대중적인 버전의 이야기는 증거보다 더 깔끔한 경우가 많습니다.
2. 대본 (체크포인트: 사용자가 승인)
python -m explainers.new NAME(이미 있는sources.toml을 기반으로 채웁니다), 그다음script.md.- 영상은 12분에서 25분 사이입니다: 소유자의 읽기 속도(약 분당 175단어, 쉼 포함)로 약 2,100에서 4,400단어입니다. 시청자가 전환을 느낄 수 있는 섹션으로 나누고, 각 섹션은 자체 질문을 가져야 합니다.
- 한 비트(beat)에 하나의 아이디어, 한 비트는 한 번의 숨: 15에서 40단어. 귀로 듣기 좋게 쓰세요: 짧은 문장, 중요한 단어를 마지막에, 청취자가 기억할 수 있도록 숫자는 반올림, 대괄호나 약어 없이.
- 인사말이 아닌 질문이나 놀라움으로 시작하세요. 각 섹션은 시청자가 다음 섹션을 보고 싶게 만들어야 합니다.
- 자신이 얼마나 확신하는지가 아니라 문장이 약속하는 내용으로 레이블하세요. 여러 종류를 섞은 비트는 분할하세요. 대부분
fact와view로 구성되고 몇 개의 명확히 표시된opinion비트가 있는 대본이 목표입니다.check는 분할 비율을 출력합니다. - 논쟁이 되는 질문에 대해 채널의
opinion을 직접 작성하지 마세요. 표시된 빈칸을 남기거나, 초안을 작성하고 사용자가 수락, 변경 또는 삭제할 수 있는 초안임을 명확히 말하세요. - 각 섹션 아래에
>노트로 화면에 무엇이 나오는지 표시하세요. 모든 비트는 최소 5초마다 바뀌는 그림이 필요합니다. python -m explainers.check videos/NAME --urls가 통과해야 합니다. 분할 비율과 출처 목록과 함께 대본을 사용자에게 보여주세요.
3. 음성 (체크포인트: 사용자가 녹음)
- 합성음으로 초안을 만드세요:
python -m explainers.narrate videos/NAME.say.txt에서 추측한 단어를 수정하세요. 그림이 자리잡는 데 시간이 필요한 비트에는pause를 추가하세요. 이 초안 위에서 그림을 만들고 대본을 확정할 수 있습니다. - 문구가 확정되면, 사용자가 자신의 터미널에서 녹음합니다:
python -m explainers.record videos/NAME은 각 비트를 표시하고, 녹음하며, 테이크의 레벨과 대본 단어를 확인합니다.--room은 빈 방을 한 번 녹음하여 공백에 사용합니다. 그다음narrate를 다시 실행합니다: 새 테이크가 있는 곳마다 그 테이크를 사용합니다. 그림은 단어 단위로 큐를 찾기 때문에 해당 단어에 유지되지만, 비트 길이는 달라집니다: 렌더링 전에sweep을 실행하고 연락처 시트를 확인하세요. - 사용자가 단어 하나하나를 읽을 필요는 없습니다. 테이크가 대본을 벗어난 경우,
record는 차이점을 보여주고, 사용자가 그대로 두기로 하면 script.md의 비트를 그들이 말한 대로 다시 씁니다. 따라서 사용자가 녹음하기 전에 대본을 커밋하고, 그다음git diff를 읽어보세요: 새 단어의 철자와 구두점을 정리하세요(이것은 테이크를 무효로 만들지 않습니다). 변경된 모든fact,estimate,view비트에 대해 출처의 인용문을 새 단어와 비교하여 읽어보세요. 더 이상 뒷받침하지 않는다면 사용자에게 알리세요: 해당 비트는 다시 읽거나 레이블을 변경해야 하며, 그대로 두지 마세요. - 녹음된 비트를 직접 다시 쓰면 사용자가 다시 읽어야 합니다. 이러한 변경은 모아서 먼저 요청하세요.
--audition VOICE ...는 초안에 사용할 합성음을 비교합니다. 대본의voice:줄이 하나를 선택합니다.
4. 그림
- 템플릿의
video.py로 시작하여 장면별로 교체하세요. 보통 각 섹션당 하나의 장면이 적절한 단위입니다.theme.scenes로 장면을 전환하세요. - 영상은 세트(
explainers/sets.py)에서 진행됩니다: 지금까지는 프로젝터 화면이 있는 교실이며, 이것이 소유자가 요청한 것입니다. 차트, 카드, 또는 그림을 슬라이드(1920x1080 그림)로 그리고 세트에 제공하세요: 동일한 슬라이드가 와이드 샷에서는 화면에 있고, 카메라가 확대되면 프레임을 채웁니다(sets.shots로 이동). 슬라이드를 읽어야 할 때는 확대하고, 진행자가 무언가를 할 때는 축소하며, 진행자가 의견을 말하기 위해 앞으로 나올 때는 프로젝터를 끕니다(on). 칠판에 섹션 제목을 적고(chalk), 레이블에는plate를 주어 방 전체에서 읽을 수 있게 하세요. 대본의>노트에 "Wide" 또는 "Projector"라고 표시됩니다. 다른 세트도 추후 추가될 예정입니다: 슬라이드는 방과 독립적으로 유지하세요. - 모든 동작은 큐에 연결하세요:
N.at(beat, word). 절대 시간을 초 단위로 입력하지 마세요. - 무언가를 설명하는 동안 진행자는 작게 한쪽에 있고, 스스로 말할 때(오프닝, 의견, 클로징)는 크게 나타납니다. 말하는 대상을 보고 가리킵니다.
- 차트, 그래프, 수학 관련 내용은 manim
Insert에 넣으세요. 그 외 모든 것은 Skia입니다. - 논쟁의 양측은
theme.SIDE_A/theme.SIDE_B입니다. 차트가 그리는 데이터셋은 출처와 날짜와 함께 영상의data/에 저장하세요. - 반복: 섹션을
preview하고, 시트를 보고, 수정하고, 반복합니다. 모든 렌더링 전에sweep을 실행하세요.
5. 렌더링 및 전달 (체크포인트: 사용자가 시청)
python -m explainers.render videos/NAME --fresh, 그다음python -m explainers.describe videos/NAME.- 팩트 체크된 부분과 그렇지 않은 부분, 레이블이 판단에 의존한 비트, 음성이 이상하게 발음되는 부분을 보고하세요.