비디오 관찰
GitHub Copilot이 검사할 수 있는 비디오 아티팩트(자막, 프레임 콘택트 시트, 프레임 인덱스, 매니페스트, 프롬프트 패킷)를 준비합니다.
이 스킬은 bradautomates/claude-video에서 영감을 받았지만, GitHub Copilot 워크플로우를 대상으로 합니다. Claude Code의 Read 병렬 처리를 가정하지 마십시오. 먼저 파일을 생성한 후, 사용자의 질문에 필요한 아티팩트만 검사하십시오.
사용 시기
- 사용자가 비디오를 시청, 검사, 요약, 비교 또는 진단하도록 요청합니다.
- 입력이
yt-dlp가 지원하는 비디오 URL 또는 로컬.mp4,.mov,.mkv,.webm파일입니다. - 작업이 말로 설명되는 내용과 화면에 표시되는 내용 모두에 의존하는 경우(예: 버그 재현, 제품 데모, 출시 비디오, 튜토리얼, 웨비나, 광고, 화면 녹화).
적합하지 않은 경우
- DRM, 페이월, 인증 또는 사이트 이용 약관을 우회하지 마십시오.
- 쿠키, 베어러 토큰, 서명된 URL 또는 개인 미디어 자격 증명을 요청하거나 저장하지 마십시오.
- 공식 API나 기존 트랜스크립트가 비디오 처리 없이 작업을 해결할 수 있다면 더 가벼운 경로를 선호하십시오.
핵심 워크플로우
- 종속성이 확실하지 않은 경우 사전 검사를 실행합니다:
python .github/skills/video-watch/scripts/preflight.pyURL 입력의 경우python .github/skills/video-watch/scripts/preflight.py --url-mode를 사용합니다. - 아티팩트를 생성합니다:
python .github/skills/video-watch/scripts/video_watch.py <url-또는-경로> --question "<답변할 내용>"다른 도구, Azure Speech, 또는 Speech Translator Desktop Plus가 이미 트랜스크립트를 생성한 경우--transcript-file <경로>를 사용합니다. 비공개 또는 인증된 미디어의 경우--detail transcript --metadata-only --transcript-file <경로>를 선호하고 쿠키, 베어러 토큰 또는 서명된 URL 자격 증명을 전달하지 마십시오. - 다음 순서로 아티팩트를 읽습니다:
manifest.json→prompt.md→transcript.md→frame-index.md→contact-sheet.jpg→ 필요한 경우에만frames/의 선택된 파일.manifest.json은 로컬 소스 바이트 또는 다운로드가 발생한 경우 다운로드된 URL 비디오 바이트에 대한 SHA-256을 기록합니다. 메타데이터 전용 URL 실행은 미디어를 가져오지 않고 해시를 null로 남깁니다. - 아티팩트에서 답변합니다. 답변이 트랜스크립트 전용, 프레임 전용 또는 희소 샘플링으로 제한되는 경우 명시합니다.
- 특정 순간의 경우
--start/--end를 사용하여 프레임 예산에 집중하도록 다시 실행합니다.
세부 모드
| 모드 | 사용 |
|---|---|
transcript | 자막 또는 사이드카 트랜스크립트만 해당. 가장 빠름. |
efficient | 빠른 분류를 위한 작은 시각적 패스. |
balanced | 대부분의 화면 녹화 및 데모를 위한 기본 콘택트 시트. |
token-burner | 사용자가 광범위한 시각적 범위를 명시적으로 필요로 할 때 더 큰 시각적 패스. |
러버 덕 체크포인트
- 이 스킬의 워크플로우를 변경하기 전에 기본 선택, 숨겨진 종속성, 안전 경계 및 Copilot 아티팩트 순서에 대한 계획을 검토합니다.
- 편집 후
SKILL.md, 스크립트 및 참조 문서가 자체 포함된 동작, 트리거 품질, 줄 수 및 실행 가능한 검증에 대해 검토합니다. - 비판자는 읽기 전용으로 취급합니다. 생산자가 변경 사항을 적용하고 검증을 다시 실행합니다.
참조
| 필요 사항 | 참조 |
|---|---|
| 상세 워크플로우 | references/workflow.md |
| 종속성 및 설정 | references/dependencies.md |
| 프레임 예산 및 콘택트 시트 | references/frame-budget.md |
| 선택적 Scout/Whisper/Azure Speech 백엔드 | references/backends.md |