Cut as Code 진입점
이것은 cut-as-code 비디오 작업의 필수 진입점입니다. 라우팅 및 프로젝트 상태 복구만 담당합니다. 선택된 리프 스킬이 편집 결정, 검토 게이트, 스크립트, 렌더링 세부 사항 및 자체 점검을 소유합니다.
1. 프로젝트 상태에서 시작
첫 번째 일치하는 행을 적용하십시오. 낮은 행은 평가하지 마십시오.
| 상태 | 조치 |
|---|---|
| 사용자가 기존 프로젝트에서 특정 작업을 지정함 | 해당 작업에 필요한 상태만 검사한 다음 소유 스킬을 로드합니다. 일반 인테이크를 건너뜁니다. |
명시적 프로젝트 루트에 work/project.json이 포함됨 | work/project.json, work/timeline.json 및 선택한 작업의 계획/증거만 읽습니다. 기록된 상태에서 다시 시작합니다. 소유자가 고유하지 않으면 라우팅 전용 질문 하나를 합니다. |
| 사용자가 소스 파일 또는 URL, 프로젝트 없음, 명확한 결과물을 제공함 | /video-understand를 로드하여 프로젝트와 공유 증거를 초기화한 다음 요청된 작업을 계속합니다. |
| 프로젝트/소스 또는 의도된 결과물을 식별할 수 없음 | 누락된 프로젝트/소스와 원하는 결과를 요청하는 간결한 질문 하나를 합니다. 아직 스킬을 시작하지 마십시오. |
프로젝트 루트는 명시적이어야 합니다. 리포지토리 루트를 비디오 프로젝트로 취급하지 마십시오. work/project.json을 유일한 공유 매니페스트로 취급하십시오. 작업 status, revision, based_on, check 및 렌더링 상태에서 진행 상황을 결정하고 디렉토리 존재 여부로 결정하지 마십시오. 확인된 작업을 다시 실행하지 마십시오. 종속성이 누락되었거나 오래된 경우 먼저 해당 종속성을 완료한 다음 요청된 작업을 다시 시작하십시오.
라우팅은 읽기 전용입니다. 작업을 보낼 위치를 결정하는 동안 작업을 복구, 재설정, 승인, 제거 또는 활성화하지 마십시오.
2. 결과물별 라우팅
요청된 출력을 일치시키고, 우연히 언급된 키워드가 아닌 요청된 출력을 일치시키십시오.
| 요청된 결과 | 소유 스킬 또는 워크플로 |
|---|---|
| 프로브, 트랜스크립트, 객관적 분석, 의미적 이해 또는 새 프로젝트 초기화 | /video-understand |
| 다듬기, 단축, 약한 섹션 제거 또는 첫 번째/대략적인 컷 생성 | /video-understand 이후 /video-cut |
| 색상 교정, 룩 생성/선택 또는 LUT 전달/적용 | /video-color-grade; 사용자가 명시적으로 프로젝트 프로토콜 전달을 원하지 않는 경우에만 독립 실행형 경로 사용 |
| 트랜스크립트에 시간이 맞춰진 시각적 컷어웨이 추가 | /video-understand 이후 /video-add-b-roll |
| 소싱된 모션 그래픽 또는 애니메이션 의미적 오버레이 추가 | /video-understand 이후 /video-add-graphic-motion |
| 제목, 하단 써드, 통계, 인용문, 챕터 또는 행동 촉구 추가 | /video-understand 이후 /video-add-content-cards |
| 자막, 캡션 또는 가라오케 캡션 추가 | /video-understand 이후 /video-add-captions |
| 원본과 소스 시간의 실제 최종 픽셀 비교 | 확인된 기본 전달이 존재한 후 /video-edit-compare |
| 숏폼 범위 선택, 검토 및 계획 | /video-understand 이후 /video-to-shorts; 요청된 콘텐츠 카드 및 캡션 전에 수행 |
| 승인된 가로 또는 세로 숏폼 파생물 확정 및 추출 | 확인된 기본 전달이 존재한 후 /video-to-shorts 재개 |
| 기존 프로젝트 프로토콜 전달물 컴파일 또는 렌더링 | 모든 선택된 활성 작업이 자체 게이트를 통과한 후 /video-understand에서 build_render_plan.py 및 render_project.py 사용 |
"이 비디오 편집"과 같은 일반 요청은 /video-cut을 고유하게 선택하지 않습니다. 원하는 출력이 기존 프로젝트 상태 또는 주변 요청에서 명확하지 않은 경우 라우팅 질문 하나를 하십시오.
3. 다중 작업 요청 오케스트레이션
사용자가 요청한 작업만 동결하십시오. 라우트 테이블을 기본 패키지로 전환하지 마십시오. 공유 이해 사전 조건을 한 번 실행하십시오. 선택된 기본 시퀀스 작업을 표준 순서로 실행하십시오:
cut -> color-grade -> b-roll -> captions -> content-cards -> graphic-motion
Shorts, 콘텐츠 카드 또는 캡션을 포함하는 요청의 경우 이 단계별 흐름을 사용하십시오:
/video-understand
-> /video-to-shorts 계획 및 후보 검토만
-> /video-add-captions
-> /video-add-content-cards
-> /video-add-graphic-motion
-> 공유 기본 전달물 한 번 컴파일 및 렌더링
-> /video-to-shorts 승인된 파생물 확정 및 추출
Shorts 계획 전에 /video-cut과 같은 타임라인 변경 작업을 먼저 완료하십시오. 변경된 work/timeline.json은 후보 승인을 무효화합니다. Shorts 계획은 공유 계획/검토 상태를 작성하며 final.mp4 또는 final/shorts/ 아래에 아무것도 생성하지 않아야 합니다. 그런 다음 캡션, 콘텐츠 카드 및 그래픽 모션이 해당 상대적 순서로 자체 공유 계획 및 오버레이 기여를 추가합니다. 쌍만 선택된 경우에도 동일한 순서가 적용됩니다: 캡션 먼저, 콘텐츠 카드 두 번째, 그래픽 모션 마지막. 각 핸드오프 전에 work/project.json을 다시 읽으십시오. work/project.json, work/timeline.json, 작업 계획 또는 공유 렌더링 아티팩트를 쓸 수 있는 리프 스킬을 동시에 실행하지 마십시오. 모든 선택된 활성 작업이 검증된 후에 기본 전달물을 한 번 빌드하고 렌더링하십시오. 확인된 전달물에 대해 /video-edit-compare 및 /video-to-shorts의 확정/추출 단계만 실행하십시오. shorts는 sequences.main.operations 외부에 유지됩니다.
/video-add-content-cards 및 /video-add-graphic-motion의 경우, 모든 주요 또는 전경 인물, 발표자, 진행자, 인터뷰 대상자 또는 의미적으로 중요한 사람의 보이는 얼굴과 머리 실루엣을 전체 큐에 대해 보호하십시오. 내러티브 또는 시각적 초점이 아닌 우발적인 배경 전용 사람은 면제됩니다. 불확실한 경우 보호하십시오. 오버레이가 보호된 얼굴 또는 머리에 닿으면 먼저 재배치한 다음 크기를 조정하거나 재설계하십시오. 적합한 배치가 없으면 큐를 건너뛰십시오.
소유 스킬이 허용하는 경우 모든 건너뛰기 또는 제로 큐 결과가 유효합니다. 작업을 활성 상태로 유지하기 위해 채우기 작업을 발명하지 마십시오.
4. 핸드오프 후 종료
선택한 스킬의 전체 SKILL.md와 모든 필수 하위 스킬을 읽은 후에만 작업을 시작하십시오. 단일 작업의 경우 한 번 핸드오프하고 이 진입점을 종료하십시오. 요청된 다중 작업 실행의 경우 한 번에 하나의 소유자에게 진입하십시오. 자체 점검 후 프로젝트 상태를 복구하고 인테이크를 다시 열지 않고 다음 동결 작업을 계속하십시오.
이미 명확한 라우트를 승인하도록 사용자에게 요청하지 마십시오. 사용자 상호 작용은 누락된 입력, 진정한 라우팅 모호성, 자격 증명 또는 소유 스킬에 필요한 편집/검토 결정에만 속합니다. 사용자가 명시적으로 위임하지 않는 한 에이전트 결정을 필수 인간 결정으로 대체하지 마십시오.
예제
"캡션을 추가하여 이 이해되고 컷된 프로젝트를 계속"하려면 현재 프로젝트 및 타임라인 리비전을 읽은 다음 /video-add-captions로 진입하십시오. 재전사, 재컷 또는 캡션이 의도된 라우트인지 묻지 마십시오. 관련 없는 보류 중인 작업은 라우트를 변경하지 않지만, 활성화된 확인되지 않은 작업은 최종 공유 렌더링을 차단할 수 있으며 컴파일러에 의해 보고되어야 합니다.
실패 규칙
- 잘못된 프로젝트 상태: 정확한 유효성 검사 문제를 보고하십시오. 그 위에 다시 초기화하지 마십시오.
- 누락된 리프 스킬 또는 사전 조건: 중지하고 이름을 지정하십시오. 메모리에서 재구성하지 마십시오.
- 누락된 소스/프로젝트 경로: 단일 라우팅 질문에서 요청하십시오.
- 충돌하는 요청된 출력: 현재 실행을 소유하는 결과물을 질문하십시오.
- 기존 사용자 변경 사항 또는 아티팩트: 보존하고 기록된 상태와 함께 작업하십시오.