Communitygithub.com

ELX EzVideoEdit

2ByteASR MCP와 함께 자막이 포함된 비디오를 제작합니다. 3가지 모델 인식, 교정, 편집, 5개 제목, 3개 설명, 태그 및 3가지 비율의 커버 이미지를 생성하고, 원본 파일을 이동하여 정리한 후 비디오별 폴더로 전달합니다. 기본적으로 로컬에서만 제작하며, 업로드는 선택 사항입니다.

ELX EzVideoEdit란 무엇인가요?

ELX EzVideoEdit은 ELX 워크스테이션과 함께 실행되는 AI 에이전트 스킬로, 독립적인 비디오 프로세서가 아닙니다. 설치 시 bundle-location.json이 실제 워크스테이션을 가리키며, CLI는 소스 코드 내에서 자동으로 루트 디렉토리를 찾거나 EZVIDEOEDIT_ROOT 환경 변수로 지정할 수 있습니다. 이 스킬은 MOSS, FireRed, Qwen3-ASR의 세 가지 모델을 사용하여 음성 인식, 자동 자막 생성 및 교정을 수행하고, AI 기반 문장 분할과 교정을 통해 완성된 자막을 비디오에 삽입합니다. 첫 번째 단계에서는 로컬에서 모든 제작과 전달을 완료하며, 각 비디오마다 자막이 포함된 최종 비디오, 원본 파일, SRT 자막 파일, 게시용 텍스트, 그리고 16:9, 4:3, 3:4 비율의 세 가지 커버 이미지를 포함한 전용 폴더를 생성합니다. 두 번째 단계는 선택 사항으로, 사용자가 멀티포스트 또는 기존 플랫폼 업로드 기능을 사용할지 결정할 수 있으며, 에이전트가 직접 업로드를 트리거하는 경우에도 최종 게시 전에 실제 계정 권한을 확인하고 사용자 확인을 받습니다. 이 스킬은 Cursor, Claude Code, Codex, VS Code 및 Continue.dev와 같은 다양한 AI 코딩 도구와 호환되도록 설계되었습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Ee1ex/elx-EzVideoEdit/tree/main/.agents/skills/elx-ezvideoedit

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

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

문서

ELX EzVideoEdit은(는) 무엇을 하나요?

본 Skill은 ELX 워크스테이션과 함께 실행되며, 독립적인 비디오 프로세서가 아닙니다. 설치 후 bundle-location.json이 실제 워크스테이션을 가리킵니다. 소스 코드 내의 CLI는 자동으로 루트 디렉토리를 찾으며, EZVIDEOEDIT_ROOT 환경 변수로 지정할 수도 있습니다. 처음 사용 시 로컬 설정을 먼저 읽으십시오. 로컬 모델, Python, MCP 접근 권한 및 문자 서비스는 사용자가 직접 구성해야 하며, 작성자의 권한이나 자격 증명을 상속하지 않습니다.

1단계: 제작 및 전달

기본적으로 로컬 전달이 완료될 때까지 실행됩니다. 사용자가 소재, 출력 디렉토리 및 이번 배치의 수동 자막 검토 방식을 선택합니다. 선택 사항이 없으면 건너뛰거나 수동으로 수정할지 묻습니다. 이번 배치에서 건너뛰기로 명확히 결정된 경우 각 비디오의 신선한 요약을 읽고 skip을 기록하며, 반복해서 묻지 않고 수동 검토가 통과되었다고 말하지 않습니다. 플랫폼 계정이나 브라우저 연결을 로컬 완료 조건으로 간주하지 마십시오.

  1. node .agents/skills/elx-ezvideoedit/scripts/cli.mjs help를 실행한 다음 status로 실제 기능을 확인합니다. launch로 서비스를 시작하거나 재사용합니다. 작업 쓰기는 동일한 서비스를 통해 수행되며 task.json을 직접 수정하지 않습니다. 자세한 필드는 로컬 인터페이스를 참조하십시오.
  2. tools/list와 get_status를 통해 native-production/1 기능을 발견합니다. 공식 0.9.1 및 검증된 0.9.0은 실제 스키마에 따라 호출됩니다. 먼저 동일한 프로필 인스턴스를 확인하고, 필요한 경우 node packaging/setup.mjs native-open으로 GUI를 연 다음 native-connect합니다. GUI와 stdio는 동일한 프로필을 공유합니다. 모델, API 및 권한이 없을 때는 네이티브 설정 위치를 보고하며, 사용자가 처리하고 전략을 우회하지 않습니다.
  3. 품질 체인은 MOSS 메인 전사, FireRed 단어 수준 타임라인, Qwen3-ASR 독립 검토로 구성되며, 로컬에 있는 모델과 Python을 사용합니다. AI 기반 문장 분할 및 교정은 네이티브에 저장된 문자 서비스를 사용합니다. 실제 실행, 캐시 재사용 및 다운그레이드를 각각 보고하며, 구성 태그만으로 완료되었다고 판단하지 않습니다. 자막 더듬기 정리는 오디오/비디오 제거와 동일하지 않습니다.
  4. native-start로 직렬 제작, native-state로 조회, native-resume으로 복구합니다. 독립 도구는 native-operation을 사용합니다. AI 미리보기 후 동일한 job_id로 apply하며, 중복으로 외부 전송하지 않습니다. 시간 초과 또는 결과가 불명확할 때는 먼저 기존 job/attempt를 확인합니다. configuration_required가 명확할 때만 사용자가 구성을 완료한 후 복구하며, 맹목적으로 재전송하지 않습니다.
  5. 네이티브 scope=current는 현재 프로젝트만 허용하며, 다른 프로젝트를 생성하거나 열려면 library 범위가 필요합니다. 독립 기능은 각각의 권한에 따라 실행됩니다. 0.9.x는 이전 0.8.7의 지속적인 권한 부여 또는 배치 토큰 인터페이스를 호출하지 않으며, 공식 apply_plan/export_subtitles에 batch_token을 추가하지 않습니다.
  6. 공식 save_project 후 비디오와 공식 SRT를 내보내고, 동일한 프로젝트 스냅샷을 확인합니다. native-adopt는 소재 SHA가 일치하는 동일 소스 프로젝트만 바인딩합니다. review-inspect는 실제 제안 수를 읽으며, 권한이 부족하면 알 수 없는 수를 유지합니다. 승인된 건너뛰기 시 해당 signature로 review-choice를 저장합니다. 수동 수정은 사용자가 네이티브 프로그램에서 저장한 후, review-finish는 비디오/SRT만 다시 내보내고, 인식을 다시 실행하여 수동 수정을 덮어쓰지 않습니다. verification_required는 review-recover로 이전 작업을 확인하며, 중복 시작하지 않습니다.
  7. 타임라인 다운그레이드는 서비스의 기존 가드에 따라 처리됩니다. 수동 검사 건너뛰기가 실패, 알 수 없는 오류 또는 시간 증거 누락을 무시하는 것을 의미하지는 않습니다. 보수적으로 계속하는 것이 명확히 허용된 경우에만 보호 범위를 저장합니다. preserve-review는 완료되었지만 부분적이고 요청 오류 수가 0인 문자 교정에만 사용되며, 전체 배치의 원본 텍스트와 보호 구간을 유지하고 해당 배치의 제안을 채택하거나 재전송하지 않으며, partial 응답을 유지합니다.
  8. 실제 전사 내용을 기반으로 정확히 5개의 서로 다른 스타일 제목, 3개의 서로 다른 50자 이하 설명, 독립적인 태그를 생성합니다. 커버 이미지는 16:9, 4:3, 3:4 세 가지 실제 이미지이며, 각 이미지의 텍스트, 내용 및 비율을 확인하고 늘리지 않습니다. 조합을 추천할 수 있지만 사용자가 이미 선택한 것으로 위조할 수 없습니다.

승인된 범위 내에서 연속적으로 진행합니다. 새로운 외부 서비스, 비용, 디렉토리 또는 권한 변경은 이번 사용자의 요청에 따라 확인합니다. 일시 중지 시 원본 비디오, 프로젝트, 출력 및 응답을 유지하며, 재개 전에 먼저 읽기 전용으로 확인합니다. 기본적으로 현재 대화에서 직렬로 실행합니다. 사용자가 명시적으로 새 대화 또는 하위 에이전트를 요청하는 경우에만 위임하며, 모델은 사용자와 호스트가 선택합니다. 웹에서 "Codex에 전달"은 할 일만 저장하며, 호스트가 이미 실행했음을 의미하지 않습니다.

폴더 전달

각 비디오에 대해 <원본 파일명>_전달 폴더를 생성하며, 다음 파일을 루트 디렉토리에 직접 배치합니다: 완성본_자막포함.mp4, 원본 비디오(원본 파일명), 자막.srt, 게시용_텍스트.txt, 커버_16비9.png, 커버_4비3.png, 커버_3비4.png, 전달_설명.txt. 편집 가능한 프로젝트와 실제 참조 종속성만 "프로젝트" 하위 디렉토리에 넣습니다.

  • 자료 검증 후 고유 원본 소재를 원본 파일명으로 이동하여 정리하고, 이동 전후로 SHA와 절대 경로를 확인하며, 프로젝트 참조를 업데이트하고 검증합니다. 복사본을 전달용 원본으로 위장할 수 없습니다. 이미 중복 사본이 있는 경우 경로, 개수, 크기 및 영향을 나열하고, 삭제 확인을 받은 후 처리하며, 유일한 원본을 덮어쓰지 않습니다.
  • 프로젝트는 완성본/SRT와 동일한 스냅샷에 해당하고 종속성을 사용할 수 있어야 하며, 실제 참조 소재만 포함하고 캐시나 이전 프로젝트 전체를 복사하지 않습니다. 전달 설명에는 잘라낸 횟수, 모델/자막 알림 및 검증 결론이 포함되며, 전체 응답은 워크스테이션에 남깁니다.
  • scripts/package-stage1.py --help는 간소화된 패키징 진입점입니다. 입력 서비스가 저장한 작업, 텍스트 및 커버 이미지 경로를 받아 원본 파일을 original-root와 동일한 디스크에서 이동합니다. 디스크 간 이동 또는 동일 이름 충돌 시 중단되며, 암시적으로 복사 후 삭제하지 않습니다. 워크스테이션 import는 여전히 작업 소재를 복사하므로, 이를 근거로 작업 복사본을 함부로 삭제할 수 없습니다.
  • 자료, 요약, 시간 코드, 이미지 비율, 프로젝트 종속성이 모두 확인된 후에야 완전한 전달이라고 간주합니다. 잘라낼 후보가 없으면 실제 0을 보고하며, 오디오/비디오를 잘라냈다고 허위로 말하지 않습니다. 업데이트 패키지는 먼저 검증하고, 사용자 수정 사항과 기록을 유지하며, 직접 덮어쓰지 않습니다.

2단계: 선택적 업로드

기본적으로 사용자는 기존 MultiPost 또는 플랫폼 일반 진입점을 사용합니다. 1단계 종료 시 전달 경로와 텍스트를 제공합니다. 아직 업로드 선택을 표시하지 않았으면 수동 업로드가 가능함을 알리고, 업로드를 명확히 거부하면 종료하며 반복해서 묻지 않습니다. 자세한 내용은 선택적 업로드 경계를 참조하십시오.

사용자가 명시적으로 Agent 트리거를 요청하는 경우에만 기존 플러그인의 정상 진입점을 사용하여 실제 계정과 권한을 확인하고 최종 게시 전에 중단합니다. 플러그인, 로그인, 인증 코드 또는 컨트롤 실패 시 현장을 보존하여 인계하며, 자동 Computer Use, 삽입 수정 또는 플러그인 개조를 수행하지 않습니다. 결제, 등록, 게시, 메시지 전송, 계정 권한 변경은 실행 전에 확인합니다. 워크스테이션이 응답을 준비했다고 해서 업로드 또는 게시가 성공했음을 의미하지는 않습니다.

관련 스킬