Communitygithub.com

eda-marketing: 자막 작성기

의미 기반 단어 그룹화, 안전 영역, UI 회피를 적용하여 화면 자막을 생성합니다. 실제 녹음된 음성을 전사하여 수정된 대본을 만들고 SRT 파일을 출력합니다. 자막 단계(음성 녹음 후)나 동기화 불일치, 분할 오류, 중복 문제에 사용합니다. 플랫폼 게시글 텍스트는 content-repurposer 스킬의 역할입니다.

eda-marketing: 자막 작성기란 무엇인가요?

이 스킬은 비디오 패키지에 표시할 화면 자막(on-screen captions)을 제작하는 전문 도구입니다. 의미 기반 단어 그룹화, 안전 영역(safe areas) 및 UI 요소 회피를 지원하며, 실제 녹음된 음성을 Faster-Whisper를 통해 전사(transcribe)하여 정확한 대본(corrected transcript)과 SRT 파일을 생성합니다. 주로 자막 단계(음성 녹음 후)에서 사용되며, 자막이 동기화되지 않았거나, 분할이 잘못되었거나, 중복된 경우에 적합합니다. 플랫폼 게시글 텍스트(post text)는 별도의 content-repurposer 스킬이 담당합니다. 브랜드 언어(brand.json → language)를 따르며, 언어별 그룹화 및 타이포그래피 규칙(예: 영어, 러시아어)이 언어 팩에 정의되어 있습니다. 녹음 전 드래프트 단계에서는 예상 타임라인을 제공하고, 녹음 후에는 실제 음성을 기반으로 작업합니다. 수정 사항은 transcript/corrected.<파일>.json과 CORRECTIONS.md에 기록되며, 원본 전사 파일(transcript/raw-asr.*)은 불변입니다. 또한 캡션 모드(replace, accumulate, highlight)와 보호 구문(protected phrases)을 지원하며, 스튜디오 QA 체크리스트와 mos qa 명령어를 통해 줄 넘침 및 중복 자막을 검증합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/usredanchenko/eda-marketing/tree/HEAD/plugin/skills/caption-writer

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

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

문서

caption-writer

세 가지 별개 항목: 화면 자막(video/captions/, props.captions, speech.srt); 게시글 텍스트(captions/<platform>.md, 스킬 eda-marketing:content-repurposer); 편집 텍스트(spoken: false인 accents, editorialCta) — 절대 SRT에 포함되지 않음.

자막 텍스트는 브랜드 언어(brand.json → language)를 따릅니다. 그룹화, 타이포그래피 및 음절 규칙은 언어 팩(packages/core/src/lang/<en|ru>.ts)에서 가져옵니다.

녹음 전 (드래프트)

npm run mos -- captions build <pkg> — 스크립트에서 예상 시간 산출(brand.json → speech.syllablesPerSec), "예상 시간" 배지 표시, 최종 렌더링은 차단됨.

녹음 후

  1. npm run mos -- footage <pkg> (소스가 input/에 있는 경우).
  2. npm run mos -- captions transcribe <pkg> <음성 파일> — 로컬 faster-whisper 사용, 다운로드 불필요. 모델 없음 → 설치 전에 권한 요청 (docs/VIDEO_PIPELINE.md 참조).
  3. ASR(자동 음성 인식)은 드래프트입니다. 이름, 숫자, 부정어, 어미, 조용한 단어, 구문 경계를 확인합니다. 수정 사항은 transcript/corrected.<파일>.json과 transcript/CORRECTIONS.md의 한 줄에 기록됩니다. transcript/raw-asr.*은 변경 불가입니다. 불확실한 경우 → [inaudible] 표시 후 사용자에게 질문합니다. 절대 추측하지 마세요. 실제로 듣지 않았다면 들었다고 주장하지 마세요.
  4. 실제 음성이 스크립트와 다른 경우, 차이점을 보여주고 사용자와 결정합니다(원래 음성 유지 / 재편집 / 재녹음). 자막은 실제 음성을 따릅니다. 오디오에 없는 단어를 절대 추가하지 마세요.
  5. npm run mos -- captions map <pkg> → npm run mos -- captions build <pkg> --source transcribed.
  6. 선택 사항: npm run mos -- captions calibrate <pkg> raw-asr.<파일>.json --write — 제작자의 실제 속도를 brand.json에 기록합니다.

모드 및 그룹화

기본 모드: brand.json → defaults.captionMode; 동영상별: props.captions.mode. replace — 짧은 그룹이 서로 교체됨; accumulate — 단어가 작은 계단 블록을 만듦; highlight — 요청 시 사용. 강조: 스크립트 음성에서 *word* (전사된 음성의 경우 corrected에 emphasis 표시). 의미별로 그룹화합니다. 부정어와 동사를 분리하지 마세요("don't / know"), 전치사와 단어를 분리하지 마세요("in / the app"), 숫자와 단위를 분리하지 마세요("30 / seconds"), 이름도 분리하지 마세요. 한 줄에 단어 하나가 매달리지 않도록 합니다. brand.json → captions.protectedPhrases를 유지합니다. 러시아어 규칙은 ru 언어 팩에 정의되어 있습니다.

확인

스튜디오: 각 페이지의 시작/끝, 자막-억양 전환 시 중복 없음, 휴대폰에서 가독성, 눈 위에 텍스트 없음. mos qa는 실제 글꼴 측정값으로 줄 넘침을 검사합니다.

Individual skills in this repo

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

관련 스킬