Communitygithub.com

영상(화면 분할)

편집된 구술 영상에 화면을 덧입힙니다: 녹화 화면 위에 HTML 레이어(중요 부분 강조 표시/작은 검은 화면 전체 애니메이션/확대)를 얹고, 레이어를 자막 화면에 바인딩하며, 플레이어가 프레임 단위로 구동하여 미리보기에서 바로 확인합니다. 사용자가 분할 구성, 화면 추가, 애니메이션 추가, 중요 부분 강조, B-roll, 스토리보드를 요청할 때 사용합니다. 단어 삭제 편집, 자막, 물리적 컷 또는 최종 렌더링에는 사용하지 마십시오.

영상(화면 분할)란 무엇인가요?

이 기술은 사용자의 구술 편집(口播) 영상에 시각적 요소를 동기화하여 덧입히는 AI 에이전트 스킬입니다. 사용자가 '분할 구성', '화면 추가', '애니메이션', '강조 표시', 'B-roll', '스토리보드' 등을 요청할 때 활성화됩니다. 핵심 아이디어는 기존의 '편집-렌더링-확인' 워크플로우를 깨고, 플레이어가 프레임 단위로 구동하는 HTML 레이어를 자막 화면에 직접 바인딩하여 미리보기에서 즉시 확인할 수 있도록 하는 것입니다. 이 스킬은 `edit-list.json`, `transcript.json`, `subtitles.json` 파일이 이미 존재한다는 전제 하에 작동합니다. '자막 화면(subtitle screen)' 개념을 사용하여 각 레이어가 특정 자막 구간에 바인딩되므로, 편집이 변경되어도 레이어가 자동으로 따라 움직입니다. 시간(초)을 직접 저장하지 않으며, 절대 좌표를 '눈대중'으로 측정하지 않습니다. 작업은 네 가지 필수 단계로 진행됩니다: ① 자막을 읽고 각 구간의 의미(튜토리얼, 데모 vs. 개념, 논리)를 파악, ② 8-12프레임을 추출하여 실제 화면을 보고 판단, ③ 인접 프레임 간 픽셀 차이를 계산하여 스크롤/전환/조작 순간을 찾고 안정적인 윈도우에만 레이어를 배치, ④ 모듈을 작성하고 `visual add` 명령어로 레이어를 추가합니다. 출력물은 `visuals.json`과 각 레이어별 `modules/<번호-이름>/index.html` 파일입니다. 확대(zoom)는 기본적으로 사용하지 않으며(녹화 영상이 흐려짐), 필요한 경우 1.6배 이하로 제한하고 62.5% 정사각형 영역에 중앙 정렬합니다. 수정 시에는 번호가 매겨진 모듈 디렉토리(예: `01-daily-report`)를 사용하여 특정 레이어만 독립적으로 수정할 수 있습니다. 프레임 추출 및 모션 윈도우 분석 단계를 건너뛰거나, 모든 구간에 레이어를 추가하려는 시도(가만히 두는 것이 정답인 경우 다수)는 엄격히 금지됩니다. 브랜드 아이콘은 반드시 공식 Simple Icons 글리프를 사용해야 하며, 수작업으로 그리거나 대체물을 사용할 수 없습니다. 지원 플랫폼: 주로 데스크톱 환경(desktop-managed)에서 작동하며, 기존의 안정적인 CLI 도구와 시스템 서비스를 재사용합니다. Electron 경로를 직접 분석하거나 별도의 의존성을 설치하지 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-visual

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

영상(화면 분할)은(는) 무엇을 하나요?

이것은 하나의 작업이며, 프로세스의 일부가 아닙니다. 사용자가 요청할 때마다 실행되며, 편집을 변경한 후 다시 돌아와서 실행할 수 있습니다.

전제는 오직 두 가지입니다: 장부와 자막이 이미 존재해야 합니다(레이어는 자막 화면에 배치되고, 시간은 장부에서 계산됩니다).

필요   edit-list.json, transcript.json, subtitles.json
산출   visuals.json + modules/<번호-이름>/index.html

완료되면 중단되며, 사용자에게 다음 단계를 지시하지 않습니다.

먼저 비즈니스 스킬의 단계 계약을 읽고 실행합니다. 모듈 작성의 엄격한 규칙은 모듈 계약을 참조하고, 판단 규칙은 영상 판단을 참조하세요.

0. 준비

먼저 업데이트 확인의 '준비 확인'을 실행합니다——skills가 최신인지, Runtime이 호환되는지 확인합니다. 플러그인 루트도 여기에서 찾습니다(이 문서의 명령어에서 <플러그인 루트>는 해당 리터럴 경로로 대체됩니다). '준비 완료' 상태여야만 계속 진행합니다. '새 세션 필요' 또는 '중지' 상태인 경우 해당 처리(「자체 제작 대체 인터페이스 금지」 명령 포함)에 따라 실행하며, 비즈니스 스킬은 자체적으로 환경 로직을 포함하지 않습니다.

준비 결과가 runtime.kind=desktop-managed이면, 데스크톱 앱에 이미 설치된 안정적인 CLI와 동일한 launchd/windows-task 서비스를 직접 재사용합니다. Electron 경로를 분석하거나, 별도 의존성을 설치하거나, 두 번째 Runtime을 시작하지 마십시오.

명령어

node "<플러그인 루트>/scripts/ensure-running.cjs" --json
node "<플러그인 루트>/scripts/videocut-cli.cjs" visual get   <project> --json
node "<플러그인 루트>/scripts/videocut-cli.cjs" visual frame <project> --cues sub-0004,sub-0005 --count 12 --out <dir> --json
node "<플러그인 루트>/scripts/videocut-cli.cjs" visual add   <project> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<플러그인 루트>/scripts/videocut-cli.cjs" visual remove <project> --id vis-0001 --json

ensure-running은 먼저 canonical 5190이 현재 플랫폼의 관리 서비스에 속해 있음을 증명해야 합니다. 실패하면 오류를 그대로 전달하고 중지하며, foreground 또는 사용자 지정 포트로 폴백하지 않습니다.

레이어는 자막 화면(--cues)에 바인딩됩니다. 제품이 자체적으로 단어 ID로 변환합니다——레이어는 절대 아무도 말하지 않은 단어에 바인딩될 수 없으며, 편집이 변경되면 레이어가 자동으로 따라 움직입니다. 초 단위를 저장하지 않습니다.

네 단계, 한 단계도 건너뛰지 않음

① 텍스트로 작업 정의    subtitles.json을 읽고, 의미별로 분할하여 각 구간에 대해 답변:
                      튜토리얼/데모/증명, 아니면 개념/논리/전환?
② 프레임 추출 및 화면 확인    visual frame으로 8-12프레임 추출, 실제로 눈으로 확인합니다.
                      실제 측정 결과 12개 구간 중 2개 구간에서 화면이 텍스트 예측을 뒤집었습니다——이 단계는 형식적이지 않습니다
③ 모션 윈도우 측정    인접 프레임 간 픽셀 차이를 계산하여 스크롤/전환/조작 순간을 찾습니다.
                      레이어는 안정적인 윈도우에만 배치되며, 강조 표시는 화면이 움직이기 시작하기 전에 사라집니다
④ 레이어 생성 및 배치    모듈 작성 → visual add → 미리보기에서 레이어별로 확인

②의 판단 규칙

화면이 사용자가 말한 것과 정확히 일치    → 강조 표시: 원으로 강조, 말하는 단어에 맞춰 원을 이동. 진짜 증거는 가리지 않음
화면이 약한 연관성/비어 있음            → 작은 검은 화면 애니메이션: 전체 화면 흰색 배경, 스타일 레지스트리에서 생성
화면 자체로 충분히 명확함              → 변경하지 않음. 이것이 가장 일반적인 정답입니다(실제 측정 결과 13개 구간 중 4개 구간은 변경하지 않음)

③의 산출물은 숫자이며, 느낌이 아닙니다

강조 표시 좌표      픽셀 통계로 산출(그레이스케일 스캔으로 텍스트 줄 찾기), 육안 측정 금지——육안 측정은 50px 이상 차이가 났습니다
상호작용 순간       프레임별 픽셀 차이로 급격한 변화 찾기(실제 측정에서 한 번에 4에서 335로 점프), 그 이전 0.2초에 강조 표시 제거 완료
안정적인 윈도우    시작 부분에 스크롤이 자주 발생(내용을 찾는 중), 레이어는 화면이 멈춘 큐부터 바인딩 시작

확대(zoom)는 사용하기 전에 먼저 생각하세요

기본적으로 확대하지 않음.    960x720 녹화 영상을 확대하면 흐려지며, 사용자가 즉시 알아차립니다
확대가 반드시 필요한 경우    ≤1.6배, 영역은 62.5% 정사각형 중앙 정렬——구성의 완전성 > 작은 글씨 읽기
글씨가 너무 작아 읽기 어려움    강조 표시로 시선을 이끄는 것으로 충분합니다. 정말 읽어야 한다면, 고해상도 재녹화가 정답이지 확대가 아닙니다

검토 순환

모듈 디렉토리는 번호 순서로 이름을 지정(01-daily-report, 05-anim-task-split)하며, 타임라인 트랙에 디렉토리 이름이 표시됩니다. 사용자가 번호를 부르면 해당 레이어만 수정하고, 다른 레이어는 건드리지 않습니다.

레이어 수정에 관한 두 가지 규율은 각각 실제 사고에 해당합니다:

레이어 수정 시 모듈을 반드시 확인    레이어가 좁아지거나 길어져도 모듈에 하드코딩된 상대 시간은 변하지 않습니다——
                                  강조 표시의 등장 시간이 레이어 종료 후에 위치하여 절대 나타나지 않을 수 있습니다
검수 시 픽셀을 확인    스크린샷으로 화면을 확인하고, DOM 속성을 확인하지 않습니다. '가시성 전환이 올바름'인 iframe이
                      실제로는 화면에 물리적으로 존재하지 않았습니다——속성은 모두 맞았지만 화면은 완전히 비어 있었습니다

하지 말아야 할 것

  • 프레임 추출과 모션 윈도우 분석을 건너뛰고 직접 레이어를 생성하지 마십시오(두 가지 오류 모두 각각 한 번씩 발생: 진짜 증거를 가리거나, 스크롤 위에 강조 표시가 떠 있음)
  • 모든 구간에 무언가를 추가하지 마십시오——꽉 채우는 것이 목표가 아니며, 변경하지 않는 것이 일반적인 정답입니다
  • 초 단위를 저장하지 말고, 육안으로 좌표를 측정하지 말며, 흰색 배경 페이지에 어두운 레이어를 추가하지 마십시오
  • 실제 내용이 없으면 자리 표시자 이미지로 채우지 마십시오
  • 스타일은 레지스트리에서 선택해야 하며, 임의로 발명해서는 안 됩니다
  • 브랜드 아이콘은 공식 글리프를 사용해야 하며, 수작업으로 대체물을 그리지 마십시오(X를 두 선으로 교차시켜 그렸다가 사용자에게 적발되었습니다). 로컬 인덱스에 없는 경우, simple-icons에서 단색 공식 글리프를 가져옵니다(흑백 스타일이 잘 어울림), 원본 svg는 모듈 디렉토리에 저장하여 참조합니다. 같은 영상 내에서 동일한 브랜드는 하나의 모양으로만 나타나야 합니다.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

관련 스킬