papercut-script

Papercut スクリプト

リサーチ、スクリプト、バナートラック、ステージング、ギャグは、それぞれがほかを補い合うため、まとめて作成します。フレーズバンクとステージング例2つを含むシステム全体は、references/storytelling.md にあります。ギャグとフォーマットのバンクは、references/comedy.md にあります。

各ビートでは、異なる役割を担う3つのトラックを進行させます。

• ボイスオーバー（キャプションタグとして表示）：ストーリーを語ります。カジュアルな二人称で、文ごとに切り替えます。
• バナー：ボイスオーバーが省略する確かな事実、数値、または正直な注意点を補足し、1.8～3秒ごとに切り替えます。
• セット：ボイスオーバーに出てくる具体的な名詞を文字どおりに表現し、製品UIでデモを行います。バナーに合わせて切り替えます。

事前準備

• インストール：最小構成で十分です。セットを選ぶ際に背景シート（library/papercut/public/bg/backdrops/_sheet.jpg）を使いたい場合のみ、$PAPERCUT_LIB を解決してください。画像1枚につき約0.7～1.5kトークンを消費するため、そのステップに必要なものだけを開いてください。
• episodes/NN-slug/research/facts.md の先頭に BRIEF が、episodes/NN-slug/papercut/STORYBOARD.md の先頭に HOOK ブロックが必要です。どちらかがない場合は、先に papercut-strategy または papercut-hook を実行してください。
• リサーチにはウェブ取得または検索と、スクリーンショット用のブラウザツールが必要です。利用できない場合は、ユーザーにスクリーンショットと事実情報を求めてください。

1. リサーチとUIのラフ作成

• 情報源を明記して情報を集めます。製品名、開発元、数値、価格、要件、制限、競合製品の数値を含めます。不確かな情報には印を付けてください。
• 重要な画面（2～4個）、実際のラベルとボタンのテキスト、アクセントカラー、ヒーロー画像を取得します。動画では、画面録画ではなく、UIのラフなバージョンをPapercutの小道具として作り直します（references/storytelling.md のセクション5）。
• BRIEF で指定された役割のフレーミングを確認してください。製品の挙動を決して作り上げないでください。../papercut-explainer/references/frame-breakdown.md の役割フレーミングに関する注記を参照してください。
• リストを BRIEF の下にある research/facts.md に記載します。スクリプト、バナー、UIで使うすべての数値は、ここに記載された情報を出典とする必要があります。

2. モードを選ぶ

モード	使用する場合
オープンソースの紹介	有料製品の無料またはローカルの代替手段を紹介する場合
ニュース発表／価値の検証	大手企業が新しい有料プラン、モデル、機能を発表した場合
機能の解放／使い方	ツールの動作を変える隠れた設定やコマンドを紹介する場合

各モードのフックの定型と中盤部分は、references/storytelling.md のセクション6にあります。フックの更新を適用し、ニュースではなく、隔たりと賭けられているものを提示してください。

3. 骨格に沿ってスクリプトを書く

選んだフォーマットに沿って、22～30秒で75～95語、1秒あたり約3.5～4語を目安に書き、1.5～3秒ごとに新しいセットを用意します。10個のビートは次のとおりです。

1. フック（0～3秒）。papercut-hook で確定済み
2. 裏付け、または緊張感
3. 再構成（「So instead of..., you can...」）
4. 名前の公開（「It's called...」。フックより前には出さない）
5. 仕組みを、具体的なデモ1つで示す
6. エスカレーション（「And X is just the start, because...」に続けて、ちょうど3項目を重ねる）
7. クライマックス（「And get this:」に続けて、最も大きな数値を示す）
8. 注意点（正直な対立要素）
9. 見返り（「which means...」）
10. CTA（「Good thing I made [freebie]. For the link, comment KEYWORD.」）

ボイスの速度を上げるのではなく、ビートを短くしてください。ルール：

• 二人称、短縮形、「and」「because」「which means」でつなぐ短い節を使います。語彙のレベルは SERIES.md に示された視聴者に合わせます。
• 題材が別のものであっても、最初の文で大手ブランドの名前を出します。
• 数値はすべて具体的で、出典があるものにします。機能の列挙は必ず3項目です。
• ボイスオーバーまたはバナーに、実際の制限を少なくとも1つ含めます。CTAのキーワードは、題材に関連する短い単語を1つにします。
• 最後の行では、フックの重要な単語または数値を繰り返してから、キーワードを提示します。

narration/script.json に [{"id": "l1_hook", "text": "..."}, ...] の形式で記述し、文または節のまとまりごとに1行にします。l1_hook の行は HOOK ブロックの SAY です。各行で強調する1つか2つの単語（数値、意外性を表す言葉、結論）をステージング表に記し、papercut-voice がそれらを使用します。

4. バナートラック

10～18個のバナーを用意します。各バナーは3～7語のすべて大文字表記で、1つの事実を伝え、約2～3秒ごとに1つ表示します。ナレーションの内容を繰り返してはいけません。単独で読んでも事実一覧として成立するようにします。見出しとなる統計情報、価格の換算、信頼性を裏付ける事実、提供状況、少なくとも1つの正直な注意点、少なくとも1つの信頼または安全性に関する事実、機能の主張、少なくとも1つの競合との比較、CTA 前の選択肢や判断材料を示すバナーを含めます。種類と例は references/storytelling.md のセクション3を参照してください。

5. ステージング表

バナーごとに1行を用意し、HOOK ブロックの下にある STORYBOARD.md に記入します。

t (s) | その下で流れるナレーションの語句 | BANNER | SET（部屋＋背景色） | 主役の小道具（ナレーションの具体的な名詞を使った視覚的な言葉遊び） | 製品 UI の場面 | マスコットの動作と衣装の小道具 | ギャグ

• バナーごとに新しいセットを使い、背景色を順番に変えます。セットで表現するのはバナーではなく、ナレーションの一節に含まれる語句です。
• 数字は物理的な小道具で表現します。価格表示、はかり、倍率の壁、ゲージ、メーター、レースなどです。競合はピン留めされたカードとして登場させ、主役にはしません。
• マスコットは視聴者の分身として反応します。製品 UI は、紙製のモニターまたはノートパソコン上に、偽のインタラクションを使って大まかに再現します。
• CTA の前に、以前のセットへのコールバックを1回入れます。CTA のセットでは、コメント欄にキーワードが入力されていく様子を見せます。
• papercut-storyboard では、カメラとトランジションの列が追加されます。

6. ユーモアの調整（台本の作成後、ステージングの確定前）

GAG 列を追加します。ナレーションは真面目なままにし、映像だけをふざけたものにします。

1. リール全体でフォーマットを1つに統一します。
2. 各バナーに、要点を演じて見せるギャグを1つ入れます。references/comedy.md を参照してください。
3. アイデアごとに衣装の小道具を1つ用意します。マスコットの持ち物は着けたままにし、その上から小道具を1つ加えます。
4. キャッチとなるセリフに合わせて、マスコットが苦戦する場面を1つ入れます。
5. 0フレーム目に登場する小道具をCTAのセットで変化させて再登場させます（I'M OUT が FREE になるなど）。
6. 背景に、説明のつかない不条理な場面を1つ入れます。
7. ミームは最大1つまでとし、シリーズ独自のスタイルで作り直します。実際の動画クリップ、静止画、音声は使いません。

ギャグでバナー、字幕、重要な数字を隠してはいけません。また、それぞれ1秒未満で理解できる必要があります。

チェック項目

• 75～95語、22～30秒、正直な制限事項を1つ、ちょうど3つの項目からなるスタック。
• すべての数字とバナーは facts.md に基づいている。バナーだけを読んでも事実一覧として成立する。
• 最後の行で、フックの重要な語句または数字を繰り返している。
• ユーモアの調整が完了している：アイデアごとの衣装、苦戦する場面、再登場する小道具、不条理な場面を1つずつ、ミームは最大1つ。

引き継ぎ

次は papercut-storyboard です。narration/script.json と、episodes/NN-slug/papercut/STORYBOARD.md の HOOK ブロックおよびステージング表を読み込みます。台本のみを作成する場合は、ここで止めてユーザーにそれらのファイルを渡します。別のツールで使う、コピー＆ペースト用のストーリーテリングプロンプトは references/storytelling.md のセクション7にあります。