口播成片은(는) 무엇을 하나요?
官方 출처
본 Skill은 chengfeng / AI产品自由가 제작 및 유지 관리합니다.
https://github.com/Agentchengfeng/chengfeng-videocut-skills
공식 계정: GitHub @Agentchengfeng; X @chengfeng240928; 샤오홍슈 / 공식 계정 / Bilibili / Douyin / 위챗 비디오 AI产品自由.
핵심 프로세스
이 Skill은 한 가지 일만 해결합니다: 입방송 영상을 완전한 완성본으로 만드는 것입니다. 완성본의 비율과 애니메이션 스타일은 사용자 설정에 따라 결정됩니다.
+-----------------------------+
| 입력 |
| 영상 + 자막 + 선택적 자료 |
+--------------+--------------+
|
v
+-----------------------------+
| 1. 스토리보드 |
| 개념 분할 + 유형 판단 + 화면 출처 |
+--------------+--------------+
|
v
+-----------------------------+
| 2. 타임라인 미리보기 |
| 원본 영상/스크린샷/HTML 과 자막 정렬 |
+--------------+--------------+
|
v
+-----------------------------+
| 3. 합성 |
| 사용자 설정 비율로 최종 MP4 내보내기 |
+--------------+--------------+
|
v
+-----------------------------+
| 검수 |
| ffprobe + 키프레임 추출 검사 |
+-----------------------------+
큐 시트, HTML 모듈, 리뷰 플레이어, 최종 플레이어, 내보내기 스크립트를 별도의 사용자 프로세스로 설명하지 마십시오. 이들은 '타임라인 미리보기'와 '합성'의 구현 세부 사항일 뿐입니다.
사용자 설정
본 Skill을 실행할 때마다 먼저 다음 파일을 읽습니다:
사용자 설정/default.json
설정 항목은 사용자의 현재 선택만 정의합니다:
{
"aspectRatio": "3:4",
"animationStyle": "xiaohei"
}
지원 값:
3:4: 기본 세로 HD, 논리 캔버스1080x1440, 기본 DPR1.5로1620x2160내보내기.16:9: 가로, 논리 캔버스 및 내보내기 캔버스1920x1080.4:3: 가로, 논리 캔버스 및 내보내기 캔버스1440x1080.animationStyle: 기본xiaohei, 선택 항목은애니메이션/styles.json에서 확인.
명령줄 인수가 사용자 설정보다 우선합니다. 명시적 인수가 없으면 내보내기 스크립트는 aspectRatio를 읽고, 애니메이션 스크립트는 animationStyle을 읽습니다. 비율 임시 재정의는 다음을 사용할 수 있습니다:
--config /path/to/config.json
--ratio 16:9
--aspect-ratio 16:9
--width 1920 --height 1080
--dpr 1.5
시각적 선호도, 템플릿, 인코딩 품질, 출력 디렉토리, 자막 여백 등 여러 설정을 사용자 설정/default.json에 넣지 마십시오. 사용자 설정에는 현재 선택만 포함됩니다. 애니메이션 디렉토리에는 선택 가능 항목 등록 및 구체적인 스타일 구현만 포함됩니다.
애니메이션 스타일
애니메이션 스타일의 현재 선택은 사용자 설정/default.json에 있습니다:
animationStyle
애니메이션 디렉토리는 선택 가능한 항목만 등록합니다:
애니메이션/styles.json
xiaohei는 다음에 해당합니다:
애니메이션/ian-xiaohei-svg-motion/
스토리보드 또는 HTML 모듈에 설명 애니메이션, 프로세스 애니메이션, 손그림 느낌의 하이라이트가 필요한 경우, 기본적으로 작은 흑백 만화 느낌의 SVG 모션 효과를 사용합니다. 사용자가 다른 애니메이션 스타일을 명시적으로 지정하지 않는 한, 임시로 새로운 스타일을 만들지 마십시오.
입력
먼저 다음 파일을 찾습니다:
- 메인 영상:
source_cut.mp4,*_cut.mp4또는 사용자가 지정한 편집된 영상. - 자막:
subtitles.srt,video.srt또는subtitles_with_time.json. - 선택적 원고: 기사, 입방송 대본, 본문 초안. 의도 이해에만 사용.
- 선택적 자료:
assets/내 스크린샷, 제품 페이지, 댓글 이미지, 결과 페이지, 증명 페이지. - 프로젝트 규칙: 현재 프로젝트에
AGENTS.md또는README.md가 있으면 먼저 읽습니다.
진실의 소스 우선순위:
실제 오디오 / 자막 > 편집된 영상 화면 > 자료 파일 > 원고 초안
원고와 실제 자막이 일치하지 않으면 자막과 오디오를 기준으로 합니다.
1단계: 스토리보드
기본적으로 먼저 HTML 스토리보드 확인 페이지를 만듭니다. Markdown 표부터 작성하지 마십시오.
스토리보드의 사전 프로세스는 다음 순서로 실행해야 합니다:
- 먼저 입방송 의미에 따라 구분: 동일한 개념, 동일한 동작, 동일한 증거를 설명하는 한 문장, 두 문장 또는 세 문장을 하나의 세그먼트로 결합합니다. 자막 번호로 기계적으로 나누지 마십시오.
- 그런 다음 각 세그먼트의 화면 작업 판단: 이것은 작업 시연, 원본 이미지 설명, 결과 증명, 개념 정리, 또는 순수 텍스트 표현입니까?
- 그런 다음 화면 출처 결정: 실제 화면 녹화, 원본 스크린샷, 원본 이미지로 증명할 수 있는 세그먼트는 원본 자료를 우선 사용합니다. 개념적 설명이고 현재 화면이 주로 텍스트, 빈 공간 또는 관련성이 낮은 화면인 경우에만 HTML / xiaohei 애니메이션을 설계합니다.
- 마지막으로 구체적인 시각 디자인에 들어갑니다: 각 HTML / xiaohei 애니메이션 세그먼트는 먼저 독립적인 은유와 동작을 명확히 작성한 후 모듈을 구현합니다.
일반적인 경로:
review/storyboard-audit-vN.html
기본적으로 다음 템플릿을 기반으로 합니다:
templates/storyboard-audit.html
스토리보드는 사용자에게 다음 질문에 답하게 합니다:
이 문장이 여기에서 말해질 때, 시청자의 눈앞에 무엇이 보여야 하는가?
각 세그먼트는 최소한 다음을 명확히 작성해야 합니다:
- 시간 범위
- 자막 번호
- 전체 입방송
- 의미 구분 근거
- 화면 작업
- 화면 유형:
원본 영상,작업 녹화,원본 스크린샷,원본 이미지,정보 그래픽 포커스,HTML 애니메이션,텍스트 + 애니메이션 - 자료 출처
- 카메라 동작
화면 선택 규칙:
- 작업 시연: 원본 영상 / 원본 화면 녹화 사용. 추상 애니메이션으로 변경하지 마십시오.
- 이미지 콘텐츠, 차트 콘텐츠, 오류 스크린샷, 제품 스크린샷 설명: 원본 이미지 또는 원본 스크린샷 직접 사용. 애니메이션은 선택, 주석, 부분 포커스에만 사용.
- 실제 작업, 증명 페이지, 결과 페이지, 신뢰도가 필요한 부분: 원본 영상 또는 원본 스크린샷 유지.
- 화면 녹화 / 원본 영상 클립은 기본적으로 원래 화면으로 표시. 뒷부분의 통일된 자막을 명확히 피해야 하는 경우에만 해당 세그먼트를 녹화 작은 창으로 표시하고 하단에 자막 안전 영역을 남깁니다. 작은 창 규칙을 모든 녹화 세그먼트에 일괄 적용하지 마십시오.
- 개념 정리, 메커니즘 관계, 시스템 분업, 의견 요약이며 현재 화면이 주로 텍스트, 빈 공간 또는 관련성이 낮은 화면인 경우: HTML / xiaohei 애니메이션을 만듭니다.
- 짧은 텍스트로 이해를 도울 수 있는 추상적인 세그먼트: 텍스트 + 애니메이션 사용. 텍스트는 명명을 담당하고 애니메이션은 관계와 동작을 담당합니다.
- 기존 스크린샷 또는 정보 그래픽: 재사용 우선, 다시 그리지 마십시오.
- 동일한 이미지가 여러 번 나타나는 경우, 매번 다른 작업을 수행해야 함: 전체 모습, 부분 포커스, 비교, 결과 재검토.
- 모든 애니메이션을 동일한 역학으로 만들지 마십시오. 각 애니메이션 세그먼트는 먼저 동작 은유를 개별적으로 설계한 후 구현해야 합니다.
스토리보드 설계 하드 기준:
- 한 페이지는 하나의 개념, 하나의 동작 또는 하나의 사례만 설명합니다. 동일한 입방송 세그먼트에 두 개의 독립적인 사례가 나타나면 반드시 두 페이지로 나누어야 합니다. 페이지 수를 줄이기 위해 두 사례를 동일한 표나 동일한 애니메이션에 넣지 마십시오.
- 각 HTML / xiaohei 애니메이션 세그먼트는 먼저 "이 문장이 여기에서 말해질 때, 화면에 어떤 변화가 일어나는지"를 명확히 작성한 후 구현합니다. 동작은 특정 입방송 문장 또는 자막에 바인딩되어야 합니다. 동일한 등장 / 깜빡임 / 확대를 모든 세그먼트에 평균적으로 적용하지 마십시오.
- 원본 이미지, 스크린샷, 결과 페이지를 설명할 때 주요 시각은 원본 자료여야 합니다. HTML은 자르기, 확대, 선택, 주석 및 포커스 전환만 담당합니다. 화면 녹화 프레임 추출 또는 이미지 다시 그리기로 원본 이미지를 대체하지 마십시오.
- 긴 이미지와 웹 결과 페이지는 기본적으로 정보가 없는 빈 영역을 자르고, 시청자가 듣고 있는 영역을 우선적으로 노출합니다. 입방송이 해당 객체를 언급하면 해당 이미지 또는 부분을 확대하고 나머지 콘텐츠는 뒤로 물러납니다.
- 비디오 화면에 자료 경로, 내부 설명, 동작 설명 또는 "원본 이미지 자료 · img/xxx.png"와 같은 작업대 텍스트가 나타나지 않아야 합니다. 스토리보드에는 출처를 쓸 수 있지만, 완성된 화면에는 시청자가 볼 필요가 있는 콘텐츠만 유지합니다.
- 필요 없는 제목은 넣지 않습니다. 결과 페이지, 표 페이지, 원본 이미지 비교 페이지는 주요 시각이 스스로 말하게 하고, 짧은 레이블, 모델 이름, 메트릭 이름 또는 필요한 주석만 유지합니다.
- 데이터 비교 페이지는 명확한 표, 열 정렬, 짧은 레이블 및 약간의 하이라이트를 우선 사용합니다. 글자 크기는 가독성을 위해 서비스되어야 하며, 글자를 작은 상자에 채우지 마십시오. 간단한 표로 설명할 수 있으면 복잡한 카드 쌓기를 하지 마십시오.
- 세로형 짧은 비디오의 표는 중간에 가로로 좁은 표만 만들지 마십시오. 데이터 단계에서는 표를 주요 시각으로 만들어 주요 안전 영역을 차지해야 합니다. 사전 작업 설명, 사례 레이블, 요약 문장은 해당 입방송 단계에만 나타나고, 최종 데이터 비교 단계에 들어가면 사라지거나 공간을 차지하지 않는 위치로 물러나야 합니다.
- 평가 단어는 입방송에서 명확히 언급하거나 편집에서 강조해야 하는 긍정적 / 중립적 결과만 씁니다. 대조 항목은 비워두거나 데이터만 표시할 수 있습니다. 입방송 원문이 해당 판단이 아닌 이상 "느리고 비싸다" 등 부정적인 단어를 추가하지 마십시오.
- 아이콘은 애니메이션 라이브러리 인덱스에서 찾아야 합니다. ChatGPT, Claude, Flash 번개, Step, DeepSeek, Qwen 등 기존 아이콘은 추상적인 형태로 대체할 수 없습니다. 사용자가 제공한 새 SVG는 먼저 애니메이션 라이브러리에 저장하고 인덱스를 업데이트해야 합니다.
스토리보드 방향이 확인되기 전에는 타임라인 미리보기로 들어가지 마십시오.
2단계: 타임라인 미리보기
스토리보드 방향 확인 후 타임라인 미리보기를 만듭니다.
일반적인 경로:
review/timeline-preview.html
기본적으로 다음 템플릿을 기반으로 합니다:
templates/timeline-preview.html
타임라인 미리보기에서 확인할 사항:
- 화면 전환이 입방송 문장과 정렬되는지.
- 원본 영상이 HTML로 잘못 교체되지 않았는지.
- 녹화 작은 창으로 표시된 세그먼트가 하단 자막 안전 영역을 피하는지; 표시되지 않은 녹화 세그먼트는 자동으로 축소되지 않아야 함.
- 스크린샷, 페이지, 증명 자료가 잘못 사용되지 않았는지.
- 이미지 자료는 기본적으로 좌우 여백을 유지하고 화면을 가득 채우지 않아야 함. 전체 스크린샷을 강조해야 하는 경우에만 개별적으로 축소.
- 화면이 텍스트를 가리거나, 잘리거나, 검은 여백이 있는지.
- HTML 모듈은 개별적으로는 문제없어 보이지만 전체 타임라인에 넣었을 때 여전히 성립하는지.
미리보기 페이지에 원본 영상이 있는 경우, HTTP Range를 지원하는 서비스로 페이지를 열어야 합니다. 그렇지 않으면 브라우저가 무작위 seek을 할 수 없어 진행 표시줄이 처음으로 돌아갑니다. 일반 python -m http.server로 MP4 타임라인을 미리보지 마십시오. 기본적으로 다음을 사용합니다:
node ~/.Codex/skills/chengfeng-videocut-skills/口播成片/scripts/serve_range_preview.cjs \
--project-dir /absolute/path/to/project \
--port 8767
필요한 경우 생성:
docs/08-动画cue表-vN.md
html-modules/module-*.html
html-modules/xiaohei-*.html
새로운 설명 애니메이션을 만들려면 먼저 사용자 설정/default.json의 animationStyle을 읽고 애니메이션/styles.json에서 해당 애니메이션 하위 Skill을 찾습니다.
각 애니메이션 동작은 특정 입방송 문장에 바인딩되어야 하며, 시간을 균등하게 분배하지 마십시오. 다단계 HTML 애니메이션은 표시/숨김 상태를 명시적으로 관리해야 합니다. 다음 단계가 나타날 때, 이전 단계에서 정보 작업을 더 이상 담당하지 않는 설명 카드, 레이블 및 주석은 숨겨야 합니다. 이전 단계가 계속 주요 시각 공간을 차지하지 않도록 하십시오. 특히 세로형 데이터 표, 스크린샷 포커스 및 결과 페이지에서 중요합니다.
3단계: 합성
사용자가 타임라인 미리보기를 확인한 경우에만 합성합니다.
합성 전에 다음을 생성하거나 확인합니다:
final-player.html
새로운 final-player.html 또는 HTML 모듈을 작성하기 전에 다음을 읽습니다:
references/artifact-contracts.md
프로젝트에 HTML 모듈이 있는 경우 먼저 렌더 모드를 주입합니다:
node ~/.claude/skills/chengfeng-videocut-skills/口播成片/scripts/write_render_mode.cjs \
--project-dir /absolute/path/to/project
타임라인 미리보기와 최종 내보내기는 동일한 HTML 렌더링 컨텍스트를 사용해야 합니다. HTML 모듈은 미리보기 페이지와 final-player.html 모두에서 ?timeline=1&render=1을 포함해야 합니다. 미리보기 페이지는 최종 캔버스를 창에 비례하여 축소하는 역할만 해야 하며, 모듈이 미리보기 창에 따라 반응형 레이아웃을 다시 조정하도록 해서는 안 됩니다.
고화질 전달은 CSS 논리 캔버스를 직접 확대하지 않아야 합니다. 기본 3:4는 1080x1440 논리 캔버스를 유지하고 스크린샷 DPR 1.5로 1620x2160을 출력해야 합니다. 그렇지 않으면 표, CSS 카드, 스크린샷 주석이 내보내기에서 상대적으로 작아져 미리보기와 일치하지 않습니다.
미리보기와 내보내기에서 크기 불일치가 발생하면 먼저 HTML 모듈 내부 CSS, render-mode.js 및 내보내기 DPR을 확인하고, 미리보기 페이지와 final-player의 논리 캔버스가 동일한지 확인하십시오. 전체 비디오를 다시 렌더링하기 전에 확인하십시오. 일반적인 원인은 미리보기 iframe이 작아 정상적으로 보이지만, 최종 고화질 캔버스에서 .photo-frame { max-width: ... }, .stage { width: min(...) }, .wrap { max-height: ... }, clamp(...) 등 미리보기 크기 상한이 트리거되어 내보내기가 "작은 그림"이 되는 것입니다. 수정 순서:
write_render_mode.cjs를 사용하여html-modules/render-mode.js를 다시 생성합니다.- 타임라인 미리보기에서 HTML 모듈 URL이
?timeline=1&render=1로 변경되었는지 확인합니다. export_final_video.cjs의viewport가 논리 캔버스 크기이고dpr이 고화질 배수인지 확인합니다.- final-player를 사용하여 실제 내보내기 viewport에서 해당 모듈의 키프레임을 추출하고, 필요한 경우
getBoundingClientRect()를 사용하여 주요 시각 컨테이너 크기를 비교합니다.
세로형에서 가로형 xiaohei SVG / 16:9 SVG 모듈을 처리할 때, .wrap { transform: scale(...) }와 같은 전체 확대를 사용하여 "작은 가로 막대" 문제를 해결하는 것을 금지합니다. 전체 크기 조정은 3:4 캔버스에서 좌우 가장자리, 특히 좌우로 분포된 모델 카드, 화살표, 설명 레이블을 잘라낼 수 있습니다. 세로형 구도로 다시 배치하거나 완전한 안전 영역을 유지하십시오. 수정 후에는 해당 모듈의 좌우 경계 프레임을 추출하여 확인해야 하며, 중앙 키프레임만 보지 마십시오.
최종 비디오 내보내기:
node ~/.claude/skills/chengfeng-videocut-skills/口播成片/scripts/export_final_video.cjs \
--project-dir /absolute/path/to/project \
--input-video /absolute/path/to/source_cut.mp4 \
--duration 173.03
기본적으로 고화질 전달로 내보내기: 무손실 PNG 중간 프레임, H.264 crf=14, preset=slow. 이렇게 하면 브라우저 미리보기에서는 선명하지만 내보내기 후 작은 글자와 가는 선이 흐릿해지는 문제를 방지할 수 있습니다:
node ~/.claude/skills/chengfeng-videocut-skills/口播成片/scripts/export_final_video.cjs \
--project-dir /absolute/path/to/project \
--input-video /absolute/path/to/source_cut.mp4 \
--duration 173.03 \
--frame-format png \
--crf 14 \
--preset slow
템포를 빠르게 확인하거나 초안을 빠르게 내보내야 하는 경우에만 명시적으로 다운그레이드합니다:
node ~/.claude/skills/chengfeng-videocut-skills/口播成片/scripts/export_final_video.cjs \
--project-dir /absolute/path/to/project \
--input-video /absolute/path/to/source_cut.mp4 \
--duration 173.03 \
--frame-format jpeg \
--quality 92 \
--crf 18 \
--preset medium
비율 읽기 규칙은 "사용자 설정"을 참조하십시오. 프로젝트와 사용자 설정이 다른 경우 다음을 전달할 수 있습니다:
--config
--ratio
--aspect-ratio
--fps
--player
--stage
--frames-dir
--width
--height
--frame-format png|jpeg
--quality 100
--crf 14
--dpr 1.5
--device-scale-factor 1.5
검수
내보내기 성공이 완성본의 정확성을 의미하지는 않습니다. 반드시 두 단계를 수행해야 합니다:
ffprobe로 해상도, 프레임 속도, 길이 및 오디오를 확인합니다.- 3장 이상의 키프레임을 추출하여 화면이 올바른지 수동으로 확인합니다.
- 각 HTML 모듈에 대해 최소한 해당 입방송 시간 지점의 final-player 프레임 1장을 추출하고 타임라인 미리보기의 동일 시간 지점과 비교합니다. 크기, 위치, 자르기 및 표시/숨김이 일치해야 합니다.
ffprobe만 완료 기준으로 사용하지 마십시오.
현재 비율로 해상도를 확인하고, 다른 기대치는 스크립트 기본값과 프로젝트 실제 입력에서 가져옵니다. 현재 기본 설정은 다음과 같습니다:
1620x2160
논리 캔버스 1080x1440, DPR 1.5
3:4
30fps
길이는 편집된 원본 영상과 일치
오디오 있음
HUD, 버튼, 검토 타임라인, 브라우저 UI 없음
범위
적합:
- 중국어 입방송
- 튜토리얼, 제품 시연, 결과 표시, 지식 설명
- 편집된 비디오와 자막이 있고 자료는 나중에 보충 가능
- 원본 영상 + 스크린샷 + HTML 설명 화면 혼합 완성본
우선 해결하지 않음:
- 비디오 없이 원고만으로 완성본 생성
- 복잡한 다중 카메라 실사 편집
- 편집 소프트웨어 프로젝트 파일이 필요한 정밀한 색보정 및 다중 트랙 오디오 믹싱
- 사용자가 스토리보드와 타임라인 미리보기를 보지 않고 최종 게시 요청
프로젝트 위생
사용자 작업 영역 내에서 파일을 추가하거나 수정하는 경우, 프로젝트 README 색인을 동시에 업데이트해야 합니다.
로컬 활동 로그는 통일적으로 다음 위치에 저장됩니다:
log/
log/는 로컬 실험, 사용자 선호도, 임시 결론 및 게시되지 않은 작업 과정만 기록하며 GitHub에 업로드하는 것을 금지합니다. 이 디렉토리는 .claude/skills/.gitignore에 의해 무시됩니다.
이 Skill 디렉토리에 README를 새로 추가하지 마십시오. 이 Skill의 핵심 파일은 다음만 유지합니다:
SKILL.md
templates/
references/
scripts/
사용자 설정/
애니메이션/
애니메이션/은 입방송 완성본에서 재사용 가능한 HTML/SVG/GSAP 애니메이션 하위 Skill, 템플릿 및 규칙을 축적하는 데 사용됩니다. 선택 가능한 스타일은 애니메이션/styles.json을 참조하고, 현재 선택은 사용자 설정/default.json을 참조합니다.