Tela Viva: 애니메이션 튜토리얼 Reel
3가지 스타일 키트: 사용자가 스타일을 지정하지 않고 Reel을 요청했을 때 Modo 8-Bit(픽셀 아트) 및 Hora Dourada(스토리 및 튜토리얼용 플랫 캐릭터) 스킬도 보유한 경우, 먼저 세 가지 스타일 중 원하는 것을 물어보세요.
이 스킬은 주제를 화면 튜토리얼 스타일의 세로형 Reel(1080×1920, 30fps, MP4)로 변환합니다:
- 상단: 진행률 표시줄과 짧은 제목 옆에 단계 번호;
- 중앙: "작동하는"(텍스트 입력, 응답 표시, 강조 표시, 민감한 데이터 위 검은색 막대) 브랜드가 없는 범용 창;
- 하단: 단어 단위 자막(말하는 단어가 브랜드 색상으로 표시됨);
- 끝: "팔로우 해주세요" 카드.
비디오는 코드(Python + ffmpeg)로 조립됩니다. AI 비디오 생성기를 사용하지 않습니다. 40초 Reel은 1분 이내에 완성됩니다.
항상 사용자의 언어(일반적으로 포르투갈어)로 응답하세요.
1단계: 요청 이해 (한 번의 질문으로, 누락된 모든 것)
사용자가 아직 말하지 않은 것만 한 번에 질문하세요:
- 주제: 시청자가 무엇을 배우거나 테스트하게 될까요? 사용자가 이미 나레이션 텍스트를 가져온 경우 해당 텍스트를 사용하세요.
- 브랜드: 기본 색상(16진수, 예:
#7C3AED)과 프로필 @입니다. 답변이 없으면 보라색#7C3AED및@seuperfil을 사용하고 알리세요.
사용자가 "알아서 해줘"라고 말하면 묻지 말고 기본값을 사용하고 어떤 값을 사용했는지 알리세요.
2단계: 스크립트 작성
roteiro.json 파일을 만드세요(아래 형식; 준비된 템플릿은 exemplos/roteiro-exemplo.json에 있음).
작동하는 구조(58개 장면, 3060초):
- 갈고리 (
!표시): 시청자가 알아볼 수 있는 상황, 나레이션 10단어 이내. - 번호 매겨진 단계 (
1,2,3... 표시): 장면당 하나의 작업, 창에 작업 표시. - 주의 (단계 중 하나일 수 있음): 결과 확인 및 민감한 데이터 붙여넣지 않기.
- 행동 촉구 (
✓표시): 예: 포스트잇(nota)과 함께 "자막에 프롬프트". - 마지막 (
"tipo": "final"): "더 많은 정보를 위해 팔로우 해주세요...".
콘텐츠 규칙:
- 최대 6단어 제목.
*별표*로 1~2개 단어 강조. - 나레이션: 초당 약 2.3단어. 각 장면의 길이는 나레이션에서 결정됩니다.
- 가상의 데이터, 이름 및 회사("사람 A", "공급업체")를 사용하고 데이터가 있는 장면에
"exemplo": true를 표시하세요. - 실제 도구의 이름, 로고 또는 화면을 넣지 마세요. 창은 일반적입니다("AI 어시스턴트", "스프레드시트", "받은 편지함").
- 기능, 공식, 숫자 또는 결과를 지어내지 마세요. 스크립트가 도구의 기능을 언급하는 경우 공식 출처(가능하면 웹 검색)에서 확인하고 확인한 내용을 사용자에게 알리세요. 확인할 수 없으면 알리세요.
- 과장된 약속("10시간 절약", "더 이상 안 함")을 하지 마세요.
3단계: 비디오 전 테스트 프레임
각 장면 중간 시간(시간은 출력 시작 부분에 나타남)으로 미리보기를 실행하세요:
python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32
saida/previa_grade.jpg를 열고 확인하세요:
- 창 밖으로 나가는 텍스트 없음;
- 2줄을 초과하는 제목 없음;
- 강조 표시와 블러 막대가 올바른 위치에 있는지.
필요하면 JSON을 조정하고 반복하세요. 그런 다음 사용자에게 그리드와 스크립트를 표(장면, 표시 내용, 나레이션, 시간)로 보여주고 비디오를 생성해도 되는지 물어보세요.
4단계: 비디오 생성
python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --nome meu-reel
명령어가 생성하는 파일:
saida/meu-reel-sem-voz.mp4: 스크립트 자체에서 생성한 차분한 배경 음악과 키보드 사운드 포함(타사 음악 없음);saida/guia-narracao.txt: 장면당 한 단락씩, 음성으로 말할 텍스트만 포함;saida/tempos.txt: 각 장면의 시작과 끝 시간.
--sem-musica를 사용하여 배경 음악 없이 비디오를 생성하세요.
사용자에게 전달:
- 비디오;
- 나레이션 가이드 및 시간;
- 게시물 자막(갈고리, 단계별, 전체 프롬프트(있는 경우), "예시입니다." 및 해시태그 3~5개).
보내기 전에 최종 MP4의 4~5개 프레임을 확인하세요(ffmpeg으로 추출).
5단계: 음성 (사용자가 오디오를 보낼 때)
사용자는 가이드에 따라 나레이션을 녹음합니다(휴대폰에서 직접 또는 원하는 경우 AI 음성 사용). 파일을 보내면:
python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --nome meu-reel --audio /경로/음성.m4a
- 시간 표시가 없으면 스크립트가 각 장면의 단어 비율에 따라 오디오 길이에 장면을 분산합니다.
- 정확한 동기화를 위해 JSON에
"marcas_audio": [0, 7.8, 15.2, ...]를 넣고 녹음에서 각 장면이 시작되는 초를 입력하세요. 사용자가 이 시간을 말해주거나, 단어별 시간이 있는 전사 도구가 있으면 파일을 들을 수 있습니다. - 결과는
saida/meu-reel-com-voz.mp4이며, 음성 아래에 배경 음악이 더 작게 들립니다.
다른 옵션: 사용자가 비디오 편집기(CapCut, InShot, Instagram 편집기)에서 직접 음성을 추가할 수 있습니다(음성 없는 비디오 사용).
전달 시 알림: AI로 생성된 음성, 이미지 또는 비디오가 있는 경우 사용자는 게시할 때 AI 라벨을 표시해야 합니다.
roteiro.json 형식
{
"marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "프로필 짧은 문구"},
"palavras_por_segundo": 2.3,
"cenas": [
{"selo": "!", "titulo": "받은 편지함 *가득 참?*", "narracao": "...", "exemplo": false,
"duracao": 6.5,
"janela": {"tipo": "lista", "...": "..."},
"nota": {"texto": "자막에 프롬프트 ↓", "sub": "저장", "em": 0.4},
"pilula": {"texto": "끌 수 있음", "em": 0.3, "y": 0.4}}
]
}
duracao는 선택 사항: 없으면 나레이션에서 길이가 결정됩니다.- 마지막 카드는 @의 첫 글자를 표시합니다. 사용자가 요청하지 않으면 마스코트를 넣지 마세요.
nota(포스트잇)와pílula(떠 있는 레이블)는 선택 사항입니다.em값은 장면 내에서 나타나는 비율입니다(0~1).- 흰색 배경에서 텍스트를 읽기 어려운 경우 색상이 자동으로 어두워집니다.
창 텍스트 표시: [[구간]]은 장면 중에 나타나는 강조 표시가 됩니다. {{구간}}은 구간(민감한 데이터)을 덮는 검은색 블러 막대가 됩니다.
tipo | 용도 | 필드 |
|---|---|---|
lista | 받은 편지함, 할 일 목록, 파일 | titulo, itens([발신자, 제목, 미리보기]), nao_lidas(인덱스), destaque(인덱스), tremer, destaque_em |
texto | 대화, 메모, 문서 | titulo, resumo({titulo, linhas}), resumo_animado, mensagens([{autor, texto}]), marcar_em, tarjar_em, etiquetas(✓가 있는 레이블), etiquetas_em |
chat | AI 어시스턴트(어두운 창) | titulo, prompt(입력됨), resposta(줄 목록, 선택 사항), caracteres_por_segundo |
escrever | 이메일 또는 메시지 답장 | titulo, texto(입력됨), botao |
planilha | 간단한 표 | titulo, colunas, linhas, coluna_destaque, formula(선택 사항, 확인된 공식만), revelar_ultima |
cartao | 강조 표시된 뉴스, 규칙 또는 요약 | selo, titulo(*강조* 허용), texto, fonte(정보 출처) |
final | "팔로우 해주세요" 카드 | bio, botao, clique_em |
일반적인 문제
- "ffmpeg를 찾을 수 없습니다": 스크립트가 pip를 통해
imageio-ffmpeg를 자동으로 설치하려고 시도합니다. 실패하면pip install imageio-ffmpeg(필요한 경우--break-system-packages포함)를 실행하세요. - 텍스트가 잘리거나 창 밖으로 나감: 텍스트를 줄이거나, 두 개의 메시지로 나누거나, 목록 항목 수를 줄이세요(약 5줄까지 가능).
- 자막이 너무 빠름: 장면의
duracao를 늘리거나 나레이션 단어를 줄이세요. - 폰트: Inter 및 JetBrains Mono(SIL Open Font 라이선스,
assets/fonts에 파일 있음).