ShortVideoGenerator/.agents/skills/short-video-script/SKILL.md

name, description

name	description
short-video-script	선택한 이야기 각도와 검증된 조사 근거로 03-script 대본을 작성하거나 수정한다. 중심 질문의 답·블록 연결·쉬운 표현과 story 검토 준비에 사용한다.

근거를 이야기로 쓰기

입력 읽기

• 공통 계약의 제작 입력, 저장과 전달, 03 완료 기준, 상태와 사용자 검토, 재개와 수정 절을 읽는다.
• 제작 지침의 먼저 질문 하나를 정한다부터 근거와 숫자는 작성 전에 정리한다까지와 대본과 제목 검토 메모를 읽는다.
• 03 양식과 검토 양식을 사용한다. 필요한 상세 구조는 계약에서 연결한 단계 결과 스키마의 03 정의를 확인한다.
• projects/<project_id>/project.json의 제작 입력·현재 포인터·검토를 읽고, 지정된 01-topic·02-research 버전의 artifact.json과 review.md를 읽는다. topic, language가 공백만이 아닌 문자열인지, 02가 해당 01을 사용했는지, topic 승인이 실제 사용자 응답과 같은 01 버전을 가리키는지 확인한다.
• 직접 호출해도 선행 결과와 승인을 생략하지 않는다. 입력·근거·파일 부재는 총괄에 awaiting_input, topic 미승인은 awaiting_review, stale·다른 제작물·잘못된 참조는 문제로 보고한다. 02는 story 검토 전이라도 유효한 준비 결과로 사용할 수 있다.

대본 작성

1. 선택한 중심 질문과 끝에서 전달할 답을 고정하고 도입이 약속한 답을 결말에서 회수한다. 소재에 맞는 설명·변화·방법·비교 구성을 선택한다. 지침의 모든 이야기 역할·반전·위기·고정 시간 배분을 강제하지 않는다.
2. blocks는 순서가 있는 {id, text, claim_ids} 배열이다. 블록마다 질문에 가까워지는 내용과 앞뒤 연결 이유가 있어야 한다. 사실처럼 쓰는 주장은 02의 verified 주장에 연결한다. ID는 유일하고 모든 claim_ids는 사용한 02 버전에 존재해야 한다.
3. uncertain을 확정 사실로 쓰지 않는다. 추정을 다룰 필요가 있으면 추정임을 표현하고 중심 답을 대신하지 않게 한다. 새 사실·숫자·인과 관계가 필요하면 02로 돌아가 검증된 새 버전을 요청한다. 단순 연결·질문 문장은 사실 주장이 없으면 claim_ids=[]가 가능하다.
4. 입력 언어로 대본을 쓴다. 한 문장에 행동·관계 하나를 담고 용어보다 기능을 먼저 설명한다. 초등학생도 직관적으로 이해할 표현을 쓰되 시청자를 어린이로 제한하지 않는다.
5. 비유가 공유하는 성질과 적용 한계를 유지한다. 필요한 숫자만 단위·비교 기준과 함께 사용하고, 쉽게 만들기 위해 실제 조건·예외를 지우지 않는다. 참고 영상의 표현·순서를 복제하거나 검증되지 않은 소재를 사실로 쓰지 않는다.
6. full_text는 블록 순서대로 읽은 대본과 내용이 일치해야 한다. 예상 길이를 계산할 근거가 있으면 양수 정수 밀리초를 estimated_duration_ms에 적고 방법을 review.md에 남긴다. 모르면 null이다. 예상은 실측이 아니며 180000ms는 상한이지 채울 목표가 아니다. 블록을 5초 컷으로 확정하거나 글자 수 추정을 실제 음성 시간으로 기록하지 않는다.

제출과 완료

• 실제 사용한 01·02의 {stage_id, revision}을 inputs에 기록한다. stage_id="03-script"인 새 버전을 projects/<project_id>/stages/03-script/r<revision>/artifact.json과 같은 폴더의 review.md로 제출한다. 이전 결과를 덮어쓰지 않고 경로는 저장소 루트 기준으로 기록한다.
• review.md에는 지침의 대본과 제목 검토 메모를 사용한다. 중심 질문·답, 도입의 약속과 답하는 블록, 블록별 연결, 주장·출처, 비유 한계, 덜어낸 정보, 적용한 원칙과 적용하지 않은 이유를 적는다. 04 전에는 제목 검토가 미작성임을 밝히고 새 필드·입력·검토를 만들지 않는다. 문서 링크는 실제 저장 위치에 맞춘다.
• 블록·전체 대본의 순서와 내용, 사실 주장의 verified 근거, 입력 언어·쉬운 표현·예상의 표시를 확인한다. 준비된 03으로 04 제목을 작성할 수 있다.
• 완료는 02 근거·03 대본·04 제목의 같은 유효 버전에 대한 실제 사용자 story 승인이 필요하다. 준비된 결과는 총괄에 awaiting_review로 보고하고 승인 전 05 TTS 분할로 넘어가지 않는다. 담당의 추천·침묵은 승인이 아니다.
• 담당은 결과 버전과 review.md만 제출하며 project.json의 상태·포인터·승인은 총괄만 변경한다. 내용·언어 수정의 후속 영향과 재승인 필요를 보고한다.