Communitygithub.com

gvideo-agentic-workspace

Gemini의 에이전틱 모드를 사용해 비디오를 분석합니다 (AI가 전체 영상을 한 번에 보는 대신 필요한 구간만 자동으로 다시 봅니다). 로컬 비디오 파일 또는 공개 YouTube 링크를 입력으로 받습니다. 비디오/강의 요약(타임스탬프 포함), 하이라이트 편집, 화면 녹화 오류 탐지, 특정 장면 검색, 객체/행동 카운트, 또는 비디오 내용에 대한 모든 질문에 사용됩니다.

gvideo-agentic-workspace란 무엇인가요?

이 스킬은 Gemini API의 에이전틱 비디오 분석 기능을 활용하는 AI 에이전트용 도구입니다. 에이전트가 직접 비디오를 보는 대신, Python 스크립트를 통해 Gemini에게 분석을 위임하고 결과를 읽어 사용자에게 전달합니다. `tom-tat` (요약), `highlight` (하이라이트), `loi` (오류 탐지), `tim` (장면 검색), `dem` (횟수 카운트), `hoi` (질문) 등 6가지 분석 모드를 제공하며, 각 모드에 따라 필요한 옵션이 다릅니다. 로컬 파일 또는 공개 YouTube 링크를 입력받아 Google Files API로 업로드한 후 분석합니다. 사용자는 `--thu` 플래그로 미리 시뮬레이션할 수 있으며, 결과는 `outputs/` 디렉토리에 타임스탬프와 함께 저장됩니다. GitHub 등 AI 코딩 에이전트 워크스페이스에서 사용하도록 설계되었으며, 한국어를 포함한 다국어 사용자 인터페이스를 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/fx-studio/gvideo-agentic-workspace/tree/HEAD/.agents/skills/phan-tich-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

비디오 분석 (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 "..."를 다시 실행하고, 이전 보고서로 추측하거나 새 프로젝트를 만들지 마세요.

관련 스킬