토킹헤드 동영상 파이프라인
원본 또는 대략적으로 편집된 토킹헤드 동영상을 승인된 작업용 컷, 편집 가능한 자막, 모션 패키지가 포함된 미리보기, 그리고 검증된 최종 내보내기 파일로 변환합니다. 이 파일을 라우터 및 공유 계약으로 취급하십시오. 현재 단계에 필요한 경로가 지정된 내부 워크플로와 참조 자료만 읽으십시오.
초보자 약속
사용자가 Codex로 편집해 본 적이 없다고 가정합니다.
- 답변을 안전하게 추론할 수 없는 경우에만 한 번에 하나의 짧은 질문을 합니다.
- 많은 기술적 선택 사항을 제시하는 대신 작동하는 기본값을 선호합니다.
- 렌더러 내부가 아닌 다음으로 표시될 결과에 대해 설명합니다.
- 원본 동영상이 실제로 해당 분기가 필요할 때만 대략적인 편집, 전사 서비스 제공자 또는 API 설정을 소개합니다.
- 유료 및 로컬 선택 사항을 명확하게 설명하고, 유용할 때 하나를 추천하며, 강요하지 않습니다.
- 모든 단계를 정확한 출력 경로와 사용자가 다음에 말할 수 있는 문구로 끝냅니다.
- 기존 작업을 다시 시작하지 않고 계속 진행합니다.
절대 규칙
- 소스는 변경 불가입니다. 제공된 원본 미디어를 덮어쓰거나 파괴적으로 편집하지 마십시오.
- 메인 오디오가 기준 시계입니다. 사용자가 대략적인 편집 전략을 명시적으로 승인하지 않는 한 오디오의 타이밍, 순서, 샘플링 속도를 변경하거나 교체하지 마십시오. 승인 후에는 파생된
working_video가 다운스트림 시계가 되고 원본은 변경 불가 상태로 유지됩니다. - 증거는 읽을 수 있어야 합니다. 스크린샷 본문 텍스트, 제품 UI, 얼굴 또는 사용자가 표시한 안전 영역을 가리지 마십시오. 증거 자산을 흐리게 처리하지 마십시오.
- 최종본 전에 미리보기를 만듭니다. 공식 미리보기를 만들고 승인을 기다립니다. 사용자가 명시적으로 직접 내보내기를 요청하지 않는 한 말입니다.
- 원본 품질의 최종본. 업스케일된 저해상도 미리보기를 실제 고해상도 최종본으로 제시하지 마십시오. 가능할 때마다 원본 소스를 최종 베이스로 사용하십시오.
- 진행 상황을 방해하지 마십시오. 렌더링이 진행 중이면 기다리고 진행 상황을 보고하십시오. 실제 오류 또는 명시적 승인 후에만 파이프라인을 변경하십시오.
- 스킬에 개인 데이터를 저장하지 마십시오. 프로젝트 로컬 경로, 미디어 이름, 브랜드 규칙, 스크린샷, 고객 세부 정보 및 API 키는 사용자의 프로젝트에 남아 있어야 합니다.
- 명시적 피드백에서만 학습합니다. 침묵이나 확인되지 않은 초안 한 개로 영구적인 스타일 규칙을 추론하지 마십시오.
- 타이포그래피는 정확성의 일부입니다. 승인 전에 글꼴 패밀리, 실제 두께, 자막 줄 정책, 기준선 정렬 및 가장 긴 레이블 맞춤을 선언하고 확인하십시오.
- 공개 기본값은 브랜드 중립을 유지합니다. 제작자 팔레트, 반복되는 카드 시스템 및 개인 시각적 규칙은 로컬 프로필에만 저장하십시오.
- 공개 설치는 하나의 스킬만 노출합니다. 단계 모듈은
references/workflows/아래에 두십시오. 패키지 관리자가 별도로 등록할 수 있는 중첩된SKILL.md파일을 추가하지 마십시오. - 설치 작업은 복구 가능해야 합니다. 교체 전에 기존 설치를 백업하고 재귀적 강제 삭제 대신 제거 대상을 보관 처리하십시오.
- 선택적 제공자는 선택 사항으로 남아 있습니다. 선별된 기본 샷 팩은 기본 HyperFrames + GSAP입니다. 사용자의 명시적 동의 없이 ShotCraft, Remotion 또는 다른 제공자를 복제, 설치, 업데이트 또는 요구하지 마십시오. 기본 레시피는 완전한 대체 수단으로 남아 있어야 합니다.
미리보기 또는 내보내기 작업 전에 references/quality-gates.md를 읽으십시오.
경로 표
| 사용자 의도 또는 구문 | 경로 | 일반적인 출력 |
|---|---|---|
初始化视频项目, 第一次用, start a video project | references/workflows/init.md | 상태, 편집 계획, 디자인 프로필 |
原片还没剪, 删口误和停顿, 帮我粗剪, raw takes, rough cut | references/workflows/rough-cut.md | 승인된 비파괴 대략 컷 및 타이밍 전달 |
抽字幕轴, 只做字幕, transcribe, 改字幕 | references/workflows/captions.md | SRT, CSV, transcript JSON |
帮我设计, 换颜色风格, 规划弹窗, design | references/workflows/design.md | DESIGN 및 완전한 편집 계획 |
参考这张截图设计, 按这张图的视觉语言, style reference | references/workflows/design.md 참조 분기 | 프로젝트 로컬 STYLE_REFERENCE |
按语义匹配动效, GSAP 动效丰富一点, semantic motion | references/workflows/design.md, 그 다음 미리보기 | 검증된 MOTION_PLAN 및 미리보기 |
参考 ShotCraft, 推荐电影感镜头, cinematic shot reference | references/workflows/design.md ShotCraft 분기 | MOTION_PLAN의 선택적 매핑된 샷 참조 |
做预览, 加动效, build preview | references/workflows/preview.md | 공식 미리보기 URL |
出成片, 导出 4K, export final | references/workflows/export.md | 검증된 최종 동영상 |
改这个, 恢复上一版, revise | references/workflows/revise.md | 범위가 지정된 수정 및 새 미리보기/최종본 |
进度, 到哪了, status | references/workflows/status.md | 현재 단계 및 다음 작업 |
体检, 为什么失败, doctor | references/workflows/doctor.md | 읽기 전용 진단 |
以后都这样, 记住这个风格, learn this | references/workflows/learn.md | 확인된 프로젝트 로컬 교훈 |
复盘成片, 下次怎么改进, retro | references/workflows/retro.md | 구조화된 전달 회고 |
升级状态, 迁移, migrate | references/workflows/migrate.md | 상태 스키마 업그레이드 |
모드 감지
라우팅 전:
- 이 스킬 저장소가 아닌 사용자의 동영상 프로젝트 디렉토리를 식별하십시오.
.naive-video-state.json파일을 찾으십시오.- 파일이 없고 작업이 일회성 자막 텍스트 편집 이상이면 init 워크플로를 로드하십시오.
- 파일이 있으면 해당 파일과
EDIT_PLAN.md,DESIGN.md,VIDEO_LESSONS.md를 관련된 경우에만 읽으십시오.working_video가 있으면 사용하고, 없으면main_video를 사용하십시오. - 상태와 파일이 일치하지 않으면
python3 tools/video_doctor.py --project <project_dir>을 실행하십시오.
다음 단계를 사용하십시오:
initialized -> captions_ready -> design_ready -> preview_ready
-> approved -> rendering -> final_ready
품질 게이트를 통과하기 전에는 이후 단계를 표시하지 마십시오.
기본 파이프라인
사용자가 전체 워크플로를 요청할 때:
ffprobe로 소스 미디어를 검사하십시오.- 프로젝트 상태와 안전한 출력 디렉토리를 초기화하십시오.
- 해당 상태가 명확하지 않은 경우에만 동영상이 이미 대략 편집되었는지 물어보십시오. 원본인 경우 선택적 대략 편집 워크플로를 로드하고 전략 승인을 요구하십시오.
working_video가 있으면 그로부터, 없으면main_video로부터 자막 파일을 생성하거나 검증하십시오.- 스크린샷, 녹화, 제품 이미지, 차트 또는 데모가 나타나야 하는지 물어보십시오. 사용자가 의미적 배치, 정확한 초/말한 문장 앵커 또는 하이브리드를 선택하도록 하고, 정확한 앵커가 더 정밀하다고 설명하십시오.
- 사용 가능한 경우 단어 수준 타이밍을 정규화하고 음성을 시청자 대면 논리 그룹으로 분할하십시오. 전체 자막 시작 시간에서 단어 정밀도를 가짜로 만들지 마십시오.
- 스타일 프로필과 안전 영역을 수집하거나 추론하십시오. 초보자에게 선택적 스크린샷 참조 매칭을 제공하십시오.
- 요청된 모든 삽입, 논리 그룹 링크 및 시간 범위를 포함하여 편집 계획 및 의미적 모션 계획을 작성하십시오.
- 새 프로젝트의 경우 사용자가
skip을 선택하지 않는 한 몇 가지 안전한 의미적 노드를 선별된 ShotCraft 영감 기본 팩에 자동으로 매핑하십시오. 기존 승인된 프로젝트, 기본 레시피 및 오프라인 대체 수단을 유지하십시오. - 처음 사용, 새 스타일 또는 추론이 많이 필요한 작업의 경우 대표적인 정적 키프레임을 렌더링하고 전체 동적 미리보기 전에 구성을 해결하십시오.
- 필요한 경우 브라우저 친화적 프록시를 사용하여 HyperFrames + GSAP 미리보기를 만드십시오.
- 미리보기 품질 게이트를 실행하고 공식 미리보기 URL을 제공하십시오.
- 명시적으로 건너뛰라고 하지 않는 한 승인을 기다리십시오.
- 승인된 작업용 동영상과 해당 오디오 시계를 사용하여 오버레이 또는 최종 구성을 렌더링하십시오.
- 파일 존재, 지속 시간, 해상도, 프레임 속도 및 오디오를 확인하십시오.
- 확인된 피드백만 프로젝트 로컬 교훈으로 기록하십시오.
- 전달 후 사실 기반 회고를 실행하고 명시적이고 개인정보 보호에 안전한 규칙만 승격하십시오.
프로젝트 파일
init 워크플로는 소스 미디어를 건드리지 않고 이 최소 프로젝트 메모리를 생성합니다:
<project_dir>/
├── .naive-video-state.json
├── EDIT_PLAN.md
├── DESIGN.md
├── CONTENT_LOGIC.json # 시청자 대면 추론 그룹 및 시간 비트
├── STYLE_REFERENCE.md # 참조 이미지가 사용된 경우에만 생성
├── MOTION_PLAN.json # 의미적 모션이 계획된 경우 생성
├── VIDEO_LESSONS.md
├── VIDEO_RETRO.md
├── edit/
│ ├── rough-cut.mp4 # 선택 사항; 원본 미디어는 절대 덮어쓰지 않음
│ ├── rough-cut-edl.json # 선택 사항 결정 기록
│ ├── script-aligned.srt
│ ├── caption-table.csv
│ └── transcripts/
├── preview/
├── final/
└── qa/
└── KEYFRAME_REVIEW.md # 동적 미리보기 전 정적 구성 검토
상태는 운영 메타데이터이지 미디어 데이터베이스가 아닙니다. 작게 유지하고 전사 본문, 개인 스크린샷 또는 비밀을 저장하지 마십시오. references/state-management.md를 참조하십시오.
스타일 기본값
사용자가 속도를 원하고 참조를 제공하지 않는 경우:
- 소스 종횡비를 유지하십시오.
- 하나의 구성 가능한 악센트 색상으로 깔끔하고 읽기 쉬운 카드 시스템을 사용하십시오.
- 절제된 키워드 강조와 함께 굵은 자막을 사용하십시오.
- 모션에 GSAP 변환 및 불투명도를 사용하십시오.
- 검증된 빈 공간에 카드를 배치하십시오.
- 스크린샷 또는 데모가 보이는 동안 모션 밀도를 줄이십시오.
- 읽기 가능한 텍스트 레벨과 기준선 정렬을 유지하십시오. 레이블을 비스듬히 하는 대신 포함된 구성 요소에 애니메이션을 적용하십시오.
- 명시적인 자막 최대 줄 수와 줄 바꿈 정책을 선택하십시오.
브랜드 일관성이 중요한 경우에만 악센트 색상을 요청하십시오. 그렇지 않으면 중립 프리셋을 사용하고 나중에 쉽게 변경할 수 있도록 하십시오. 초보자는 선택적으로 스크린샷을 제공하고 낮음, 중간 또는 높음 참조 강도를 선택할 수 있습니다. 스킬이 소스 브랜드나 콘텐츠가 아닌 시각적 언어를 복사한다고 설명하십시오. 모션 밀도는 절제됨, 균형 잡힘 또는 에너제틱입니다. references/style-onboarding.md를 참조하십시오.
자세한 GSAP 레시피 및 의미적 매핑은 references/motion-recipes.md에 있습니다. 런타임 및 플러그인 선택은 references/gsap-runtime.md에 있습니다. 스크린샷 추출 및 복사 방지 규칙은 references/style-reference-workflow.md에 있습니다. 자산 타이밍 선택은 references/asset-onboarding.md에 있습니다. 일치하는 디자인 분기에 대해서만 로드하십시오.
ShotCraft 검색 및 적응 규칙은 references/shotcraft-integration.md에 있습니다. 기본 초보자 팩은 references/shotcraft-default-pack.md에 있습니다. 새 자동 프로젝트, 명명된 카드 또는 영화적 샷 요청 시 로드하십시오. 제공자를 자동으로 설치하지 마십시오.
단어 수준 타이밍, 시청자 대면 논리 그룹 및 누적/종료 동작은 references/content-logic-workflow.md에 있습니다. 자막 이후와 의미적 디자인 전에 로드하십시오.
타이포그래피, 구성 요소 지오메트리, 유리 알림 및 탐색 가능한 초점/유형/분할 적응은 references/visual-quality-rules.md에 있습니다. 모든 디자인 또는 미리보기 작업에 대해 로드하십시오.
자체 반복 계약
자체 반복은 공개 기본값으로 유출하지 않고 현재 사용자의 워크플로를 개선하는 것을 의미합니다.
피드백을 다음 범위 중 하나로 분류하십시오:
project: 이 동영상에만 적용됩니다.profile: 이 사용자의 향후 동영상에 적용됩니다. 명시적 확인 후에만 작성하십시오.product: 개인정보 보호에 안전하고 일반적인 안정성 개선 사항입니다. 스킬 유지 관리자에게 별도로 제안하십시오.
프로필 피드백을 사용자의 말, 확인된 규칙 및 영향을 받는 단계와 함께 VIDEO_LESSONS.md에 기록하십시오.