clapper

Clapper：概要 → 映像＋音声 → レビュー済み MP4

次に役立つ成果物を自分で作成します。シーンプラン、プルーフフレーム数枚、再生可能なドラフト、検証済みの最終版などです。進捗報告は短く、番号を付けてください。映画の内容を大きく左右する判断だけを質問し、通常の制作上の選択は依頼内容と既存プロジェクトから判断してください。

1. ブートストラップしてから、最短の方法を選ぶ

評価作成者の依頼に、準備済みのランタイムとワークスペースが指定されている場合は、まず 作成者向け引き継ぎ契約 を読み、その方法を使用してください。 それ以外の場合は、まず bootstrap.md を読んでください。 このスキルのインストールがユーザー側で必要な唯一の準備作業です。残りのセットアップは自分で行ってください。プロジェクト、OS／アーキテクチャ、インストール済みツールを検出します。Node/npm が利用可能な場合は、インストール済みスキルの絶対パスを使って、同梱の scripts/bootstrap.mjs を実行します。npm のキャッシュを使ってバージョンを固定した CLI をインストールし、管理対象のランタイムを準備して、プロジェクトを作成または復元し、doctor を実行してプルーフフレームを取得します。Node/npm が利用できない場合は、そのリファレンスに記載された検証済みのネイティブランチャーの方法に従ってください。動作するインストール環境は再利用し、バージョン固定されたプロジェクトを黙ってアップグレードしないでください。ソースからの方法を使うのは、既存のフレームワークワークスペースまたはフレームワーク開発の場合に限ります。

このスキルの残りの部分では、clapper はブートストラップ中に解決された正確なコマンドプレフィックスを指します（npm exec --yes --package=@archastro/clapper@<resolved-version> -- clapper またはネイティブランチャーの絶対パスなど）。グローバル実行ファイルがあることを前提としません。コマンドはプロジェクトディレクトリを workdir に指定して実行してください。スタンドアロンの方法では、pnpm、ソースのチェックアウト、システムの FFmpeg、ブラウザーのインストール、別個のサンプラーは必要ありません。

1. プロジェクトの指示、clapper.json、package スクリプト、Git のステータスを確認し、既存の編集内容を保持してください。前回のセッションの API を前提とせず、インストール済みランタイムまたは既存のソースチェックアウトから API エクスポートを確認してください。ブートストラップで最初のフレームはすでに検証済みです。そのプルーフを確認して続行し、セットアップを繰り返さないでください。
2. モードを選択します。
   • ベンチマーク／スキルまたはランタイムの比較： technical-evals.md を読んでください。分離された評価環境と独立したエビデンスを使用し、回帰テストや自己レビューを品質の主張にすり替えないでください。
   • 技術／科学解説： explainers.md を読んでください。意図された主要な情報源を検証し、直感的に理解できるようにしたうえで、各抽象化レベルにおける全体の流れを説明してから、詳細を掘り下げてください。
   • 新作映画： ブートストラップ済みのベーシック／コミックプロジェクトを使用し、概要と利用可能な関連サンプルからビジュアルの方向性を選んでください。
   • 再編集： 以前のコンポジション ID を保持し、エクスポート済みのシーンコンポーネントを再利用して、新しいシーンプランを明示してください。変更したシーンと両方のつなぎ目、およびフルエクスポートでのリグレッションを確認してください。
   • ナレーション／会話： narration.md を読み、続けて audio.md を読んでください。オプションのローカルエンジンをインストールし、声を試聴して、中心となるキャストを決め、シーンの準備前に明示的に確定してください。
   • 音声の調整： 許可なく映像のタイミングを変更しないでください。audio.md を読んでください。
   • オリジナル音楽／バンド／振り付け： music.md を読み、ミックスのレビューには audio.md を読んでください。音楽のみの依頼では、動画を作成する必要はありません。
   • プレビュー／レンダーのみ： 既存のエントリーとコンポジションを使用し、デザインの変更や全面的なクリエイティブレビューを押し付けないでください。
   • 仕上げ／最終制作： visuals.md、audio.md、review.md を使用してください。
3. clapper compositions でエントリーとコンポジションを解決してください。CLI の最初のコンポジションを黙ってレンダリングしないでください。ルートの pnpm preview／pnpm render は intern-promo を対象とし、ユーザーが言及した映画を対象とするとは限りません。 | 目的 | もっとも近い具体例を確認 | | --- | --- | | 基本的なシーン、データ、スコア、ポートレート版 | videos/_template/src/index.tsx、data.ts、theme.css | | エディトリアルな文字組みとカウンター | videos/showcase/src/ledger/ | | 遊び心のあるスプリングと空間的な動き | videos/showcase/src/orbit/ | | ターミナル、グラフ、カメラ、グレイン | videos/showcase/src/nimbus/ | | ボイリングインク調のコミックと再利用可能なリグ | @archastro/clapper-core/rigs | | サンプリングしたオリジナルスコア、ビートに合わせた振り付け、Music インスペクター | videos/cat-ballet/src/score.ts、src/index.tsx、clapper.json |

この表はリポジトリ内の例を示すもので、インストールしたスキルの隣に必ず存在するファイルを示すものではありません。インストール済みランタイムのテンプレートと core/music のエクスポートを優先し、必要な場合に限り、該当する公式リリースタグから関連する例を取得してください。チェックアウトに例がなくても、新しい映像の制作を妨げるものではありません。置き換えを考案する前に、既存のプリミティブを使用してください。後から追加されたローカル限定の例に、新しい便利なインストゥルメントが含まれている場合があります。利用する前に、エクスポートとテストを確認してください。ソースが存在するだけで、自動的にレビュー済みになったり、リリースに含まれたりするわけではありません。

2. 動作するフレームまで進める

以下のコマンドでは、解決済みの clapper プレフィックスと、プロジェクトのルートを workdir として使用します。ブートストラップまたは compositions から実際のコンポジション ID を設定し、永続する cd の状態には依存しないでください。これらは本番環境の確認であり、2回目のインストール手順ではありません。

set -l clapper_id spot # replace with the requested/configured ID
clapper --help
clapper compositions --json
clapper still -c "$clapper_id" --frame 0,30 --out out/stills/first-look
clapper preview --port 4321

プレビューは長時間実行されるサーバーです。表示された URL を使用してください（ポートは変わる場合があります）。ユーザーへの引き渡し時には、ユーザーのメインの Google Chrome プロファイルで開いてください。自動ブラウザー確認には分離されたプロファイルが使用されます。Space キーで再生、矢印キーでコマ送り、[ / ] でカット間を移動、s でセーフエリアを表示、c でコピー用ボックスを表示、i / o でループ範囲を設定します。ScoreAudio は準備済みの実際の WAV を再生します。シンセサイズされたキューのプレビューは近似音です。書き出した統合ミックスを聴いて判断してください。

依存関係またはランタイムの確認に失敗した場合は、bootstrap.md の該当手順に戻ってください。別のインストール方法を独自に考案しないでください。レガシーなワークスペースプロジェクトでは、明示的なエントリを指定し、チェックアウト内の CLI を使用してください。既存のワークフローを黙って変換せず、そのまま維持してください。

3. 映像と音声を一緒に制作する

フルスコアを制作する場合は、music.md に従ってください。@archastro/clapper-music で作曲し、実際の SFZ プリセットを選び、clapper.json を通じて準備し、映像内に ScoreAudio を配置します。スタジオの Music タブでは、クリック可能なピアノロールと正確なソースコードを確認できます。フォーリーや意図した音色にはシンセサイズされたキューを使用し、サンプリングされたスコアが求められている場合はサンプリング音源を使用してください。

1. 簡潔なビートプランを作成します。対象視聴者、約束する価値、尺、フォーマット、スタイルの参考例、各シーンのアクション、画面上のコピー、意図するサウンド／静寂のビートを記載します。仕様が求められている場合は、HTML のタスク UI を使用してください。それ以外の場合は、短いシーン表で十分です。簡単な編集を仕様作成のために遅らせないでください。
2. defineScenes で尺とオーバーラップを管理します。プランを <Composition scenes={SCENES}> と <Scenes plan={SCENES}> の両方に渡してください。グローバルなサウンドキューには SCENES.start(name) を使用します。シーン内の useFrame() はローカルなフレームを返します。数値の時刻はフレームで、"0.4s" は秒です。尺を変更したら、フレーム参照を再計算してください。
3. 事実に基づくコピーや数値は1つの data.ts にまとめ、ブランド固有のトークンは theme.css に置き、長い音楽ベッドはルートレベルの Score 1つにまとめます。シーン固有の短いアクションフォーリーは、そのシーン内に置いてもかまいません。新しいスコアを追加する前に、再利用するシーンに古いベッド音やヒット音が残っていないか確認してください。
4. 重要な動きはすべて useFrame() から発生させます。シード付きの乱数、useBoil、または noise1d を使用してください。壁時計、タイマー、シードなしの乱数は使用しないでください。CSS アニメーションはワーカーの履歴に依存する場合があります。任意の位置へのシーク後も維持する必要がある動きには、フレームベースの動きを使用してください。
5. 映像の制作または仕上げに入る前に visuals.md を、スコアの作成またはミックスの変更前に audio.md を読んでください。これらは実証された落とし穴を扱うもので、必須の作風を定めるものではありません。

ナレーション音声は別スクリプトです

ナレーション API の defineNarration と NarrationAudio を、narration.md に従って使用します。CLI がオプションのモデル／ランタイムをダウンロードするのは、clapper voices install を実行した場合のみです。通常のセットアップは軽量なままです。シーンをまたいで同じナレーター ID を再利用し、clapper-voices.lock.json をコミットします。ロックファイルを黙って更新したり、シーンごとに新しい音声を選んだり、ショットに収めるために話す速度を変えたりしないでください。テイクを用意し、実際の長さを確認してから、原稿またはシーンの時間枠を調整します。戻ってくるナレーターのセリフはまとめて聞き、最終的なミックス済みの映像を確認します。

4. 適切な成果物で反復する

# For a scene named intro; replace with a name from the scene map.
clapper still -c "$clapper_id" --scene intro --every 6 -o out/stills/intro
clapper render -c "$clapper_id" --scene intro --draft -o out/intro-draft.mp4
clapper review -c "$clapper_id" --draft -o out/review/round-1

# Final encode, then review that exact file without another encode.
clapper render -c "$clapper_id" --crf 20 -o out/final.mp4
clapper review -c "$clapper_id" --video out/final.mp4 -o out/review/final

--scene を指定すると、明示した静止フレーム番号はシーン内の番号になります。--range a-b は開始位置を含み、終了位置を含みません。still --range を使う場合、明示したフレーム番号も範囲の開始位置からのオフセットになります。どちらも指定しない場合、--frame は絶対番号です。有効な最終フレームは durationInFrames - 1 です。

中間ファイルの既定値は JPEG q96 で、グレインの多い映像では PNG よりはるかに高速でした。可逆の中間ファイルが重要な場合は PNG を選びます。平坦なアートには CRF 17 が適しています。グレインの多い素材では 20～22 が有用でした。これらを納品要件と見なさず、結果を測定してください。短いシーンや範囲で試しにレンダリングし、遅いレンダリングの原因を調べます。

並行処理： スタンドアロンのパッケージ実装では、ビルドごとに固有の .clapper/harness-*/build ディレクトリが作成されます。出力パスが異なれば、これらのバージョンは並行してビルドできます。以前の Clapper バージョンでは、単一の .clapper/harness-build ディレクトリを再ビルド／削除します。その場合はハーネスコマンドを逐次実行するか、プロジェクトのスナップショットを分離して使用します。分離されていると決めつけず、インストール済みのバージョンまたはソースを確認してください。レビュアーがフレームをキャプチャしている間は、ソースを編集しないでください。

5. 必須の敵対的レビューゲート

レンダリングに成功しても、フィルムが完成したわけではありません。 新たに完成させたフィルム、ショーケース、大幅な仕上げ、またはオリジナルスコアの最終版については、review.md を読み、従ってください。最終エンコードの前に、レビュアーがアクセスできるよう手配してください。ユーザーがタスクをドラフト、プレビュー、または診断に明示的に限定している場合を除き、このゲートは必須です。

1. 利用可能で許可されている場合、独立したレビュアーが必要です。 作成者による確認後、凍結したエクスポートに対する読み取り専用の批評を、別々の映像レビュアーと音声レビュアーに依頼してください。オリジナル音楽の場合は、作曲・演奏についても明示的なレビューを必須とします（音声レビュアーが両方を担当してもかまいません）。音楽のみの制作では、音楽・音声レビューが必要であり、存在しない映像成果物を求めてはいけません。ソーシャルフィード向けの制作では、ミュート状態のフィード／ストーリーのレビュアーを追加してください。
2. 実際の成果物をレビューします。 正確なエクスポートパス／ハッシュ、ブリーフ、シーンマップ、キット、ソースのスナップショットを提供してください。映像レビューには、コンタクトシートだけでなく、再生／動きの証拠を含める必要があります。音声レビューでは、最終的にミックスされたサウンドトラックを確認する必要があります。ステム、ソース、ラウドネスの数値だけでは不十分です。レビュアーは、実際に何を見聞きしたか、何が未検証のままかを明記する必要があります。
3. 判定と問題台帳を収集します。 必須のレビュアーはそれぞれ、SHIP／REVISE／BLOCKED、確認したフレーム／時間範囲、証拠に裏付けられた問題、以前の修正の検証結果を提出します。レポート、ツール、再生、または視聴の証拠がない場合、承認とはみなしません。自己レビューや clapper review の出力は、独立した批評の代わりにはなりません。
4. 修正 → 再生成 → 独立した再確認。 指摘を再現し、対応方針を記録し、受け入れたブロッカー／重大な不具合を修正して、レビュアーに変更後のエクスポートを検証してもらいます。映像、音声、タイミング、小道具、フォーマット、またはエンコードに変更があれば、影響する承認は無効になります。レポートは以前のドラフトではなく、最終成果物に紐付けてください。
5. ゲートを通過せずに最終版／承認済みと宣言してはいけません。 必須のすべての領域に十分な証拠があり、独立した SHIP 判定を得て、未解決のブロッカー／重大な不具合がないことが必要です。独立性の確保、または必要なメディア確認ができない場合は、不足している確認項目を明記し、レビュー未完了と表示したドラフト／部分的な成果物のみを納品してください。不足している機能、またはその制限をユーザーが受け入れるかを具体的に確認してください。要件を黙って引き下げてはいけません。恣意的な数値スコアを追い求めたり、無関係な再設計を追加したりしないでください。

完了とは、次の状態を指します。

1. 要求されたエントリー／ID／フォーマットがレンダリングされていること。冒頭、カット、動きに問題がある箇所、最後の静止フレームの映像を確認し、事実に関する文言と CTA が一致していること。
2. エクスポートしたファイルの音声を確認していること。実際に試聴したのか、測定のみなのかを報告してください。波形を根拠に、試聴したと主張してはいけません。
3. 必須の独立レビューが完了し、受け入れたブロッカー／重大な不具合が修正され、再確認されていること。残っている軽微な指摘や好みに関する意見、およびユーザーが受け入れた制限を記録してください。スコアは補助的なフィードバックであり、証拠の代わりでも、受賞や拡散の保証でもありません。
4. 最終 MP4 とキットが、最終ソース／小道具／フォーマットと一致していること。再生可能な出力とレビューレポートへのリンクを記載し、構成／尺を明示して、映像、音声、および（該当する場合）音楽の判定を個別に報告してください。未レビューの差し替え版を承認済みファイルと表現してはいけません。

コミット、プッシュ、アップロード、公開は、ユーザーが依頼した範囲内に限ってください。このスキルは、それらを許可するものではありません。

これらのルールが設けられた理由と、以前のどのアドバイスが置き換えられたのかについては、session-evidence.md を参照してください。