비디오 분석 (Gemini agentic)
당신(에이전트)은 직접 비디오를 보지 않습니다. 비디오 보기는 scripts/phan_tich.py 스크립트를 통해 Gemini API가 수행합니다.
당신의 역할: 올바른 모드를 선택하고, 스크립트를 실행하며, 결과를 읽고 사용자에게 답변합니다.
프로젝트 관리 규칙(inputs/ · outputs/)은 워크스페이스의 AGENTS.md에 있습니다. 먼저 읽어주세요.
1단계. 입력 및 모드 확정
- 입력: YouTube 링크, 비디오 파일 경로, 또는 프로젝트 디렉토리
inputs/<프로젝트>(이미 있는 비디오에 대해 추가 질문). YouTube 링크는 공개여야 합니다 (비공개 또는 제한됨은 읽을 수 없음). 비디오에 해당 프로젝트가 있는지 확실하지 않으면--ds를 먼저 실행해 확인하세요. - 모드: 사용자가 원하는 작업에 따라 선택합니다. 각 모드의 프롬프트는
references/che-do.md에 있습니다.
| 사용자 요청 | --che-do | --hoi 필요? |
|---|---|---|
| 요약, 핵심 내용, 중요 시점 (강의, 팟캐스트, 회의) | tom-tat | 아니오 |
| 짧은 클립, 스포츠 하이라이트, 볼만한 구간 | highlight | 아니오 |
| 화면 녹화 오류, 오류 코드 찾기 | loi | 아니오 |
| "언제 …인가요?", 특정 장면이나 대사 찾기 | tim | 예 |
| "몇 번 …하나요?" | dem | 예 |
| 기타 내용 질문 | hoi | 예 |
사용자가 원하는 바가 명확하지 않으면 한 번 물어보고, 함부로 실행하지 마세요: 실행할 때마다 실제 토큰이 소모됩니다.
2단계. 시험 실행 후, 실제 실행
워크스페이스 루트 디렉토리(inputs/ 및 outputs/가 있는 곳)에서 실행합니다. 스크립트 경로는 이 스킬이 포함된 디렉토리를 기준으로 합니다. 아래는 gvideo 워크스페이스 내의 경로입니다. 스킬이 전역 설치된 경우 실제 경로로 바꿔주세요.
uv run --script .agents/skills/phan-tich-video/scripts/phan_tich.py "<링크|파일|inputs/<프로젝트>>" --che-do <모드> [--hoi "..."] --thu
uv run --script .agents/skills/phan-tich-video/scripts/phan_tich.py "<링크|파일|inputs/<프로젝트>>" --che-do <모드> [--hoi "..."]
--thu는 실제 수행할 작업(어떤 프로젝트인지, 신규/기존, 결과 저장 위치, 프롬프트)만 출력하고, API를 호출하지 않으며 디렉토리를 생성하지 않습니다. 프로젝트의 첫 번째 실제 실행 전에 먼저 실행하세요.- 스크립트가 새 프로젝트를 생성하는 경우, 사용자의 요청을
inputs/<프로젝트>/nguon.md의 "사용자가 원하는 것" 항목에 기록합니다. - 로컬 파일은 Google로 업로드됩니다 (Files API, Google이 48시간 후 자동 삭제). 비공개 비디오나 민감한 정보가 포함된 경우 실행 전 사용자에게 물어보세요.
--so-sanh는 이전(정적) 방식도 함께 실행해 토큰을 비교합니다. 토큰이 두 배로 소모되므로, 사용자가 비교를 원할 때만 사용하세요.--model의 기본값은gemini-3.7-flash입니다. 에이전틱 모드를 지원하는 모델: 3.7 Flash, 3.6 Flash, 3.5 Flash-Lite.- 키가 없다는 오류가 발생하면 사용자에게 aistudio.google.com/apikey에서 키를 받아 워크스페이스 루트에
.env파일을 만들고 한 줄GEMINI_API_KEY=<키>를 추가하도록 안내하세요..env의 내용을 읽거나 출력하지 마세요.
3단계. 결과 읽고 답변하기
스크립트가 결과 디렉토리 경로를 출력합니다: outputs/<프로젝트>/<YYYYMMDD_HHMMSS>_<모드>/
bao-cao.md: Gemini의 답변RUN.md: 비디오 정보, 모델, 토큰, AI가 다시 본 횟수so-do.json: 기계가 읽을 수 있는 수치 데이터
사용자에게 한국어로 답변합니다: bao-cao.md의 주요 내용(타임스탬프는 그대로 유지), 수치 한 줄(입력 토큰, AI가 다시 본 횟수), 디렉토리 경로를 포함합니다.
bao-cao.md에 없는 타임스탬프, 숫자 또는 세부 사항을 추가하지 마세요. 당신은 비디오를 보지 않았습니다. 사용자가 같은 비디오에 대해 추가 질문을 하면 inputs/<프로젝트>에 대해 --che-do hoi --hoi "..."를 다시 실행하고, 이전 보고서로 추측하거나 새 프로젝트를 만들지 마세요.