品質管理（Control de calidad）
人が見るべきは作品であって、技術的なミスではない。測定できるものはすべて、人に見せる前に測定する。測定できないものは、新鮮な目を持つスーパーバイザーが拒否権をもって確認する。そして、人が指摘した修正はすべて記録し、次回は自動で検出できるようにする。
- 自動品質管理ツールは準備中のモジュールです。当面は各測定値を
ffmpegとffprobeから取得します。コマンドは referencias/mediciones.md にあります。 - 過去に発生したエラーのリスト（しきい値と確認方法を含む）は referencias/lista-de-errores.md にあります。
- パッケージ内のエージェント
supervisorはこのスキルに従います。
1 · フロー
- レンダリング前に、作品のカード（
pieza.md）を読む：承認済みで変更不可の部分と、未解決のメモ。 - レンダリングを測定する（§2）。✘ は次に進む前に修正する。⚠ はフレームを見て判断する。
- リズムを測定する（
referencia.py、§3）。 - **コントロールシートを作成する：**作品全体から6～24フレームを抽出し、セーフゾーンを描画する。それぞれを確認する。
- 修正版の場合、前バージョンと比較する（§4）。
- スーパーバイザーが署名する「承認」または「変更」（§5）。
- 人に同じレンダリングとスーパーバイザーの意見を見せる。再作業の前に。
- レポートと共に納品する（§9）。
2 · 測定項目
| 測定項目 | しきい値 | 違反時 |
|---|---|---|
| フォーマット | 発注通り：1080×1920 縦型、1920×1080 横型、1080×1350 フィード。4Kは明示的に要求された場合のみ | ✘ |
| フレームレート | シーケンスのfps（±0.02）かつ一定 | ✘ · 可変の場合は ⚠ |
| 尺 | リール：最大40秒。書き出し：マーク間の区間 ±1フレーム | ⚠ · キャンペーンリールの場合はブロッキング |
| スケール | 0.5秒以上の黒帯がないこと | ✘ |
| セーフゾーン（1080×1920） | 左右54px、読み物はy224以上y1495以下、ボタン列（x897、y1228から）は自由領域。横型：全周96px | ✘（0.35秒以上続く場合）· ⚠（一瞬の場合） |
| オブジェクトの完全表示 | アルファで、0.35秒以上フレームの端に触れるものがないこと | ✘ |
| 黒（ブラック） | 最初のフレームに画像があること。意図的なフェードインを除き、黒単独フレームがないこと（1フレームも不可） | ✘（先頭）· ⚠（途中） |
| フリーズ | 動くべき場所で0.5秒以上静止しているものがないこと | ⚠ · ブロールやアニメーションで1秒以上、または最後の1秒にある場合は ✘ |
| 何かが起こっている | カットも動きもない4秒間のウィンドウがないこと | ⚠ |
| 最終フレーム | 存在し、黒でなく、すべてがマージン内。カウントフレーム数＝期待値。音声が動画より長くないこと | ✘ |
| 音量 | リール全体で約−15 LUFS インテグレーテッド（−17〜−13の範囲） | ✘ |
| ピーク | 実ピーク ≤ −1 dBTP。−0.1 dBFS以上のサンプルなし（クリッピング） | ✘ |
| 無音 | 0.3秒以上の無音で始まらない。音声のある箇所で−50 dB以下の0.5秒以上のギャップがないこと | ⚠ |
| 効果音 | 単独：ピーク ≈ −5.5 dB（上限−5）。音声下：ピーク ≤ −9 dB、RMS ≤ −27 dB | ✘ |
| ヒス（「シュー」） | 持続する広帯域ノイズなし：効果音内で150ms、ミックス内で300ms。効果音では4kHz以上のエネルギーが20%以下 | ✘（効果音内）· ⚠（ミックス内） |
| リアルアルファ | ピクセルフォーマットにアルファあり（yuva…、rgba…）かつ可視 | ✘ |
| カラー | bt709 かつ TVレンジとマークされている。HLGまたはbt2020は納品時に指定 | ✘ |
| エクスポート設定 | H.264、AAC 48kHz ステレオ、ビットレート30Mbps以上（52Mbps設定で平均38～43） | ⚠ |
3 · リズム（referencia.py）
リファレンスを分解するツールは、あなた自身のレンダリングも測定します。パッケージルート（このスキルの2階層上）の herramientas/referencia.py にあります：
python3 herramientas/referencia.py <render> --idioma es --salida control/<pieza>-vN-ritmo
analisis.md を読み、hoja.jpg と gancho.jpg を確認します：
| レポート内の項目 | 期待値 |
|---|---|
| 「何かが起こる間隔」 | 4秒以下 |
| 「最も静かな区間の長さ」 | 4秒未満。超える場合は、どの区間か、何を入れるかを記載する |
| 「最長のショットの長さ」 | 3～4秒。それ以上は、他に伝え方がない場合のみ許容され、理由を説明できること |
| 尺（「カード」内） | リールでは最大40秒 |
gancho.jpg（0.1～3秒） | 指を止められるか？0.5秒以内に予想外のことが起こり、3秒でストーリーがわかる |
| 「インテグレーテッド音量」 | §2の測定値と同じ |
- ショット内のメッセージの変化やカメラのゆっくりした動きは、新しいショットとはみなさない。別のスケール、別のアングル、別のアイデアへのカットは新しいショットとする。
- カットのないアニメーションでは、「1ショット」はエラーではない。リズムは「視覚的な変化」にある。
- 作品がリファレンスから派生した場合、承認されたコンセプトの数値と比較する。
4 · 前バージョンとの比較
修正によって、すでに好まれているバージョンを悪化させてはならない。
- 修正前に、
pieza.mdの「承認済みで変更不可」の部分を読む。 - 修正後、新しいバージョンと前のバージョンを画像と音声で比較する（コマンドは mediciones.md に記載）：
- 要求された区間外（0.25秒のマージンあり）では同一でなければならない；
- 要求された区間内では変更がなければならない。変更がない場合、メモは未解決である；
- 尺が変わった場合、後続のすべてがずれる可能性がある。
- 要求された箇所以外で変更された部分は、意図的で納品時に説明されるか、リグレッションであり、見せる前に修正される。
- 各メモは新しいバージョンの該当フレームで確認され、依頼されたまま解釈せずに修正されていること。
フレーム全体の比較では小さな変更（フレームの5%を占める看板、110pxのキャプション、修正された字幕など）を見逃す可能性がある。そのような箇所は、両方のバージョンの実際のサイズの切り抜きで確認する。修正でよく壊れるものは、エラーリストの「リグレッション」セクションに記載されている。
5 · スーパーバイザー
スーパーバイザーは作品を作った人と同じ知識を持つが、新鮮な目で見る。制作担当者は自分のミスを見つけられない。スーパーバイザーは何も修正しない。確認し、測定し、署名する。
受け取るもの： レンダリング、その種類（リール、ブロール、アルファ、エフェクト、カバーなど）、シーケンスのfps、pieza.md。修正版の場合は、さらに前バージョン、要求された区間、正確な秒数付きのメモ。不足があれば、署名前に探す。
レビュー方法：
- 作品をファイル名ではなく、内容、表示内容、尺で識別する。
pieza.md、修正ファイル（§6）、エラーリストを読む。- 測定する（§2）。✘ があれば、即座に「変更」の評決。議論の余地はない。
- 最初の質問は、作品が惹きつけるかどうか（基準を満たすかどうかの前に）（§3）。
- シートを見て、疑わしい秒、すべてのカット、解決されたメモの秒をフルサイズで確認する。
- 修正版の場合、比較する（§4）。
- データとテキストを確認：数字、名前、架空のケースがないこと。
重大度：
- ブロッキング： ✘；通常速度で読める個人データ；人が以前に修正したエラー；40秒を超えるリール；指を止められないフック；理由なく3〜4秒を超えるショット。
- 警告： その他すべて。基準に関する問題（ポーズ時のみ読める1フレームのフラッシュ、過剰なキャプションなど）。これらは人が判断する。
ラウンド：
- 初回レビュー： 見つけたすべてを一度に言う。重大度付き。
- 2回目： ブロッキングのみと前バージョンとの比較に注目する。前バージョンにすでにあった新しい問題は、初回のミスとして警告として報告する。
- 3回目： ブロッキングが残っていなければ、「警告付き承認」で署名する。
- バージョン間で基準を引き上げてはならない。再レビューは5分未満。
署名： 現在のリストに対して行う。作品がルールよりも古い場合でも、同じようにカウントされ、「レンダリング後」とマークされる。黒やフリーズをエラーと呼ぶ前に、意図的なフェードインからの開始かどうかを確認する。
VEREDICT: 承認 | 変更
変更点: 1) 0:04.2 · 何が悪いか · ルール（ID） · ブロッキング | 警告; 2) …
確認事項: 測定、リズム、シート（nフレーム）、フルサイズフレーム …, vNとの比較、解決済みメモ …
署名はそのレンダリングに対して有効。ファイルが変更された場合は、再測定して再署名する。
6 · 修正ファイル
correcciones.md、作業フォルダ内。スーパーバイザーは各レビューの前にこれを読む。これにより、基準は人のものになる。
- 人がレビューしている間、 各修正をその場で記録する：
時刻 · 何を変更 · なぜ · 何が残っているか。まず残っているものを読む。 - 同日中に、 繰り返し発生する可能性のあるエラーは、番号と検証方法とともにルールに変換する：
COR-12 · YYYY-MM-DD · ショットは最大4秒。確認方法：「最長ショット」をreferencia.pyで。発端：「クリップが8秒は長すぎる」、リールX v3 - 以前のルールと矛盾する場合は、新しいルールを優先する。古いルールを修正し、両方を残さない。
- 初回で承認したものや、見てもよい、残してもよいと言ったものも記録する。これらも禁止しない。
- 人がスーパーバイザーが見逃したものを発見した場合、スーパーバイザーはそれを追加することを提案する。
- スーパーバイザーは好みを勝手に作らない。何かが明らかに間違っていてリストにない場合、変更を要求し、理由を述べる。これによりリストは成長する。
7 · 破ってはいけないこと
- ✘ は修正され、議論されない。 測定されたミスが人に届くと、その人のレビューは技術的エラーに費やされる。
- 正しく測定することは承認することではない。 警告のみで承認されたバージョンが、「長すぎる」（52秒）および「退屈」（同じスマートフォンが31秒続く）で戻ってきたことがある。
- 修正は要求された箇所のみに触れる。 ついでに作り直すと、手作業の成果が失われ、好まれていたものが悪化した。
- プロパティの変更を求められたら、そのプロパティのみを変更する。「黒の不透明度を下げる」が「列を削除」と解釈されたことがあり、そうではなかった。
- 人が承認または選択したものは、スーパーバイザーの細かい指摘で作り直さない。 1行で質問する。すでに納得しているものに対する3回の拒否権は、コストと時間を浪費した。
- 人がコンピュータの前にいる場合、その人が監督する。 エージェントは人がいないときに入る。
- 人はスーパーバイザーと同じものと、その意見を、再作業の前に見る： 何を拒否するか、何秒目か、何を提案するか。拒否が重要でない場合もあり、各ラウンドはレンダリング1回分のコストがかかる。人がすでに依頼したことは、質問せずに行う。
- 作品ごとに最大2〜3バージョン。 同じ種類の拒否が2回目、または基準の問題が発生した場合、停止して選択肢とともに人に質問する。かつて基準を引き上げるスーパーバイザーにより、一晩で8バージョンになったことがある。
- 各バージョンは変更部分のみを再レンダリングする。 かつてローカルな変更のために45分の動画全体がレンダリングされたことがある。
- 再レビューは拒否された箇所のみを見る。 フルラウンドは12〜17分かかり、30万〜40万トークンを消費していた。
- 「この最後の変更をして終わり」 = それを修正し、測定し、見せて、完了。別の拒否ラウンドはなし。
- 通りすがりのコメントは命令ではない。 「あまり好きじゃない」という理由で承認済みの人物が変更され、レンダリングが却下された。依頼された箇所のみを修正し、残りはそのままにする。多くても一度だけ提案する。人が話題を閉じたら、再開しない。
- 生成物は承認済みのものから作り直す。 好まれた画像から始め、依頼された箇所のみを変更する。方向性のない拒否が2回続いた後は、盲目的に3回目を費やさない。何を理解したかを伝え、画像やフレーズを求める。人が意見を変えた場合、最後に言ったことを採用する。
- 何かが開いている、または表示されていると言うなら、確認する。 開いていると言われた4つのスケッチが実際には開いていなかったことがある。
8 · 技術的な落とし穴
nb_framesはProResで誤った値を報告する（パケットをカウントする-count_packets）。-shortestで音声を結合すると1〜4フレーム失われる。正確な尺（-t）を使用すること。- 「4444」ラベルはアルファを保証しない。ピクセルフォーマットが
yuvaで始まる必要がある。 ffmpeg -ss tは tで始まる 最初のフレームを返す。フレーム f を得るには、t = (f − 0.25) / fps を使用する。- QuickTimeとクイックルックは色を変更する。編集者のフレームと比較し、目視で判断しない。
- セーフゾーンはテキストのバンドで測定する。明るい映像はフレーム全体の測定を誤らせる。
- 文字起こしは最初の単語を0.0に配置し、次の単語内に長いポーズを挿入する。ポーズの直後はエネルギーで測定する。
- エディタは上書きされたファイルの尺と音声をキャッシュする。各バージョンには新しい名前を付けること。
- 4fpsでのテキスト読み取りはフラッシュを見逃す。プライバシーのためには10fps。
9 · 納品物と確認項目
- 納品レポート： パス、尺、区間、実平均ビットレート、測定内容（数値付き）、リズム、スーパーバイザーの評決、前バージョンとの比較、未解決事項。
pieza.mdの「管理」セクション：vN · 測定値（エラーと警告） · スーパーバイザー（評決と理由）。- 各バージョンは新しい名前で（
v2、v3…）。前のバージョンは比較のためにそのまま残す。 - 人が要求するまで、何も公開したり、誰かに送ったりしてはならない。