media-video-analyzer

基于视频文件对界面/行为问题做观测、重现确认与问题切分。

拿视频文件为证来观察、复现并切分界面或行为类问题：先确认用户明确要求视频解析，再给出一个观测型 summary，需要时才生成或扩展 scripts/dev。使用前会先征求是否允许安装依赖，重点是基于时序画面做问题判断而不是盲改代码。适合显示崩溃、卡顿、噪声等需要回放验证的故障。

# 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