media-video-analyzer

基于视频文件进行界面/行为异常的分析与复现诊断。

以视频为证据来定位界面或行为异常：先确认你确实要我做视频解析，再给出观察型的 summary，需要时才生成或扩展复现用的 scripts/dev。用在想用录像还原 bug、验证时序问题（卡顿、抖动、渲染错位）或做排查时。注意会先问你同意才装依赖，避免随意在你环境里跑 heavy 安装。

# Media Video Analyzer

## スキル読み込み時の挙動

このスキルが読み込まれたら、以下の手順を順番に実行してください。

> 重要: 依存インストールや venv 構築の前に、必ずユーザー確認を取ること。

## 利用条件

- ユーザーが動画解析を明示的に依頼した
- 動画ファイルを根拠に不具合の再現確認や切り分けを行いたい
- 時系列の現象（表示崩れ、ノイズ、停止、カクつき等）を検証したい

このスキルを使わないケース:

- 動画解析の依頼がない
- 動画が不要で、コード変更のみで完結する

## 手順

### 手順1: 依頼の成立確認

1. 依頼が「動画解析の明示依頼」か確認する
2. 解析対象ファイルパスと目的を確認する
3. 不足情報がある場合は最小限だけ確認する

### 手順2: 環境・ツール確認

まず、どちらの経路で実行するか判定する。

経路 A（workspace helper がある場合）:

1. 以下の存在を確認する
   - `scripts/dev/setup-media-analysis-env.ps1`
   - `scripts/dev/run-media-analysis.ps1`
   - `scripts/dev/analyze-video.py`
   - `scripts/dev/requirements-media-analysis-stt.txt`（セリフ抽出を行う場合）
2. `.venv-media-analysis` が利用可能か確認する
3. 環境未構築なら、必ずユーザー確認後に `np