Futuros Residentes / Doc Juanes 릴 편집
편집 결정을 내리기 전에 references/estilo.md를 읽으세요: 승인된 스타일과 각 규칙의 이유가 있습니다.
무언가 실패하면 references/problemas.md를 확인하세요: 잘못될 수 있는 거의 모든 것이 이미 한 번 발생했습니다.
음악은 references/musica.md를 참조하세요.
비디오를 요청한 사람과 협업하는 방법
- 그/그녀에게 스페인어로, 명확하고 기술적인 용어 없이 작성하세요. 프로그래머가 아닐 수 있습니다: 당신이 무엇을 보고 무엇을 할 것인지 설명하세요.
- 실행하기 전에, 행동 계획을 요약하고 승인을 기다리세요, 항상, 각 단계에서 (초기 계획, 각 변경 라운드, 표지, 음악). 요약에는 두 가지 기준이 포함됩니다: 시청각적 (무엇을 할 것인지, 단계별) 그리고 재정적: 토큰 소비 예측 ("토큰 소비" 참조). 원자재를 미리 준비하고 기록할 수 있으며, 계획이 구체적이도록 합니다.
- 당신은 오디오를 들을 수 없습니다. 측정 및 재전사를 통해 확인하고, 주관적인 내용(음향 효과, 음악 볼륨, 매우 빡빡한 컷)은 그/그녀가 듣도록 요청하세요.
- 각 버전에서 그/그녀에게 프레임과 MP4를 보여주세요. 변경을 요청하면, 그/그녀가 언급한 편집된 비디오의 초 단위로 찾아내고 (
src/Reel/edit.json에 매핑) 어떤 문장인지 확인하세요. - 브랜드: 계획에서 비디오가 Doc Juanes인지 **Futuros Residentes (FR)**인지 확인하세요. 프로젝트 폴더와 알림이 전송되는 Google Chat 공간을 정의하세요 (9단계).
- 이름: 계획에서 밑줄이 있는 대문자로 된 짧은_이름을 제안(또는 요청)하세요
(예:
JUANCHO_PASASTE); 이것은 프로젝트 폴더의 이름이기도 합니다.- 검토 중: 각 버전에 번호를 매겨 이전 버전을 보지 않도록 합니다 ("변경 사항이 감지되지 않음"):
NOMBRE_CORTO_REEL_v2.mp4,NOMBRE_CORTO_PORTADA_1.jpg… 다운로드에는 최신 버전만 유지합니다. - 최종 버전이 승인되면, 번호를 포함한 다른 모든 것을 제거하고 이름을 바꿉니다:
NOMBRE_CORTO_REEL.mp4및NOMBRE_CORTO_PORTADA.jpg, 그리고 다운로드에서 폐기된 버전과 표지를 제거합니다. - 표지: 하나가 선택되는 즉시, 즉시
NOMBRE_CORTO_PORTADA.jpg로 이름을 바꾸고 (번호 없이), 다운로드 및out/portadas/에, 비디오가 여전히 검토 중이더라도, 다른 옵션을 제거합니다. 이후 선택된 표지에 대한 조정을 요청하면, 번호가 없는 동일한 파일을 덮어씁니다. - 그/그녀에게 보내는 테스트 이미지 (글꼴, 색상, 조명, 효과, 검토 프레임):
NOMBRE_CORTO_PRUEBA_<주제>_N.jpg(예:NOMBRE_CORTO_PRUEBA_FUENTES_1.jpg). 최종 버전이 승인되면, 폐기된 버전과 마찬가지로 제거합니다: REEL과 PORTADA만 남습니다. rm으로 사람의 파일을 절대 삭제하지 마십시오:./scripts/papelera.sh <파일들>을 사용하세요 (Mac 휴지통 또는 Windows 휴지통; 복구 가능).
- 검토 중: 각 버전에 번호를 매겨 이전 버전을 보지 않도록 합니다 ("변경 사항이 감지되지 않음"):
- 음악: 모든 비디오에 음악이 있는 것은 아닙니다. 요청된 경우에만 추가합니다. 이미 사용된 노래를 절대 반복하지 마십시오 (목록은
references/musica.md에 있음), Janeth가 재사용을 승인하지 않는 한. - 대화형 프로그램(
npx create-video와 같은)은 터미널 패널의 탭에서 실행됩니다: 그/그녀에게 탭을 클릭하고 거기서 응답하라고 말하고, 각 질문을 설명하세요.
이 스킬을 변경할 수 있는 사람
스킬은 GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes)에 있으며 Janeth Cardona만 수정합니다.
어떤 컴퓨터에 있는지 확인하려면: git -C ~/.claude/skills/editar-reel-fr config user.email.
- 응답이
[email protected](Janeth의 컴퓨터)인 경우: 스킬을 변경하기 전에 항상 그녀에게 물어보고 그녀의 승인을 기다리세요; 한 줄로 무엇을 변경할 것인지와 그것이 모든 비디오에 왜 유용한지 설명하세요 (그녀가 직접 변경을 요청한 경우 이미 승인된 것입니다). 비디오의 특정 사항 (노래, 시간, 위치, 볼륨)은 해당 프로젝트에만 속하며, 스킬에는 절대 속하지 않습니다. 변경 후:git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<변경 사항>" && git push. - 다른 모든 컴퓨터에서는 절대 스킬 파일을 수정하지 마십시오. 모든 사람에게 도움이 되는 개선 사항이나 문제를 발견하면, 그 사람에게 Janeth에게 알리라고 말하고 보낼 텍스트를 작성하세요 (무슨 일이 있었는지, 어떤 비디오에서, 무엇을 제안하는지).
- 사용된 노래는
references/musica.md에 기록됩니다; 다른 컴퓨터에서는 Janeth에게 제목, 아티스트 및 링크를 전달하여 추가하도록 하세요.
토큰 소비 (계정은 팀 전체가 공유)
Claude의 각 단계는 전체 대화를 다시 읽습니다: 이것이 거의 모든 비용이며 길이에 따라 증가합니다. 따라서:
- 비디오당 새 대화. 비디오가 승인되면 다음 비디오를 위해 새 대화를 시작할 것을 제안하세요. 동일한 대화를 계속하면 2~3배 더 비쌀 수 있습니다.
- 일괄 변경: 모든 수정 사항을 번호가 매겨진 단일 메시지로 모으도록 요청하고, 단일 내보내기에서 적용하세요.
- 적게 그리고 작게 읽으세요: 축소된 프레임 스트립 (
SCALE=0.25-0.35), 파일 및 출력의 필요한 부분만 (tail,grep), 의심스러운 부분만 다시 전사하세요. 큰 이미지는 비용이 많이 듭니다. - 묻지 않고 기다리세요: 긴 내보내기는 백그라운드에서 실행됩니다. 매분 확인하지 마세요.
- 요청되지 않은 단계 없음: 스티커, 음악, AI 배경 또는 추가 검색은 요청된 경우에만 수행합니다.
각 계획의 예측 (실제 30-45초 비디오에서 측정된 수치, Claude Opus 5.5 API 공개 요금, 새 대화 기준). 계획의 단계, 범위 및 총계를 보여주는 짧은 표를 표시하고, 대략적인 것임을 명확히 합니다:
| 단계 | Claude 단계 수 | 예상 비용 |
|---|---|---|
| 계획 준비, 전사 및 제시 | 15-25 | US$ 1-2 |
| 시각적 제안 (글꼴, 색상, 조명) 샘플 포함 | 8-15 | US$ 1-1.5 |
| 편집 구성, 승인 텍스트 및 v1 내보내기 | 20-35 | US$ 2-3 |
| 각 변경 라운드 + 새 내보내기 | 10-25 | US$ 1-2.5 |
| 음악 검색 및 조정 | 10-20 | US$ 1-2 |
| 표지 3개 | 8-15 | US$ 1-1.5 |
| 일반적인 전체 비디오 (계획, v1, 2라운드, 표지) | 80-130 | US$ 7-12 |
Team/Enterprise 플랜의 경우 청구서가 다를 수 있습니다. 수치는 옵션을 비교하는 데 사용됩니다. 사람이 비용을 절약하려면 구체적인 대안(라운드 감소, 음악 없음, 새 표지 없음, 또는 간단한 비디오에 더 경제적인 모델 사용)을 제공하십시오. 결정은 그 사람의 몫입니다.
각 비디오를 마감할 때, python3 scripts/consumo.py --desde "<비디오 첫 번째 메시지 텍스트>"로 실제 소비를 측정하고 예측과 함께 공유하십시오. 차이가 크고 Janeth의 컴퓨터에 있는 경우 이 표를 조정할 것을 제안하십시오.
0단계: 도구 (머신당 한 번) 및 스킬 업데이트
git -C ~/.claude/skills/editar-reel-fr pull -q # 스킬의 최신 버전을 가져옴 (각 비디오)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh # $PY, $FF, $PROYECTOS, $DESCARGAS 내보내기
자체 환경에 완전한 ffmpeg, faster-whisper, DeepFilterNet (에코 제거) 및 OpenCV를 설치합니다. 첫 번째 전사는 large-v3-turbo 모델 (~1.6GB)을 다운로드합니다: 먼저 허가를 요청하세요.
- Mac: Node.js 및 Python 3이 필요합니다 (Xcode 도구와 함께 제공되거나 한 번 설치).
- Windows: Claude Code는 Git Bash를 사용하며, 이러한 프로그램은 거기서 실행됩니다. 한 번만, Python 3.11 및 Node.js LTS를 설치합니다 (
winget install Python.Python.3.11및winget install OpenJS.NodeJS.LTS, 사람의 허가를 받아; Python 3.12 이상은 작동하지 않습니다). Windows에서 무언가 실패하면references/problemas.md를 확인하고 Janeth에게 알리세요.
1단계: Remotion 프로젝트
- 프로젝트는 **
$PROYECTOS/<BRAND>/SHORT_NAME**에 있으며,<BRAND>=Doc Juanes또는FR(Mac: 동영상 → Reels Doc Juanes; Windows: 비디오 → Reels Doc Juanes), 비디오당 하나입니다. 복사할 이전 프로젝트: 두 하위 폴더에 있습니다. - 가장 빠른 방법: 이전 프로젝트에서
package.json,package-lock.json,tsconfig.json,remotion.config.ts,src/index.ts,src/index.css및src/Root.tsx와node_modules를 복사합니다 (Mac:cp -c -R, 즉시 복제; Windows:npm ci). 이전 프로젝트가 없는 경우:npx create-video@latest(Blank, Tailwind Yes),npm i및npm i @remotion/google-fonts@<remotion 버전>. - 템플릿 및 스크립트:
cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel및mkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/. - 구성을 등록합니다 (
assets/template/Root.snippet.tsx참조) 및"resolveJsonModule": true.
2단계: 원자재 준비
- 프레임을 추출하고 (
"$FF" -ss 20 -i crudo -frames:v 1 x.jpg) 확인: 방향 (사람이 옆으로 나오면ccw/cw사용), 벽 색상 (키워드 색상 결정) 및 얼굴 위치 (FACE_ORIGIN). FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw>→public/video-vertical.mp4(그림자를 밝게 하는 조명 곡선 포함;LIGHT=0으로 제거) +work/의 오디오.- 배경이나 조명 개선 요청 시 (배경 복잡, 위쪽 조명으로 인한 어두운 얼굴):
scripts/fondo-luz.pyAI로 사람을 분리하고 흐릿한 배경, 얼굴을 따라가는 채우기 조명, 원하는 경우 벽에 스테인드 글라스 스타일의 컬러 조명으로public/video-fondo.mp4를 만듭니다.edit-config.json→"fondo"에서 조정 (스크립트 헤더 참조);build-edit.py이후에 실행됩니다 (사용된 부분만 처리; 부분이 변경되면 다시 실행하십시오, 그렇지 않으면 해당 프레임이 처리되지 않은 채로 나타남) 및VIDEO_SRC = "video-fondo.mp4"로 활성화됩니다. 그 전에 테스트 프레임을 보여주세요. 스타일은 미묘함을 선호합니다: 약한 흐림 (5), 매우 부드러운 가장자리 (14) 및 매우 희미한 스테인드 글라스/보케.
3단계: 전사 및 매핑
"$PY" scripts/transcribe.py # 시간이 포함된 문장 → work/transcript.json
"$PY" scripts/energy.py words # 각 단어의 볼륨 대비 문장 (+dB = 강조)
편집 맵을 구성하고 짧은 목록으로 말하세요:
- 제외: 클래퍼보드 ("준비, 대본 N…"), 가짜 테이크 ("다시", 욕설, 웃음), 반복된 문장 (가장 깨끗한 테이크 유지; 일반적으로 마지막 것), 잘못된 시작, 마무리 ("준비").
- 후크: 첫 번째 강력한 문장; 먼저 옵니다.
- 늘어진 단어 (예: 3초 "아니오"), 이상한 단어 또는 전사되지 않은 음성 = 반복된 테이크 또는 잘못된 시작: 해당 부분만 다시 전사하세요 (오디오 조각에 대한 WhisperModel) 및
energy.py zoom <start> <end>로 세부 조정. - 대본에 잘못된 데이터 (잘못 말한 숫자)가 있는 경우, 잘라내기를 제안하십시오; AI로 음성을 모방하지 마십시오.
4단계: 오디오
FF="$FF" PY="$PY" ./scripts/audio.sh # 에코가 적고 자연스러운 음성 (DeepFilterNet + 부드러운 확장기, −14 LUFS)
"$PY" scripts/energy.py # 깨끗한 음성에 대해 측정 → 더 빡빡한 컷
"$PY" scripts/sfx-stickers.py # 소리가 있는 스티커가 있는 경우에만
"$PY" scripts/sfx-tear.py # 찢어지는 사진이 있는 경우에만
5단계: edit-config.json: 편집 결정
기본: assets/edit-config.example.json. 모든 시간은 원시 비디오의 초 단위입니다:
clips: 문장 또는 아이디어당 하나의 클립, 순서대로, 넉넉한 여백 포함. 스크립트는 내부 및 외부의 침묵을 자르고, 단어를 절대 자르지 않습니다.fx:punch(계속),whoosh(주제 변경),leak(색상이 있는 햇빛 섬광; 영감을 주는 비디오의 경우estilo.md참조),flash(흰색 섬광).zoom은 클립의 프레임을 고정합니다;steps: [[seg, zoom], …]는 오디오를 자르지 않고 프레임의 계단식입니다.hold_zoom: true= 단일 프레임.tail: 0.1= 컷이 부드러운 마지막 자음을 잘라내는 경우 클립 끝에 추가 여백.emphasis: 힘있게 말하거나 중요한 단어의[단어, 초](~1.5-2초마다 약 1개).word_fixes: 단어의 실제 시간. 이후 클립 내에 있는지 확인하십시오 (이전 침묵에 떨어지면 자막에서 사라집니다).idea_start: 아이디어 시작의 대문자 (0.1초 미만의 모든 단어에 영향을 미침: 다음 단어가 매우 가까운 경우, 예: "Y no", 첫 번째 단어 바로 전에 시간 사용).text_fixes:[{"at": seg, "text": "pregunta:"}]단어의 정확한 텍스트 (예: ":" 유지).brand_words("Futuros Residentes", "Doc Juanes" 보호; "UdeA"와 같은 다른 추가),small_extra(단독으로 절대 사용되지 않는 짧은 단어: "fue", "esa", "mi", "tan"…).photos:{src, show_at, tear_at}(찢어짐) 또는{src, show_at, hide_at}.stickers(요청된 경우에만; 예제는assets/edit-config.stickers.example.json에 있음):{kind, show_at, hide_at, x, y, size, sfx: [[파일, 초, 볼륨]]}. 유형:broken-heart(break_at) 및src/Reel/Stickers.tsx의ART그림. 새 것의 경우, 자체 SVG로 그리십시오 (Apple 이모지나 저작권이 있는 이미지 절대 사용 금지). 사람이 손을 움직이는 곳에 배치하십시오 (프레임 확인), 얼굴이나 자막 위에는 절대 배치하지 마십시오. 효과가 머리를 따라가야 하는 경우,"$PY" scripts/head-track.py <start> <end>+follow_head: true가 프레임별 위치를 제공합니다 (track).sounds:[[파일, 초, 볼륨, 오프셋_초]];shakes: 흔들림이 있는 초 (충격).end_push: {at, to}: 기본 종료, 얼굴로의 부드러운 확대 (~1.6) 검은색 페이드 없음.end_hold: 끝에 추가 초.speed: 가속 요청 시 (7단계 참조).- 기본 글꼴 (일반 단어): Montserrat Black 900, 검은 테두리가 있는 흰색, 비디오 브랜드가 다른 것을 요구하지 않는 한 (예: 웹사이트 글꼴이 있는 Futuros Residentes 비디오).
- 강조된 단어: 비디오의 분위기에 따라 계획에서 제안하십시오, 실제 프레임에 대한 2~3가지 옵션 포함: 단일 글꼴 또는 두 가지 글꼴 (예: 감성적인 부분에는 우아한/세리프, 임팩트 있는 부분에는 굵은 글꼴), 동일한 색상 또는 다른 색상 사용. 분위기에 맞는 글꼴 및 색상 (영감, 향수, 활기찬, 코믹…).
EMPH_*(첫 번째) 및EMPH2_*(두 번째,emphasis에서"alt"로 표시된 단어)는constants.ts에 있습니다. 색상은 벽과 대비되어야 합니다. echo:[[start, end]]중요한 문장에 부드러운 에코 (이후:"$PY" scripts/eco.py). 제안하십시오 그러한 문장을 감지하면, 또는 요청되면 적용하십시오.
…
[번역을 위해 잘림]