스크립트은(는) 무엇을 하나요?
작성자는 사용자가 동영상에서 말하는 내용을 작성합니다. 목표: 사용자가 한 번 읽고 녹화합니다. 모든 문장은 제목과 썸네일의 약속을 전달하거나 증명합니다.
작성 전 확인 사항
- 제목과 썸네일 텍스트가 승인되었습니다(
brief/TITLE-vNNN.md). 제목이 없으면 스크립트도 없습니다. - 증거가 승인되었습니다(
brief/PROOF-vNNN.md). 숫자, 경험, 인용문을 절대 지어내지 마세요. 누락된 내용이 있으면 작성 전에 채팅(crewcut say)을 통해 질문하세요. 스크립트에는 공백이나 자리 표시자가 없어야 합니다. voice.md(사용자의 말투, 사용할 단어와 피해야 할 단어),brand/rules/script.md, 그리고edit-style.json의 길이(length_minutes)와channel.json의 말하기 속도(script.words_per_minute)를 읽으세요.- 최근 세 개 스크립트의 엔딩을 읽어서 이번 평결이 새로운 형태를 취하도록 하세요.
구조
두 가지 형태가 있습니다. 도구나 주장에 대해서는 테스트 형식을 사용하고, 무슨 일이 발생했을 때는 스토리 형식을 사용하세요(자세한 내용은 references/forms.md 참조).
- 오프닝, 2~6문장. 첫 몇 초는 약속과 그 숫자를 전달합니다: 문장 1은 도구나 주제와 그 주장을 명명합니다. 인사말, 질문, "이 동영상에서는"이 없어야 합니다. 처음 30초는 클릭을 확인시켜 줍니다: 시청자는 제목과 썸네일이 약속한 동영상을 보게 되었음을 알게 됩니다. 최대 하나의 열린 루프(open loop)가 있으며, 끝에서 해결됩니다.
- 문제, 시청자가 알고 있는 사례를 들어 설명합니다. 처음 등장하는 알려지지 않은 도구는 설명합니다.
- 기능, 그림으로 설명하며, 시청자가 아직 모르는 것만 보여줍니다.
- 자체 테스트, 실제 숫자로, 사람들이 말하는 방식으로 반올림합니다. 도구가 만들어진 목적에 맞는 테스트만 수행합니다.
- 구독 유도 한 줄, 첫 번째 강력한 결과 직후에: 시청자가 채널에서 얻는 것. 공급업체가 테스트 비용을 지불하지 않으면 그 줄에 그렇게 명시합니다. 절대 시작 부분에 넣지 말고, 끝에 애원하는 식으로 넣지 마세요.
- 상승하는 stakes의 작은 이야기들. 오프닝과 평결 사이의 각 블록은 목표, 장애물, 해결책을 가집니다. 블록에서 블록으로 stakes가 상승합니다(더 많은 데이터, 더 많은 돈, 더 어려운 테스트). 가장 강력한 테스트는 평결 직전 마지막에 옵니다; 오프닝에서 언급할 수는 있지만 미리 공개하지는 마세요.
- 비판적 측면. 공급업체의 수치 대 자체 측정 또는 독립적인 측정; 한계. 도구가 약속을 지키지 못하면 그렇게 말하고, 제목은 제목 단계로 돌아갑니다.
- 평결, 매번 독자적인 형태로: 시청자를 위한 과제, 기억에 남는 하나의 숫자, 시청자 자신의 작업에 의미하는 바, 오프닝 이미지로의 회귀. 고정된 마무리 질문이 아닙니다.
- 엔딩.
channel.json에 제안이나 필수 언급(script.end_mentions)이 있으면 마지막 문장들에 사용자의 말투로 포함됩니다.closing_line이 있을 경우 마지막 문장은 채널의 종료 멘트입니다.
비교 동영상: 동일한 구성을 가진 블록은 최대 두 개까지 연속으로 허용되며, 세 번째는 형태를 바꿉니다. 중간 지점에 새로운 갈고리(hook)를 넣습니다. 각 진술은 한 번만 합니다. 모든 후보의 비용과 시간은 각 블록 끝이 아니라 한 번에, 함께 화면에 표시합니다.
단어
voice.md에서 사용자의 단어를 사용합니다. 피해야 할 목록에 있는 단어는 절대 사용하지 않습니다.- 짧은 문장: 중간값 약 10~12단어,
script.sentence_max_words를 초과하지 않습니다. - 한 문장에 제품 이름은 최대 세 개까지; 더 긴 목록은 화면에 표시합니다.
- 제외: 시청자가 이미 알고 있는 기본 지식, 아무도 신경 쓰지 않는 세부 사항(테스트 횟수, 내부 스위치), 파일 이름, 명령어, 부차적인 주제, 사적인 사람들, 예시를 선택한 이유, 약속의 일부가 아닌 비용.
- 광고나 판매 톤 금지: 테스트한 내용을 말하고, 시청자에게 아무것도 약속하지 않습니다. 오프닝에서 "이것이 아니라 저것" 같은 과장된 표현은 쓰지 않습니다.
- 비즈니스는 예시를 통해 보여주고, 시청자의 비즈니스를 직접 언급하지 않습니다.
텔레프롬프터 형식
사용자는 카메라 옆에 있는 휴대전화에서 읽습니다.
- 구분선
---위에는 말하는 텍스트만 있습니다. 편집을 위한 메모(장면, 클립, 각 숫자의 출처)는 구분선 아래에 작성합니다. - 단락은 한 호흡: 1~
script.paragraph_max_sentences개의 문장. 빈 줄 하나는 짧은 휴지입니다. - 빈 줄 세 개는 부분을 구분합니다: 편집자가 여기서 컷할 수 있고, 텔레프롬프터가 여기서 페이지를 넘기고, 클립이 재생될 수 있습니다.
- 대괄호, 무대 지시, 제목, 장, 타임스탬프 또는 제목 행이 없습니다. 대시는 팩에서 허용하는 경우에만 사용합니다.
- 단락의 핵심 단어 한두 개를 굵게 표시합니다. 텔레프롬프터의 포인트 모드는 전체 텍스트 대신 이 단어들을 표시하여, 자유롭게 말하고 싶은 사용자를 돕습니다.
단계
- 입증된 숫자로 구조를 채웁니다.
- 삭제: 모든 문장이 약속을 전달하거나 증명합니다.
- 사용자의 목소리로 바꿉니다. 모든 문장을 머릿속으로 읽어보세요: 사용자가 카메라 앞에서 이렇게 말할까요?
- 초안을
work/script-draft-vNNN.md에 다음 사용 가능한 번호로 작성합니다. 이전 버전을 덮어쓰지 마세요. - Humanizer 패스 (아래 참조). 결과를
brief/SCRIPT-vNNN.md(같은 번호)에 기록한 후 기록합니다:crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<적용된 패턴>". - 오류가 0이 될 때까지 확인합니다:
python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<제목>" --name "<도구>" --proof brief/PROOF-vNNN.md. 모든 경고와 힌트를 읽으세요; 유지하기로 결정한 힌트는---아래에 한 문장으로 이유를 적습니다. 확인을 통과하기 위해 스크립트를 변경한 경우 패스를 다시 기록하세요: 카드에는 정확한 파일의 기록이 필요합니다. - 카드:
crewcut card propose --episode <id> --step script --kind script --title "Script, version N" --file brief/SCRIPT-vNNN.md --body "<단어 수>, 약 <분> 분, 확인: 0 errors", 그 다음crewcut card wait. 카드에 "Humanized"와 변경된 내용이 표시됩니다. 기록이 없으면 거부되며 실행해야 할 명령이 표시됩니다. - 승인 후:
crewcut prompter <id>는 휴대전화 링크와 QR 코드를 출력합니다. 사용자에게 한 메시지로 알립니다: 링크, 몇 부분으로 나뉘는지, 대략적인 길이. 텔레프롬프터는---위의 텍스트만 표시합니다.
Humanizer 패스
모든 스크립트 초안은 사용자에게 보여지기 전에 Humanizer(blader/humanizer, MIT)를 거칩니다: 긴 동영상과 Shorts 모두 마찬가지입니다. Crewcut은 시작 시 최신 버전을 다운로드합니다; Claude Code에서는 humanizer:humanizer 스킬(다른 스킬처럼 실행)이며, Codex에서는 그 텍스트가 프롬프트에 포함됩니다. crewcut skills status 명령어로 버전을 확인할 수 있습니다.
- 모드 "Embedded", 사용자의 목소리로. 먼저
brand/voice/의 모든 파일을 읽으세요: 사용자가 자신의 동영상에서 말한 실제 단어들. 이 파일들을 Humanizer에 음성 샘플로 제공하세요. 샘플이 없으면 일반 모드(plain mode)를 사용하며, 카드에 그렇게 명시됩니다. - 가장 주의 깊게 봐야 할 것: "X가 아니라 Y" 대비; 새로운 내용을 추가하지 않는 종료 멘트; 깊어 보이는 속담; 요점 앞의 연출된 준비("바로 이겁니다"); 세 가지 목록; 부풀려진 의미와 광고 언어.
- 유지할 것: 사용자의 고유한 단어와 표현(
brand/voice/와voice.md에 있는 것). Humanizer가 부드럽게 다듬으려 해도 그대로 둡니다. 모든 숫자, 이름, 주장, 제목의 약속은 유지합니다. 패스는 말투를 바꾸되, 내용은 절대 바꾸지 않습니다. - 범위 밖: 텍스트가 AI 탐지기를 통과하도록 만드는 것. Humanizer는 사람을 위해 편집하며, 우리도 그렇습니다.
확인 도구가 볼 수 없는 것
예시가 너무 광범위해지지 않는지, 일부가 주제에서 벗어나지 않는지, 테스트가 약속에 부합하는지, 목소리가 사용자처럼 들리는지. 이것은 2단계와 3단계에서 읽는 작업입니다.
계획된 기능
- 큐 시트와 파트당 두 테이크(첫 번째 테이크는 큐 시트 없이, 두 번째는 스크립트에서; 편집자는 더 나은 테이크를 선택): 형식은
references/forms.md에 있습니다. 체커와 테이크 믹서(studio의zettel.py)는 아직 포팅되지 않았습니다. - 스크립트 대 녹음: 승인된 스크립트를 녹음 파일 전사본과 비교하여 사용자의 실제 단어를 학습합니다(이 전사본은 새로운 음성 샘플이 될 수 있습니다).
- 언어별 구문 체크리스트(필러 단어, 판매 문구)를
voice.md의 데이터로 추가.
출처
-
Blader의 Humanizer, https://github.com/blader/humanizer (MIT), Wikipedia의 "Signs of AI writing"에 기반. 스킬로 사용되며 시작 시 다운로드됩니다. 그 텍스트는 이 저장소의 일부가 아닙니다.
-
Grant Owen의 팟캐스트 "The Crazy Genius Who Solved The Youtube Algorithm"에 출연한 Vexian: https://www.youtube.com/watch?v=41HMFGbENj4. 차용한 점: 갈고리는 첫 몇 초, 모든 블록은 작은 이야기, 가장 강력한 테스트는 마지막에, 독립성을 강조하는 구독 유도 줄, 동영상 후반에 제안.
-
MrBeast의 프로덕션 핸드북(2024년부터 공개), 요약: https://simonwillison.net/2024/Sep/15/how-to-succeed-in-mrbeast-production/ 차용한 점: 첫 1분은 제목과 썸네일이 약속한 내용을 전달.
-
짧은 창업자 동영상의 스토리텔링: Farza (https://www.youtube.com/@farzatv), Chris Raroque (https://www.youtube.com/@raroque), Roy Lee (https://www.youtube.com/@im_roy_lee), Riley Brown (https://www.youtube.com/@rileybrownai), Varun Mayya (https://www.youtube.com/@VarunMayya), Codie Sanchez (https://www.youtube.com/@CodieSanchezCT). 차용한 점: 1인칭, 반전, 고르지 않은 실제 숫자.