bp-abe/skills-video

동영상을 클라우드에 업로드하기

video-animado가 프로젝트에 MP4를 전달합니다. 이 스킬은 팀이 인식할 수 있는 이름으로 파일을 클라우드 폴더에 배치합니다. 이러한 이름은 나중에 각 크리에이티브의 결과를 분석하기 위한 키가 됩니다.

패턴

<사용자가 확인한 대상 폴더>/
  <캠페인 이름>/
    30S/                                     지속시간별 하위 폴더
      vvs_bala_coroa/                        동영상별 폴더
        vvs_vertical_bala_coroa.mp4          9:16 · 1080×1920
        vvs_wide_bala_coroa.mp4              16:9 · 1920×1080
        vvs_square_bala_coroa.mp4            1:1  · 1080×1080
        como_foi_feito.md                    동영상 제작 과정
    15S/
      vvs_bala_coroa/ …

• 파일 이름: <접두사>_<형식>_<키워드>.mp4, 모두 소문자입니다. 접두사는 기본적으로 vvs이며 매니페스트의 "prefixo"로 변경됩니다.
• 형식: 세로형은 vertical, 정사각형은 square, 가로형은 wide가 됩니다. 존재하지 않는 형식은 제외하며, 임의로 만들지 않습니다.
• 키워드: 동영상 제목에서 추출한 1~4개의 단어로, 소문자이며 악센트를 제거합니다. 관사, 전치사, "e", "que"는 제외됩니다(스크립트가 자동 처리).
  • "A bala na coroa" → vvs_vertical_bala_coroa.mp4.
  • "Três crianças diante do poder" → vvs_wide_tres_criancas_diante_poder.mp4.
  • 4개를 초과하면 매니페스트의 "palavras"에서 선택하며, 스크립트는 선택될 때까지 거부합니다.
• 동영상 폴더는 <접두사>_<키워드>입니다. 지속시간은 하위 폴더(30S/, 15S/)와 레코드에만 포함됩니다. 14.0초 컷은 15S/에 들어갑니다.
• 동일한 제목의 두 가지 지속시간은 서로 다른 폴더에 동일한 파일 이름을 생성합니다. 스크립트가 경고합니다. 광고 관리자에서는 광고 이름에 지속시간을 포함하세요.
• como_foi_feito.md 는 모든 동영상 폴더에 포함되어, 누구나 제작 과정을 분석할 수 있습니다. 스크립트는 원본 프로젝트(atributos.projeto)에서 문서를 구성합니다:
  • 기술 사양;
  • 연출, 음성 및 배경음악;
  • roteiro.json에서 가져온 컨셉 및 스크립트;
  • 프로젝트의 ANALISE.md 및 RELATORIO.md: 브리프, 컨셉, 바이블 및 비평 노트.

단계별 절차

1. 대상 폴더: 요청자가 항상 확인합니다. 절대 추측하지 마세요. 말하지 않으면 물어보세요.
2. 동기화된 폴더의 로컬 경로를 찾습니다. macOS에서 Google Drive 데스크톱은 ~/Library/CloudStorage/GoogleDrive-<이메일>/ (Meu Drive/, Drives compartilhados/)에 있습니다. Drive 링크와 Drive 커넥터가 있는 경우 상위 폴더 체인(parentId)을 통해 동기화에 존재하는 이름까지 찾을 수 있습니다. 동기화된 폴더로 복사하는 것이 업로드입니다. API를 통해 큰 MP4를 보내지 마세요.
3. 매니페스트를 작성합니다(manifesto.json, 아래 모델 참조): 각 동영상의 제목, 명목 지속시간, 형식별 파일 경로, 분석용 속성(크리에이티브 방향, 프로세스, 음성, 배경음악, 원본 프로젝트)을 포함합니다.
4. 이름 표와 대상을 복사 전에 표시합니다. 단, 이미 바로 업로드하라고 지시한 경우는 예외입니다. 보통 공유 폴더입니다.
5. 실행: python3 ~/.claude/skills/subir-videos/subir.py manifesto.json.
   • 먼저 --seco 플래그로 실행: 이름만 검증하고 표시합니다.
   • 파일이 이미 클라우드에 있으면 --so-registro 사용: 레코드만 기록합니다.
   • 스크립트는 해상도와 지속시간을 확인하고, 패턴을 벗어난 이름이나 중복 제목을 거부하며, 폴더를 만들고, 복사하고, 각 동영상의 como_foi_feito.md를 작성하고, 전체 레지스트리 ~/videos/VVS_REGISTRO.csv에 행을 추가합니다.
6. 몇 분 후 클라우드를 확인합니다. 동기화는 백그라운드에서 진행되며 큰 파일은 시간이 걸립니다.
7. 폴더 링크와 이름 표를 전달하고, 프로젝트의 ANALISE.md에 각 동영상의 위치를 기록합니다.

매니페스트 (모델)

{
  "destino_local": "~/Library/CloudStorage/GoogleDrive-<이메일>/Drives compartilhados/<드라이브>/<폴더>",
  "campanha": "캠페인 이름",
  "prefixo": "vvs",
  "drive_link": "https://drive.google.com/drive/folders/<대상 폴더 ID>",
  "videos": [
    {"titulo": "A bala na coroa", "duracao": "30S",
     "arquivos": {"vertical": "…/out/30s_9x16.mp4", "wide": "…/out/30s_16x9.mp4", "square": "…/out/30s_1x1.mp4"},
     "atributos": {"direcao": "캐릭터가 있는 2D 애니메이션", "processo": "pedido-de-video + video-animado",
                   "voz": "Gemini TTS", "trilha": "Lyria, ~120 bpm", "projeto": "~/videos/<slug>"}}
  ]
}

레지스트리가 존재하는 이유

<접두사>_<형식>_<키워드> 이름은 결과(광고 이름에 지속시간 포함)와 교차 분석하기 위한 키입니다. 팀은 이 이름으로 크리에이티브를 광고 관리자에 업로드하며, 이 이름이 미디어 데이터의 광고 이름에 나타납니다. VVS_REGISTRO.csv는 각 동영상의 속성(방향, 프로세스, 음성, 배경음악, 실제 지속시간)을 저장하여, 나중에 무엇이 효과적이고 그렇지 않은지 비교할 수 있습니다. 개인 데이터는 저장하지 마세요.

금지 사항

• 확인되지 않은 폴더에 업로드하지 마세요. 또한 폴더에 있는 다른 사람의 파일을 삭제하거나 이름을 변경하지 마세요.
• 임의로 이름 패턴을 변경하지 마세요: 패턴 변경은 요청자의 결정입니다.
• MP4는 git 저장소에 넣지 마세요.