papercut-qa

Papercut QA

Style DNA とストーリーボードに照らして、内容ではなくスタイルを比較します。制作中はシーンごとに実行し、最終レンダリングの前にリール全体でも一度実行してください。

事前確認

• インストール：Standard または Full をインストールします。静止画には Remotion で構成されたプロジェクトが必要です。コンタクトシートには numpy と Pillow を含む Python が必要です（$PAPERCUT_PY）。不足しているものは ./install.sh --doctor で確認し、その後 papercut-setup を実行します。
• ライブラリ：$PAPERCUT_LIB、なければ ~/.config/papercut-explainer/config.env の PAPERCUT_LIB= 行、それもなければ一度だけ尋ねます。
• 最初に読むもの：../papercut-explainer/references/style-guide.md のセクション 2 にある Style DNA と、背景シート library/papercut/public/bg/backdrops/_sheet.jpg。各画像は約 0.7～1.5k トークンを消費するため、手順で必要なものだけを開いてください。
• 密度については、../papercut-explainer/references/frame-breakdown.md の末尾にある「Pacing stats」を参照します。シーンの平均は 2.8 秒、シーンごとに個別の視覚イベントが 2～4 個、強調語に合わせて 0.4～0.8 秒ごとに 1 個、新しいキャプションページは約 0.6 秒ごとです。内容ではなく、密度を参考にしてください。

1. 静止画をレンダリングする

プロジェクトの papercut/ フォルダーから実行します。

$PAPERCUT_LIB/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]

• チェックごとに 4～6 個のタイムスタンプを使います。シーンの場合、NTH は長さ（フレーム数）の約 4 分の 1 にします。リール全体の場合は FROM-TO を省略し、NTH を大きくします。
• 出力は out/qa/NAME_0.jpg（範囲が長い場合は _1、_2 も）で、シートあたり最大 45 フレームです。シートを確認し、小さく保ってください。
• シーンごとに QA コマンドを 1 つ実行し、レンダリングを同時に 2 つ実行しないでください。シーンごとの修正は 2 回までにしてください。
• ストーリーボードと照合します。シーンのフレーム 0、セリフ中のキーワードに合わせた重要イベントを確認し、何も切れておらず、バナーやキャプション帯を何も覆っていないことを確認してください。

2. チェックリスト

• すべてのオブジェクトが紙に見えること：紙目、粗い縁、ドロップシャドウ、重なった紙片の陰影があり、輪郭線やグラデーションがないこと。
• ワールドカメラが滑らかに動くこと。細かく控えめに動かすのは、バナーとラベルだけです。
• バナーは位置が固定され、テープで留められていること。3～7 語で、各バナーは 1 つの事実だけを伝え、ナレーションを繰り返さないこと。バナーだけを読んでもファクトシートになること。
• すべてのセットがナレーションの具体的な語句を表現していること。数字は物理的な小道具で表し、CTA の前にコールバックとなるセットが 1 つあること。
• すべての数字と UI ラベルが事実リストに基づいていること。台本に誠実な制約事項が少なくとも 1 つあり、機能の積み重ねがちょうど 3 つであること。
• キャプション：1 語につきタグ 1 つ、傾けて表示し、出現時にポップすること。1～3 ページで、画面の 68～80％ の高さの帯に置き、顔には重ねないこと。
• 彩度を上げるのはキャラクター、キャプション、シグナルだけであること。
• 強調語ごとに視覚イベントがあり、環境の動きが常に続いていること。
• バナーが変わるタイミングでカットすること（ツアーとニュースではセットを 1.5～3 秒、メタファーのビートでは最大 5 秒）。画面下部 20％ には何も置かないこと。
• HOOK ブロック（SAY / WRITE / SHOW / ALIGN）が、書かれたとおり正確に画面に表示されていること： フレーム 0 では、WRITE のタイトルを載せた状態で SHOW の瞬間を動作の途中として見せ、最初のナレーション行は SAY であること。
• すべてのシーンにカメラ移動があり、ページめくりまたは破りは最大 1 回、CTA への移行にはテープを引く動きかムチのような動きがあり、すべてのトランジションに SFX があること。
• ユーモアのチェックが画面上で確認できること：全編を通して形式が統一されていること、アイデアごとに衣装の小道具があること、苦戦するビートが 1 つあること、フレーム 0 の小道具が CTA のセットで変化して再登場すること、すべてのギャグが 1 秒以内に伝わり、バナー、キャプション、重要な数字を覆わないこと。
• ナレーションとバナーの語彙が SERIES.md の視聴者レベルに合っていること。
• ナレーション、キャプション、イベントが同期していること（すべてのカットで Studio をスクラブしてください）。

項目に不合格がある場合は、シーンファイル（またはライブラリ内のキット。プロジェクトの src/lib/ は変更しないでください）を修正し、そのシーンだけを再実行します。papercut-build でシーンを再ビルドします。

3. 納品

Studio プレビューを開き、タイミングとともにシーンの一覧を示し、何がプレースホルダーか（音声、音楽、SFX、アセット）を伝えます。音声がプレースホルダーの場合は、再録音の方法（papercut-voice）も伝えてください。投稿後、分析用に数値を papercut-strategy に渡します。

原則の確認

5 fps でシーンをスクラブし、../papercut-explainer/references/motion-principles.md と照らし合わせます。大きな動きの前に予備動作があること（2）、すべての動きにイージングがかかっていること（6）、衝撃の後に何かが遅れて動くこと（5）、焦点となる小道具が1つあること（3）、誇張した動きが1つあること（10）、陰影が重ねられ、影に一貫性があること（11）を確認します。

引き継ぎ

修正内容は、papercut-build（シーンまたはサウンド）か papercut-voice（同期）に戻します。確認が完了したらリールの作業は終了です。ユーザーから依頼があった場合は、$PAPERCUT_LIB/tools/render.sh でレンダリングします。