비디오 스크립트 작성기은(는) 무엇을 하나요?
제품 데모, 기능 소개, 출시 비디오를 위한 비디오 스크립트를 작성합니다. 페이싱, 비주얼 방향, 타이밍, 플랫폼에 적합한 길이를 처리합니다.
입력 결정
제공된 인수를 다음 순서대로 확인합니다:
- 기존 마케팅 브리프(
.md, "Executive Summary" 또는 "Key Messages" 포함) 경로 -> 마케팅 브리프 - 기존 블로그 포스트(
.md, 블로그 포스트 구조) 경로 -> 블로그 포스트 - 기존 체인지로그 경로 -> 체인지로그
- 기존 뉴스레터 경로 -> 뉴스레터
- GitHub URL 또는
#\d+패턴 일치 -> PR ...또는..포함 -> Git 참조 범위- 기존 파일/디렉토리로 확인됨 -> 코드베이스 기능
- 그 외 -> 자유 형식 텍스트
인수가 제공되지 않으면 "비디오의 주제는 무엇인가요? 마케팅 브리프, 블로그 포스트, 체인지로그, PR URL/번호, Git 참조 범위, 파일/디렉토리 경로를 제공하거나 기능을 설명해 주세요."라고 묻습니다.
여러 해석이 일치하면 사용자에게 확인합니다.
프로세스 흐름
digraph video_script {
rankdir=TB;
"입력 결정" [shape=box];
"단계 1: 분석" [shape=box];
"단계 2: 구성" [shape=box];
"단계 3: 개요" [shape=box];
"개요 승인?" [shape=diamond];
"단계 4: 작성" [shape=box];
"단계 5: 검토" [shape=box];
"승인?" [shape=diamond];
"단계 6: 출력" [shape=box];
"입력 결정" -> "단계 1: 분석";
"단계 1: 분석" -> "단계 2: 구성";
"단계 2: 구성" -> "단계 3: 개요";
"단계 3: 개요" -> "개요 승인?";
"개요 승인?" -> "단계 3: 개요" [label="아니오, 수정"];
"개요 승인?" -> "단계 4: 작성" [label="예"];
"단계 4: 작성" -> "단계 5: 검토";
"단계 5: 검토" -> "승인?";
"승인?" -> "단계 4: 작성" [label="수정 필요"];
"승인?" -> "단계 6: 출력" [label="예"];
}
단계를 건너뛰지 마십시오. 질문은 자연스러운 속도로 해 주세요. 사용자가 한 번에 여러 질문에 답하면 묶어서 처리하고 앞으로 건너뜁니다.
사용자가 "기본값으로 해 줘" 또는 비슷한 말을 하면 적절한 기본값을 선택하고, 선택한 내용을 알린 후 한 번의 확인을 요청합니다.
단계 1: 분석
1단계 - 입력 분석
| 입력 유형 | 읽을 내용 |
|---|---|
| 마케팅 브리프 | 문제 설명, 가치 제안, 대상, 핵심 메시지 추출. 3단계로 건너뜁니다. 브리프에 제품 맥락이 없으면 2단계는 여전히 수행합니다. |
| 블로그 포스트 | 제목, 핵심 포인트, 대상, CTA 추출. 3단계로 건너뜁니다. |
| 체인지로그 | 주요 항목 추출, 가장 영향력 있는 변경 사항에 집중. 3단계로 건너뜁니다. |
| 뉴스레터 | 제목, 주요 업데이트, CTA 추출. 3단계로 건너뜁니다. |
| PR | diff, PR 설명, 리뷰 코멘트, 커밋 메시지. 대규모 PR(20개 이상 파일)은 사용자 대상 변경 사항에 집중합니다. |
| Git 참조 범위 | 참조 간 git diff 및 git log. 사용자 대상 변경 사항을 우선시합니다. |
| 코드베이스 기능 | 지정된 파일/디렉토리를 읽습니다. |
| 자유 형식 텍스트 | 사용자의 설명을 분석합니다. 구체적인 내용이 부족하면 사용자에게 자세한 내용을 제공하거나 특정 파일/PR을 가리키도록 요청합니다. |
사용자 대상 변경 사항에는 다음이 포함됩니다: 새로운 기능, UI 변경, API 변경, 성능 개선, 버그 수정, 문서 업데이트. 내부 변경 사항에는 다음이 포함됩니다: 리팩토링, 테스트 추가, CI 변경, 종속성 업그레이드.
오류 처리:
gh를 사용할 수 없음 -> 사용자에게 알리고 대체 입력 제공- 잘못된 PR/참조 -> 사용자에게 확인 요청
- 파일을 찾을 수 없음 -> 올바른 경로 요청
2단계 - 더 넓은 제품 맥락 읽기
존재하는 경우 읽기: README, docs/, package.json(또는 동등 파일).
아무것도 없으면 "제품과 대상이 누구인지 간단히 설명해 주시겠어요?"라고 묻습니다.
3단계 - 이해 내용 제시
"비디오 스크립트의 기반으로 사용할 내용은 다음과 같습니다:"
- 기능 A - 간단한 설명
- 기능 B - 간단한 설명
"추가, 삭제 또는 수정할 내용이 있나요?"
사용자가 범위를 확인할 때까지 진행하지 마십시오.
4단계 - 민감한 내용 확인
진행하기 전에 보안 패치, 내부 가격, 자격 증명, 미공개 로드맵 항목 또는 기밀 표시 콘텐츠와 같은 잠재적으로 민감한 내용을 스캔합니다. 의심스러운 내용이 있으면 사용자에게 알립니다.
단계 2: 구성
다음 질문을 합니다:
Q1 - 비디오 길이:
- 숏폼(30-90초) - 소셜 미디어(릴스, 쇼츠, 틱톡)
- 미디엄폼(3-5분) - 유튜브, 제품 데모, 소개
Q2 - 스크립트 유형:
- 내레이션 - 화면 녹화/영상 위에 읽을 나레이션 텍스트
- 2열 - 왼쪽 열: 비주얼 방향/화면 동작, 오른쪽 열: 나레이션
- 토킹헤드 - 카메라 앞의 발표자, 대화체 전달
Q3 - 톤: 기존 저장소 내용을 읽어 음성을 감지합니다. 확인:
"기존 콘텐츠를 보니 톤이 [예: 대화체로 개발자 친화적]인 것 같습니다. 이와 일치시킬까요, 아니면 다른 방향으로 갈까요?"
분석할 콘텐츠가 없으면 직접 물어봅니다.
Q4 - CTA: 맥락에서 유추:
- 오픈 소스 -> "리포지토리에 별표를 눌러 주세요", "사용해 보세요"
- SaaS -> "무료로 가입하세요", "평가판 시작하기"
- 기능 업데이트 -> "지금 사용해 보세요", "문서 확인하기"
"CTA를 [유추된 CTA]로 제안합니다. 이대로 갈까요, 아니면 다른 것으로 할까요?"
단계 3: 개요
타이밍이 포함된 구조화된 개요를 생성합니다. 비디오 길이에 따라 적절한 템플릿을 사용합니다:
숏폼(30-90초) - 3-4개 섹션:
## [작업 제목] - [총 길이]
1. **후크** (0:00-0:05) - [접근 방식]
- 핵심 포인트
- 비주얼: [보여줄 내용]
2. **문제** (0:05-0:15) - [설정할 페인 포인트]
- 비주얼: [보여줄 내용]
3. **해결책** (0:15-0:45) - [기능 소개]
- 핵심 포인트 A
- 비주얼: [보여줄 내용]
- 핵심 포인트 B
- 비주얼: [보여줄 내용]
4. **CTA** (0:45-0:60) - [취할 행동]
- 비주얼: [엔드 화면]
예상 총 단어 수: ~X 단어 (~Y초, 135 WPM 기준)
미디엄폼(3-5분) - 5-8개 섹션:
## [작업 제목] - [총 길이]
1. **후크** (0:00-0:10) - [접근 방식]
- 비주얼: [보여줄 내용]
2. **문제** (0:10-0:30) - [페인 포인트, 맥락, 왜 중요한지]
- 비주얼: [보여줄 내용]
3. **해결책 개요** (0:30-1:00) - [구축한 내용의 개괄]
- 비주얼: [보여줄 내용]
4. **심층 분석: [기능 A]** (1:00-2:00) - [소개]
- 핵심 포인트
- 비주얼: [화면 녹화 단계]
5. **심층 분석: [기능 B]** (2:00-3:00) - [소개]
- 핵심 포인트
- 비주얼: [화면 녹화 단계]
6. **심층 분석: [기능 C]** (3:00-3:45) - [소개]
- 핵심 포인트
- 비주얼: [화면 녹화 단계]
7. **요약** (3:45-4:30) - [핵심 이점 요약]
- 비주얼: [요약 슬라이드 또는 나란히 보기]
8. **CTA** (4:30-5:00) - [취할 행동]
- 비주얼: [엔드 화면]
예상 총 단어 수: ~X 단어 (~Y초, 135 WPM 기준)
다루는 기능에 맞춰 심층 분석 세그먼트 수를 조정합니다.
개요를 제시하고 작성 전에 승인을 기다립니다.
단계 4: 작성
페이싱 참조
| 비디오 길이 | 목표 단어 수 | WPM |
|---|---|---|
| 30초 | ~65 단어 | 130 |
| 60초 | ~135 단어 | 135 |
| 90초 | ~200 단어 | 135 |
| 3분 | ~400 단어 | 135 |
| 5분 | ~675 단어 | 135 |
대화체 전달의 경우 130-145 WPM을 목표로 합니다. 할당된 시간을 초과하는 섹션은 플래그를 지정합니다.
유형별 스크립트 형식
내레이션 스크립트:
## [제목]
### 후크 (0:00-0:05) - ~15 단어
비주얼: [화면에 보여줄 내용 설명]
[나레이션 텍스트]
### 섹션 이름 (0:05-0:20) - ~30 단어
비주얼: [화면에 보여줄 내용 설명]
[나레이션 텍스트]
2열 스크립트:
| 시간 | 비주얼 | 나레이션 |
|---|---|---|
| 0:00-0:05 | [화면: 랜딩 페이지 로드] | [나레이션 텍스트] |
| 0:05-0:15 | [화면: 설정 메뉴 클릭] | [나레이션 텍스트] |
| 0:15-0:30 | [화면: 다크 모드 토글] | [나레이션 텍스트] |
토킹헤드 스크립트:
## [제목]
### 후크 (0:00-0:05) - ~15 단어
카메라: [발표자 카메라, 미디엄 샷]
[발표자 텍스트. 대화체, 카메라를 직접 응시.]
### 섹션 이름 (0:05-0:20) - ~30 단어
카메라: [화면 녹화로 전환]
내레이션: [화면 녹화 위의 나레이션]
카메라: [발표자로 돌아옴]
[발표자 텍스트]
후크
처음 3-5초가 시청자가 계속 볼지 결정합니다. 후크는 다음을 충족해야 합니다:
- 페인 포인트를 언급하거나 도발적인 질문을 던집니다
- 회사/제품 이름으로 시작하지 않습니다
- "이 비디오에서는 ...을 보여 드리겠습니다"로 시작하지 않습니다
- 즉각적인 호기심이나 감정적 공명을 만듭니다
비주얼 방향
스크립트 유형에 관계없이 항상 인라인으로 비주얼 방향을 포함합니다:
- 화면 녹화 및 영상의 경우
비주얼:/화면: - 토킹헤드 카메라 방향의 경우
카메라: - 구체적으로 작성: "화면: 내보내기 버튼 클릭, PDF 다운로드 표시" ("화면: 기능 표시"가 아님)
- 장면 사이에 전환 노트 포함
섹션별 타이밍
모든 섹션에 예상 길이와 단어 수를 포함합니다:
### 섹션 이름 (0:15-0:30) - ~30 단어- 시간 예산을 초과하는 섹션은 플래그를 지정합니다
- 전체 스크립트 단어 수는 135 WPM에서 목표 길이와 일치해야 합니다
작성 규칙
- 대화체로, 대본 같지 않게. 사람들이 실제로 말하는 방식으로 작성합니다.
- 짧은 문장. 문장당 최대 10-15 단어.
- 문장당 하나의 아이디어.
- 항상 능동태.
- 생성된 콘텐츠에 절대 대시를 사용하지 마십시오. "---" 문자는 사용하지 마십시오. 대신 쉼표, 콜론, 마침표 또는 괄호를 사용합니다.
- 말로 설명하지 말고 보여 주세요. "이게 얼마나 빠르게 로드되는지 보세요" > "매우 빠르게 로드됩니다"
- 미디엄폼 비디오의 경우 세 가지 법칙을 사용합니다: 세 가지 이점, 세 가지 기능, 세 가지 예시. 숏폼의 경우 단일 핵심 이점에 집중합니다.
CTA
- 비디오의 마지막 5-10초
- 단일하고 명확한 행동
- 엔드 화면(구독 버튼, 링크 오버레이, QR 코드)에 대한 비주얼 방향 포함
단계 5: 검토
타이밍 분석과 함께 완전한 스크립트를 제시합니다:
"스크립트는 다음과 같습니다:"
[전체 스크립트]
타이밍 분석:
- 후크: 5초 (~15 단어)
- 문제: 10초 (~25 단어)
- 해결책: 30초 (~70 단어)
- CTA: 10초 (~20 단어)
- 총합: 55초 (~130 단어, 135 WPM)
"변경할 부분이 있나요?"
승인을 기다립니다. 사용자가 확인한 후에만 출력 단계로 진행합니다.
단계 6: 출력
항상 최종 승인된 스크립트를 터미널에 출력합니다.
그런 다음 "이것을 scripts/<슬러그>.md에 저장할까요? 아니면 다른 경로로 할까요?"라고 묻습니다.
디렉토리가 없으면 생성합니다. 파일이 이미 존재하면 덮어쓸지 아니면 버전이 지정된 복사본을 만들지 묻습니다.
오류 처리
gh를 사용할 수 없음 -> 사용자에게 알리고 대체 입력 제공- 잘못된 PR/참조 -> 사용자에게 확인 요청
- 제품 맥락 없음 -> 사용자에게 제품 설명 요청
- 스크립트가 목표 길이 초과 -> 검토 전에 플래그를 지정하고 컷 제안
이 스킬이 하지 않는 일
- 비디오 녹화 또는 편집
- 썸네일 또는 비주얼 에셋 생성
- 애니메이션 또는 모션 그래픽 생성
- 블로그 포스트 또는 소셜 카피 작성 (
/blog-post또는/social-copy사용)