Files
ShortVideoGenerator/.agents/skills/short-video-topic/SKILL.md
T

4.0 KiB

name, description
name description
short-video-topic 짧은 영상의 입력 주제 안에서 이야기 각도와 중심 질문을 제안하고 01-topic 결과를 작성한다. 주제 선택·범위 수정·topic 검토 준비에 사용한다.

주제와 이야기 각도

시작할 때

  • 공통 계약의 제작 입력, 저장과 전달, 01 완료 기준, 상태와 사용자 검토, 재개와 수정 절을 읽는다.
  • 제작 지침의 목적과 적용 범위, 먼저 질문 하나를 정한다, 제작 단계에서 필요한 부분을 읽는다 절을 읽는다.
  • 01 양식과 검토 양식을 사용한다. 구조가 필요한 경우 계약에서 연결한 단계 결과 스키마의 01 정의를 확인한다.
  • projects/<project_id>/project.json에서 brief.topic, brief.language, 현재 01 버전과 topic 검토를 확인한다. 두 입력 모두 공백만이 아닌 문자열이어야 한다. 언어 이름·코드를 보존하며 특정 언어로 고정하지 않는다.
  • 직접 호출되어도 제작 ID·필수 입력을 임의로 채우지 않는다. 없으면 총괄에 누락 내용과 awaiting_input을 보고한다. 재개 시 같은 제작물의 유효 버전과 실제 사용자 응답을 확인한다.

각도 작성

  1. 입력 주제 안에서 서로 구별되는 이야기 각도를 제안한다. 후보 수를 고정하지 말고 선택에 필요한 차이를 보여준다.
  2. candidates의 각 항목은 {id, angle, summary}다. angle에는 중심 질문 또는 이야기 방향을, summary에는 다룰 범위·끝에서 답하려는 내용·보여줄 수 있는 증거를 짧게 적는다. ID는 비어 있지 않고 후보 안에서 유일해야 한다.
  3. 아직 조사하지 않은 답은 확인할 가설로 표현한다. 참고 영상에서 관찰한 구성의 장점과 이번 소재에 권하는 구성을 구별하고, 소재 사실은 02에서 별도 출처로 확인하도록 남긴다.
  4. 의문·변화가 없는 소재에는 방법 안내·관찰·시간 순서처럼 맞는 구성을 고른다. 위기·반전·실패한 대안이나 고정 시간 배분을 만들지 않는다.
  5. selected_id는 후보 ID 또는 미선택 시 null이다. 추천·선택 근거는 selection_reason에 적고, 추천과 실제 사용자 선택을 review.md에서 구별한다. 사용자 선택으로 기존 결과가 달라지면 새 버전으로 제출한다.

쉬운 표현은 초등학생도 직관적으로 이해할 표현 난이도다. 시청자를 어린이로 제한하지 않는다. 후보 설명도 입력 언어의 자연스러운 표현을 사용한다.

제출과 완료

  • 선행 단계가 없으므로 inputs는 빈 배열이다. 실제 제작 ID와 stage_id="01-topic", 새 revision을 01 양식에 채운다.
  • 결과는 projects/<project_id>/stages/01-topic/r<revision>/artifact.json과 같은 폴더의 review.md로 제출한다. 이전 버전을 덮어쓰지 않는다. 경로는 저장소 루트 기준이며, 복사한 검토 양식의 문서 링크는 실제 위치에 맞춘다.
  • review.md에 중심 질문·범위·후보 차이·선택 이유, 적용한 구성 원칙과 적용하지 않은 이유를 적는다. 새 필드·필수 입력·검토 지점을 추가하지 않는다.
  • 후보 텍스트와 ID, 선택 ID의 존재, 선택 이유를 확인한다. 준비된 결과는 topic awaiting_review로 보고하고, 미선택이면 필요한 결정을 함께 적는다.
  • 01 완료에는 선택된 후보와 해당 버전에 대한 실제 사용자의 topic 승인이 필요하다. 응답 없음·담당 추천을 승인으로 해석하지 않는다. 승인 전 02 자료 조사를 시작하지 않는다.
  • 담당은 결과 버전과 review.md만 제출한다. project.json의 상태·포인터·승인은 총괄만 변경한다. 검증 실패나 변경 영향은 총괄에 문제와 재검토할 후속 결과로 보고한다.