Files
ShortVideoGenerator/.agents/skills/short-video-motion/SKILL.md
T
2026-10-08 00:54:01 +09:00

4.7 KiB

name, description
name description
short-video-motion 승인된 컷·장면과 실제 시작/끝 이미지로 12-motion 영상 요청을 작성하고 받은 MP4의 길이·상태·연결을 확인한다.

컷 영상 요청과 결과 확인

시작 조건

공통 계약의 저장·전달, 실제 파일과 시간, 승인·수정 규칙과 제작 지침의 설명에 필요한 움직임·장면 연결 절을 읽는다. 12 양식과 결과 스키마의 12-motion 정의를 사용하며 새 필드를 추가하지 않는다.

개별 호출에서도 같은 제작물의 유효한 07-cuts, 08-scenes, 11-images와 그 선행 관계를 확인한다. 실제 사용한 세 결과의 {stage_id, revision}을 inputs에 기록한다. project.json에서 story·scenes가 사용 버전과 연결된 실제 사용자 승인인지 확인하며 pending·changes_requested·stale 승인을 우회하지 않는다. 이미 승인된 같은 버전은 재승인을 요구하지 않는다. 자료·승인이 없으면 빠진 항목과 돌아갈 단계를 총괄에 보고한다.

선행 조건인 Qwen3-TTS 통합 WAV의 실측 컷, gpt-image-2.5-sunburst의 실제 PNG, references/1.png 그림체를 유지한다. 그림체 참고에 캠핑 소재를 강제하지 않는다. 이 스킬은 영상 엔진을 선택·구현하거나 실제 모델 API·영상 생성을 실행하지 않고 도구에 중립적인 요청과 받은 결과 확인을 담당한다.

요청 작성

payload.request.clips는 07의 컷 순서대로 모든 컷을 정확히 한 번 포함한다. 각 항목은 다음 기존 필드만 사용한다.

  • cut_id: 07의 컷 ID. 08 장면과 11 프레임의 컷 참조가 같은지 확인한다.
  • start_frame_id, end_frame_id: 11 요청에서 해당 컷의 start/end인 ID. 11 결과의 frame_id로 실제 PNG를 찾고 media.verified=true와 이미지 내용을 확인한다.
  • duration_ms: 07의 실측 end_ms-start_ms. 양수이고 5000ms 이하이며 글자 수 추정으로 대체하지 않는다.
  • motion_prompt: 08의 시작→끝 상태, 설명에 필요한 물체·인물 동작, 흐름 방향과 카메라 동작을 전달한다. 별도 camera 필드를 만들지 않는다.

물높이 변화·부품 조작 등 원인과 결과를 보여주는 움직임을 우선한다. 줌·흔들림으로 설명을 대신하거나 근거 없는 구조·수치를 더하지 않는다. 시작/끝 이미지와 요청이 같은 변화를 설명해야 한다. continuous 연결은 이전 끝과 다음 시작의 위치·방향·카메라·인물·배경을 맞추고 cut 전환은 승인된 이유를 보존한다.

받은 결과 확인

요청만 준비되면 payload.result=null을 유지하고 awaiting_input으로 보고한다. 실제 결과는 payload.result.clips의 {cut_id, media}로 기록한다. 각 요청 cut_id에 MP4 한 개씩 대응해야 하며 누락·중복·요청 외 ID를 허용하지 않는다. 부분 결과는 보존하되 전체 요청을 받기 전 complete로 보고하지 않는다.

media는 기존 {path, kind, verified, duration_ms, width, height}다. path는 저장소 루트 기준 상대 경로, kind는 video다. 실제 파일 존재·MP4 형식·재생 내용·길이·화면 크기를 확인한 뒤에만 verified=true와 실측 메타데이터를 기록한다. 파일 미확인은 verified=false, 확인하지 못한 메타데이터는 null이다. 요청값이나 확장자만으로 실측했다고 쓰지 않는다.

각 실제 클립 길이를 요청 duration_ms와 비교한다. 다르면 cut_id·요청/실측 길이·수정할 12-motion을 보고하며 임의로 컷·음성을 늘리거나 속도를 바꿔 통과시키지 않는다. 실제 시작/끝 상태와 동작·카메라·인접 연결도 확인한다. 프레임 문제는 11-images, 장면 설계 문제는 08-scenes, 시간 기준 문제는 07-cuts로 돌린다. 모든 컷의 실제 파일·길이·상태가 맞아야 합성 전달 준비로 보고한다.

저장과 보고

담당은 projects/<project_id>/stages/12-motion/r<revision>/artifact.json과 같은 버전 review.md만 작성한다. 이전 버전을 덮어쓰지 않고 검토 양식에 선행 버전, 요청 대비 실측 결과, 적용한 움직임 원칙·적용하지 않은 구성과 이유, 문제 단계·컷을 적는다.

총괄만 project.json의 상태·포인터·승인을 작성한다. 담당은 준비 여부·미확인 내용·후속 13/14 및 final 검토에 미치는 수정 영향을 보고한다. 사용자 final 승인 전 제작 완료를 선언하지 않는다.