Communitygithub.com

heeshaofu2/speech-video-dedup

口述、강의 영상 및 화면 설명에서 반복되는 부분, 재녹음 잔여물 및 완성되지 않은 시작 부분을 찾아 제거하고, 사운드, 강의 자료 및 작업 화면의 연결을 확인하며, 타임스탬프가 포함된 제안, 확인 가능한 미리보기 또는 원본을 보존한 완전 편집 버전을 제공합니다.

speech-video-dedup란 무엇인가요?

이 스킬은 사용자가 녹화한 강의, 튜토리얼, 화면 설명 영상에서 불필요한 반복 구간(예: 재녹음 잔여물, 동일 내용의 재설명, 미완성 시작 부분)을 자동으로 감지하고 제거하여 깔끔하고 자연스러운 최종 영상을 제공하는 것을 목표로 합니다. 단순히 시간을 압축하는 것이 아니라, 원본의 핵심 정보와 맥락을 보존하면서 반복되는 부분만 정교하게 제거합니다. 이 스킬은 음성 텍스트 변환(STT)을 활용하여 반복 구간을 식별하지만, 실제 컷 편집 결정은 오디오 파형, 화면 변화, 동작 등을 종합적으로 분석하여 이루어집니다. 지원 플랫폼은 주로 명령줄 인터페이스(CLI) 기반 도구(video-shared, video-to-text와 연동)이며, 최종 결과물은 타임라인 제안, 미리보기, 또는 완전히 편집된 영상 파일 형태로 제공됩니다. 이 스킬은 특히 '말하기 편집이 덜 된 경우', '반복 구간 찾기', '중복 제거 편집'과 같은 작업에 적합합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heshaofu2/video-workflow-suite/tree/HEAD/speech-video-dedup

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

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

문서

목표와 범위

사용자의 원래 설명이 자연스럽고 깔끔하게 이어지도록 하며, 원본 발언, 본질적인 정보 및 필요한 시연 과정을 보존합니다. 현재 요청에 따라 후보, 미리보기 또는 완전 편집 버전을 제공합니다. '찾아서 보여 달라'는 요청을 전체 영상 내보내기 권한으로 간주하지 않습니다.

사용자가 완전 편집을 요청한 경우, 필요한 검사를 완료한 후 바로 제공하며, 항목별로 확인을 요구하지 않습니다. 핵심 의견, 고유 내용 선택 또는 시연 결과에 대해 해결할 수 없는 모호함이 있는 경우, 먼저 다른 부분을 진행하고 가장 최소한의 질문을 집중적으로 합니다. 사용자가 이미 확인한 편집 방법과 범위를 따르며, 새로운 검사 때문에 승인된 부분을 임의로 다시 만들지 않습니다.

원본 영상 및 도구

먼저 video-shared를 읽고, 디렉토리, 파일 보호, 명령어 발견 및 출력 판단은 공유 규칙을 따릅니다. 전사(transcription)는 video-to-text만 호출하며, 재사용 및 부분 보충은 전사 규약에 따라 실행됩니다. 본 스킬 내에서 별도로 엔진을 선택하거나 인식 스크립트를 작성하지 않습니다.

  • dedup inspect를 사용하여 원본 영상의 규격, 크기, 수정 시간 및 SHA-256을 기록합니다. 구간 삭제 계획은 이번에 확인한 원본 영상에 대응해야 합니다.
  • 로컬 구간 삭제는 통합 CLI의 dedup check / render를 통해 실행됩니다. 사용자가 특정 편집 소프트웨어를 명시한 경우 그 선택을 따릅니다. 구간 삭제를 위해 새로운 애니메이션이나 웹 페이지 렌더링 프로젝트를 구축하지 않습니다.
  • 전사는 위치 파악에만 사용되며, 중복 제거 결정은 실제 오디오와 화면을 대조하여 이루어져야 합니다.

반복 찾기, 강의 압축이 아님

전체 영상을 검사하며, 인접하지 않은 반복도 포함합니다. 각 그룹에 대해 원본 영상 시간, 양쪽의 원래 발언, 완성되지 않은 위치, 고유 정보 및 제안 연결 방법을 기록합니다.

다음 사항을 구분합니다:

  • 명확한 재녹음 잔여물: 말하다 중단, 다시 시작, 같은 문장 연속 반복, 이후 버전이 이전 버전을 대체.
  • 선택적 내용 반복: 다른 방식으로 다시 설명. 예제, 조건 또는 새로운 정보를 제공하는지 비교하고, 이를 바로 재녹음으로 간주하지 않음.
  • 정상적인 교육 구조: 개요 후 세부 설명, 정의 후 시연, 요약, 강조 및 그림 읽기를 위한 일시 중지. 기본적으로 보존.

'마지막 버전을 보존'하는 것을 기본으로 하지 않습니다. 전체 구간 보존, 첫 번째 버전의 전반부와 두 번째 버전의 결론 연결, 각 버전에서 완전한 원문장을 각각 보존하는 것을 우선적으로 비교합니다. 주제 도입을 위한 전환, 지시 대상, 조건, 숫자 및 인과 관계를 보호합니다. 한 번만 나타나는 유효한 내용을 보호 구간으로 지정하며, 중복 제거 시 함께 삭제하지 않습니다.

오디오와 화면의 컷 지점 동시 결정

먼저 후보 연결 방법을 연속해서 읽어본 후, 해당 오디오와 화면을 대조합니다. 모델 시간은 최종 컷 지점이 아닙니다. 필요한 경우 로컬 부분을 다시 전사하고, 파형, 일시 정지 및 실제 재생을 기반으로 프레임 단위까지 세밀하게 조정합니다.

  • 오디오: 완전한 발음, 자연스러운 호흡, 강세 및 문장 간 리듬을 보존합니다. 반 문장을 없애기 위해 이전 문장의 마지막 글자를 자르지 않습니다. 모든 일시 정지를 없애지 않습니다. 극히 짧은 오디오 페이드(fade)는 절단음을 줄이는 데만 사용되며, 발음을 삼키거나 청취 테스트를 대체할 수 없습니다.
  • 화면 의미: 말을 이을 때 해당 강의 자료, 스크린샷, 차트 또는 시연 단계가 표시되는지 확인합니다. '여기', '이 안에'와 같은 지시 대상이 여전히 보이는지 확인합니다. 페이지 전환 및 확대가 설명에 필요한 시점에 발생하는지 확인합니다.
  • 작업 완전성: 삭제된 구간 내의 클릭, 스크롤, 창 전환 및 상태 결과를 확인합니다. 전후 두 프레임이 같다고 해서 중간에 중요한 작업이 없었다는 것을 증명하지 않습니다.
  • 동작 및 읽기: 인물의 자세, 제스처 및 시선을 비교하고, 마우스, 애니메이션 및 텍스트 읽기 시간을 관찰합니다. 먼저 더 적절한 자연스러운 연결 지점을 선택합니다. 정말 필요한 경우에만 기존의 해당 강의 자료 화면을 사용하여 연결하며, 인물의 입 모양이나 작업 타이밍을 확인하여 연결 지점을 숨기기 위해 어긋나지 않도록 합니다.

연결 지점 전후 약 0.1초, 1초의 대조 이미지는 초기 검사에 적합합니다. 동작, 작업 또는 페이지 전환이 포함된 경우 연속 검사를 추가로 수행해야 합니다. 프레임 추출 유사성, 재전사 성공 또는 디코딩 성공만으로 청감이 자연스럽다는 것을 증명할 수 없습니다.

미리보기는 전후 연결을 검증할 수 있어야 함

먼저 복잡한 부분의 실제적이고 연속적인 미리보기를 내보냅니다. 브라우저가 원본 영상의 임시 점프 재생을 허용하여 위치를 파악할 수는 있지만, 추가 지연이나 부정확성이 있을 수 있으므로 편집 후 효과를 가장할 수 없습니다.

미리보기에는 앞부분의 도입과 후속 전체 의미가 포함되어야 합니다. 부분 내에서만 듣기에 좋다고 충분하지 않습니다. 사용자가 내부 편집 방법을 승인한 후, 마지막 보존 구간을 후속 내용이나 다음 소절까지 연속적으로 확장하여 누락, 반복, 화면 불일치가 없는지 확인하며, 미리보기 끝에 새로운 컷 지점을 추가하지 않습니다.

dedup review를 사용하여 로컬 확인 페이지를 생성할 수 있습니다: 원본 영상 위치, 실제 미리보기, 후속 내용이 포함된 미리보기 및 화면 대조 이미지를 각각 표시합니다. 페이지 재생을 실제로 테스트할 수 없는 경우 명확히 설명하고, 개별적으로 열 수 있는 비디오 파일을 제공합니다.

계획, 내보내기 및 검증

모든 계획의 시간은 먼저 원본 영상을 기준으로 하며, 동시에 편집 후 연결 지점을 기록합니다. 확인된 컷 지점은 고정되며, 큰 구간과 짧은 문장 목록에 동시에 나타나는 중복 구간을 반복적으로 차감하지 않습니다.

기본 고정 프레임 속도 비디오는 순서대로 dedup inspect, dedup check, dedup render를 사용합니다. 사용법, 계획 형식, 기타 비디오 유형 처리 및 검증 요구 사항은 references/operator.md를 참조하십시오. CLI는 중복을 인식하거나 사용자를 대신하여 컷 지점을 결정하지 않습니다.

내보내기 시 원래의 화면 비율, 읽기 가능한 해상도, 프레임 속도 및 오디오 레이아웃을 유지합니다. 요청이 없는 경우 자막, 음악, 속도 변경 및 새로운 시각적 스타일을 추가하지 않습니다. 키프레임 stream-copy 결과를 프레임 단위 정밀 편집으로 가장하지 않습니다.

완료 후 확인:

  • 실제 결과물의 연결 지점 문장, 고유 정보가 보존되었는지, 확인된 부분이 변경되지 않았는지.
  • 실제 결과물 연결 지점 전후 화면과 계획상의 원본 영상 위치, 필요한 연속 작업, 인물 동작 및 후속 연결.
  • 전체 영상이 완전히 디코딩되는지, 길이, 프레임 수, 오디오-비디오 동기화 및 출력 규격이 계획과 일치하는지.
  • 원본 비디오 크기, 수정 시간 및 체크섬 값이 변경되지 않았는지.

오디오 이해 또는 연속 재생 기능이 없는 경우, 완료된 전사, 화면 대조 및 기술 검사를 정직하게 전달하며, '전체 영상을 청취했다'거나 '모든 연결 지점의 청감이 확인되었다'고 주장하지 않습니다. 아직 검증되지 않은 주관적 청감과 이미 통과된 객관적 검사를 분리하여 설명합니다.

최종적으로 열 수 있는 결과물, 길이, 처리 범위 및 원본 영상 보존 상태를 제공합니다. 검사 범위 및 필요한 제한 사항은 간단한 설명문으로 작성합니다. 목록, 원본-결과물 시간 대조표 및 대조 이미지는 산출물 디렉토리에 남겨두어 추후 수정이 용이하도록 합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬