/reel-critic
リールは合格するまで完成しません。make.sh が <reel>/<name>.mp4 を書き出した後にこれを実行してください。
PY はスティックマンキットのPython(numpy)です:PY="$HOME/.claude/plugins/cache/claude-animation-skills/animation-skills/1.0.0/kit/.venv/bin/python"。CRITIC="<base directory of this skill>"。
1. 言葉
最終mp4を文字起こしします:bash "$CRITIC/tools/stt.sh" <reel> [video] [mon|eng](ElevenLabs Scribe via Composio、audio/stt_final.json に書き出し)。
Composio ElevenLabsのクォータが空の場合は、ElevenLabs Webアプリ(Speech to Text、Export JSON with timestamps)でmp4を文字起こしし、audio/stt_final.json として保存してください。Whisperはモンゴル語に弱いため、モンゴル語リールには使用しないでください。
2. 測定
"$PY" "$CRITIC/tools/critic.py" <reel> [video.mp4] により <reel>/critic/report.md、report.json、critic/sheets/sheet_NN.jpg が書き出されます(1秒1フレーム、1シートあたり10フレーム;シートNNのフレームiは約 NN*10 + i 秒)。終了コード0は、測定されたすべてのチェックが合格したことを意味します。しきい値は rules.json にあります。
| チェック | ルール | やり直し手順 |
|---|---|---|
| 尺 | 40~68秒 | スクリプト |
| サイズ、fps、コーデック | 1080x1920、30 fps、h264 + aac | レンダリング/マスター |
| ラウドネス、トゥルーピーク | -11.5~-8.5 LUFS、<= -1 dBTP | マスター |
| 音声開始 | 最初の単語が0.3秒以内 | 音声 |
| 音声ギャップ | 台詞間の無音が0.9秒以内 | 音声 |
| 声色バランス | 発話がポーズ(音楽+SFX)より9 dB以上大きい | ミックス |
| フックの動き | 最初の0.5秒に動きがある | カメラ |
| 映像変化の継続性 | フレームがほとんど変わらない2秒以上の伸びがない | カメラ |
| ハードカット | 最大2回(ホイップグライドはカットに含まない) | カメラ |
| 台詞とスクリプトの一致 | キャプション置換後、単語誤り率 <= 8% | 音声 |
3. 見た目
すべてのコンタクトシートを読んでください(スタック:ffmpeg -i sheet_00.jpg -i sheet_01.jpg ... -filter_complex vstack=N)。シアンのボックス:セーフゾーン(x 100~980、y 220~1500)。黄色の帯:キャプション帯(y 1250~1420)。次の場合にリールを不合格とします。
- 顔またはビートのキープロップがキャプション帯の下、またはセーフゾーンの外にある。
- 被写体がフレーム端で切れている、またはレンズに近いプロップが被写体を覆っている。
- サインボードやタイトルカードのテキストがキャプションで覆われている、またはモンゴル語リールに英語テキストが表示されている。
- その瞬間の台詞の内容を映像が示していない(各フレームのキャプション単語を確認)。
- 破損フレーム:黒、テクスチャ欠落、キャラクターが浮いている、床に沈み込んでいる。
ホイップグライドの途中のフレームはぼけていたり、空の地面が写っていたりしても問題ありません。各発見事項を時間とやり直し手順とともに
report.mdの## Pictureに記録してください。
4. 判定と修正ループ
手順2が終了コード0で、手順3に発見事項がなく、手順1の差分リストに実際に音声が間違えた単語がない(STTのスペリングミスはカウントしない)場合のみPASSとします。 FAILの場合、失敗した部分だけをやり直し、手順1~3を再度実行します。3ラウンド後に停止し、まだ失敗している内容をユーザーに表示します。
- カメラ/フレーミングが特定の時間に問題:
web/shots.jsを編集し、render.js stillsで確認後、bash "$CRITIC/tools/rerender.sh" <reel> <t1,t2,...>(その時間を含むショットのみ再レンダリング、再結合、リマスター)。多くのショットで見られるセットの変更には完全なmake.shが必要です。 - 音声ライン:そのラインを再録音(stickman3dmn:
retake.pyまたはElevenLabs Webアプリ)、単語時間を再構築、make.sh <reel> keep。 - ミックス/ラウドネス:
audio.pyを編集、AUDIO_ONLY=1 make.sh <reel> keep。 - スクリプト/尺:ユーザーに戻す。スクリプトはユーザーが承認するものです。
5. 実際の数値から学ぶ
python3 "$CRITIC/tools/stats.py" --out <reel>/critic/stats.json により、Composio経由でInstagramリールのインサイト(再生数、シェア数、保存数、平均視聴時間)とTikTok動画の統計を取得します。接続されていないプラットフォームはスキップします(composio link instagram、composio link tiktok;Instagramインサイトにはビジネスまたはクリエイターアカウントが必要)。投稿が10件以上になったら、上位3分の1と残りを比較し(視聴時間、尺、フックタイプ)、ユーザーに提案する rules.json の変更案を作成してから適用します。
6. 引き継ぎ
ユーザーに次の情報を提供します:mp4パス、尺、測定ラウドネス、判定テーブル、修正済みの画像発見事項、およびリールの言語によるTikTok、Instagram、YouTube Shorts向けキャプション(3~5個の英語ハッシュタグ付き。Herveeチャンネルでは常に #whatif、トピックタグ例 #mongolia #ulaanbaatar、TikTokでは #fyp、YouTubeでは #shorts)。ユーザーは手動で投稿します。
ルールの由来
README.md を参照:保持率とフックの研究、セーフゾーン測定、調査された自動化ツールについて説明しています。