언박싱 / 제품 영상
적합: 제품 촬영, 언박싱, 사용 시연, 매장 제품 촬영 클립. 사람이 말하지 않아도 됩니다. — 스킬이 자동으로 대본을 작성하고 AI 음성으로 읽어줍니다.
부적합: 긴 대화 영상 (video-phu-de-to 사용).
포맷 (15~30초, 판매용)
- 사용자에게 묻기 (한 번의 메시지로, 아직 묻지 않은 경우): 제품명, 가격(할인 중이라면 원래 가격도), 2~3가지 주요 장점, 구매 대상, 클릭 유도 문구 (장바구니 / 인박스 / 바이오 링크).
- 장면 선택: 분석 그리드 이미지를 보고 5
9개 구간(각 1.53초) 선택: 가장 좋은 장면을 처음에 배치하고, 이후 세부 사항, 사용 시연, 결과 순서. 흐릿하거나 흔들리거나 손이 가린 장면은 제외. 본문 영상 길이는 음성 길이에 맞춥니다. - 음성 (
giong_doc) 템플릿 4단계:- 갈고리 (0~3초): 고통점 자극 또는 호기심 유발. "집이 좁아도 에어프라이어를 쓰고 싶나요?"
- 소개: 제품이 무엇인지, 한 문장.
- 2~3가지 구체적 혜택: 가능하면 수치 포함 ("5리터", "단 15분").
- 마무리: 가격 + 클릭 유도. "가격은 890,000동, 왼쪽 아래 장바구니를 클릭하세요."
- 15
25초 기준 5090자. 자연스러운 구어체, 건조한 사양 나열 금지.
- 화면 텍스트:
mo_dau0~2.8초 (7자 이하);gia음성이 가격을 언급할 때 (예: "890K");cta본문 마지막 3초 ("장바구니 클릭 🛒" — 폰트가 지원하지 않으면 이모지 사용 금지). - 가로 영상 입력: 자동으로 흐린 배경 위에 배치, 제품이 잘리지 않도록 함.
- 원본 오디오: 음소거 (AI 음성으로 대체). 원본 오디오에 가치가 있는 경우 (지글거리는 소리, 언박싱 소리) 첫 번째 버전에서는 음소거하고 사용자에게 추후 문의.
- edge-tts 미지원 / 네트워크 없음:
giong_doc생략, 화면 텍스트 + 배경 음악만 사용 (각 혜택에nhan텍스트 추가).
이 스킬의 텍스트 스타일
| 유형 | 용도 | 위치 |
|---|---|---|
mo_dau | 처음 3초 갈고리 문장 | 상단, 흰색 굵은 테두리, 약간 기울임 |
gia | 가격, 할인율 | 중앙, 강조 색상 배경, 매우 큰 글씨 |
nhan | 짧은 혜택 ("5리터", "들러붙지 않음") | 상단, 기본 색상 배경 |
cta | 마지막 클릭 유도 | 하단 중앙, 강조 색상 배경 |
일반 작업 흐름 (모든 영상 유형)
모든 명령은 이 스킬의 디렉토리(SKILL.md 파일이 있는 디렉토리)에서 실행합니다. <SKILL>은 해당 디렉토리 경로를 의미합니다.
단계 0. 확인 (매 사용 시)
Python 명령: macOS는 python3 사용, Windows는 py -3 사용 (python만 사용 금지: Windows의 기본 python은 Microsoft Store 버전으로 문제 발생 가능). 경로는 / 사용, Git Bash 및 PowerShell 모두에서 실행 가능. 아래는 python3로 작성했지만 Windows에서는 py -3로 대체.
python3 <SKILL>/scripts/kiem_tra.py
thieu_bat_buoc가 비어 있지 않으면 → 사용자에게 설치할 목록을 보여주고 한 번 "이 항목들을 설치하시겠습니까?"라고 묻고 동의한 후에만 실행. Windows에 Python이 없는 경우:winget install -e --id Python.Python.3.12 --scope user. ffmpeg 설치 후 Windows에서는 명령 창을 다시 열거나(또는 Agent를 재시작)ffmpeg명령을 인식하도록 해야 함.thieu_tuy_chon→ 필요할 때만 설치:faster-whisper(음성 자막용, 첫 실행 시 ~800MB 모델 다운로드),edge-tts(AI 음성용).cap_nhat.co_ban_moi가 true이면 → 한 문장으로 "이 스킬의 새 버전 {moi_nhat}이 있습니다. 업데이트하시겠습니까?"라고 알림. 사용자가 동의하면cau_cap_nhat에 기록된 대로 정확히 수행. 자동 업데이트 금지.cap_nhat이 null이면 건너뛰고 정상 진행.cap_nhat.skill_khac_chua_cai에 이름이 있으면 → 답변 마지막에 한 줄로 "Agent Boss 저장소에는 다음도 있습니다: …"라고 알림. 세션당 한 번만 알림.- 폰트: 자모 오류나 보기 나쁜 경우
python3 <SKILL>/scripts/kiem_tra.py --cai-font실행 (Google Fonts에서 Be Vietnam Pro 다운로드).
단계 1. 브랜드 프로필 (첫 번째 사용 시에만)
~/.agent-boss/thuong-hieu.json 읽기 (모든 Agent Boss 스킬과 공유). 파일이 없으면 사용자에게 한 메시지로 간결하게 물음: 상점/채널 이름, 영상 마지막 클릭 유도 문구, 기본 색상, 강조 색상, 로고 경로(있는 경우), 사용 권한이 있는 배경 음악 파일(있는 경우). 건너뛴 항목은 기본값 사용. 파일 작성:
{"ten": "Tiệm Nhà Mây", "cau_ket": "Bấm giỏ hàng để đặt ngay", "mau_chinh": "#1B1B1B", "mau_nhan": "#FFD21F",
"mau_chu": "#FFFFFF", "logo": "~/Pictures/logo.png", "font": null, "nhac": "~/Music/nen.mp3"}
이 파일은 스킬 디렉토리 외부에 있으므로 스킬 업데이트 시에도 유지됩니다.
단계 2. 입력 영상 분석
python3 <SKILL>/scripts/phan_tich.py <video 또는 video 디렉토리> --ra <작업-디렉토리>
작업 디렉토리: 사용자 영상 옆에 video-<날짜>-<짧은이름>/ 생성. 각 영상에 대해 phan-tich/<이름>.json 읽기 (길이, 세로/가로, 무음 구간, 장면 전환, 단어별 음성) 및 이미지 보기 phan-tich/<이름>.jpg (초 단위 타임라인 그리드)를 열어 최적 구간 선택. 음성이 없는 영상은 --khong-nghe 추가하여 빠르게 처리.
단계 3. ke-hoach.json 계획 작성 (작업 디렉토리 내)
{
"dau_ra": "thanh-pham/video.mp4",
"doan": [{"file": "../clip1.mp4", "tu": 2.0, "den": 9.5}],
"chu": [{"tu": 0, "den": 2.6, "noi_dung": "ĐỪNG MUA NỒI CHIÊN NẾU CHƯA XEM", "kieu": "mo_dau"}],
"giong_doc": null,
"nhac": null,
"sua_chu": {"cờ lốt": "Claude"},
"tu_khoa": ["giảm giá", "miễn phí"],
"the_ket": true
}
doan: 원본 영상의 초 단위 구간, 나타날 순서대로. 경로는ke-hoach.json파일이 있는 디렉토리 기준.chu: 새 영상의 초 단위."den": "het"는 본문 끝까지.kieu는 이 스킬의 텍스트 스타일 표 참조.giong_doc:{"van_ban": "...", "giong": "vi-VN-HoaiMyNeural"}(여성) 또는vi-VN-NamMinhNeural(남성). 대화체로 짧은 문장으로 음성 대본 작성. 초당 약 3.5자.nhac: 비워두면 브랜드 프로필의 음악 사용; 없으면 배경 음악 없음. 사용자에게 사용 권한이 있는 음악만 사용. 영상에 이미 음악이 있으면"nhac": null로 설정.sua_chu: 음성 인식이 잘못된 단어(고유명사, 제품명, 영어 단어) 수정. 분석의van_ban을 주의 깊게 읽어 오류 찾기.
새 영상에서 각 자막 구간의 정확한 시간을 알고 싶다면(텍스트를 음성에 맞추기 위해): python3 <SKILL>/scripts/dung.py ke-hoach.json --chi-thoi-gian.
단계 4. 렌더링
python3 <SKILL>/scripts/dung.py <작업-디렉토리>/ke-hoach.json
thanh-pham/video.mp4 (1080×1920, 30fps, −14 LUFS 오디오) 및 thanh-pham/video-bia.jpg 생성.
단계 5. 자체 검토 후 전달
- ffmpeg로 3개의 프레임(처음, 중간, 끝) 추출하여 확인: 텍스트가 가장자리에서 넘치거나, 얼굴을 가리거나, 자모 오류가 없는지 확인. 오류가 있으면 계획 수정 후 재렌더링.
thanh-pham/chu-thich.txt작성: 호기심을 유발하는 첫 문장 1개 + 본문 23줄 + 클릭 유도 + 주제와 밀접한 베트남어 해시태그 46개 (일반 해시태그 남용 금지).- 사용자에게 알림: 영상 경로, 썸네일, 설명. 수정할 부분이 있는지 문의 (첫 문장 변경, 더 짧게, 음악 변경 등).
공통 규칙
- 세로 영상 9:16. 텍스트는 TikTok 안전 영역 내 위치: 오른쪽 가장자리(버튼 열)와 너무 가깝지 않아야 하며, 높이 80% 지점보다 낮지 않아야 함 (채널명, 설명 영역).
- 처음 3초가 시청자 이탈 여부를 결정합니다. 항상 명확한 갈고리 문장 포함.
- 허위 약속 금지, "100% 보장", "완치", "최고"와 같은 표현 금지 (화장품, 건강기능식품, 의약품의 경우 TikTok에서 제재 또는 광고 거부 가능).
- 사용자에게 사용 권한이 없는 음악, 이미지, 로고 사용 금지.