Communitygithub.com

動画レビュー・納品サイクル

制作した映像を納品可能な状態に仕上げるループ処理です。フレームの確認、サウンドの計測、各種チェックの実行、関係者へのドラフト・サンプルの提示とフィードバックへの対応、マスターレンダー、完成ファイルの検証、プロジェクト記録の作成、そして報告を行います。ビルド後や変更後、レンダリング前、フィードバックが届くたびに使用します。

動画レビュー・納品サイクル とは?

このスキルは、映像制作プロジェクトにおいて「ビルド」から「納品」までのループを自動化・効率化するための包括的なワークフローを提供します。主に Claude Code などの AI エージェントが実行する一連のタスクの集合体であり、開発者や映像制作者はこれを利用することで、手作業による確認やレンダリングの繰り返しを減らし、品質の高い最終成果物を迅速に納品できます。 スキルは9つのセクションで構成され、変更後のスナップショット確認(`npx hyperframes snapshot`)、低品質ドラフトのレンダリングとラウドネス計測、オプション提示方法、フィードバック処理(よくある指摘と対応の表を含む)、マスターレンダリング(`npx hyperframes render --quality delivery`)、完成ファイル検証(`ffprobe`、シート確認、QRコードスキャンなど)、プロジェクト記録の更新(`SCRIPT.md`、`SPEC.md`、`CREDITS.md`、`REVIEW.md`)、そして最終報告メッセージの作成までをカバーします。 このスキルは、AIエージェント(Claude Codeなど)が`SKILL.md`として読み込むことで、映像制作プロジェクトにおける反復作業を自律的に遂行するための知識ベースとして機能します。特に、変更のたびに高コストなレンダリングを避け、安価なスナップショットで問題を早期発見するアプローチや、フィードバックを具体的なアクションに変換する方法が実践的に記載されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shubhamnshukla/video-agent-kit/tree/main/skills/video-review-and-delivery

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

レビューと納品

1. 変更後のループ

  1. npx hyperframes lint。エラーゼロ。
  2. npx hyperframes snapshot --at 3.4,7.8,35.2,... 変更した瞬間と、その前後の各1点を指定します。 コンタクトシートを開いて実際に読みましょう。すべてのカードは完全か、顔が隠れていないか、テキストが枠からはみ出していないか、描画途中のまま完了すべきものはないか。
  3. 修正し、フレームが正しくなるまで繰り返します。
  4. npx hyperframes check --json(または4K映像の場合はscripts/check.sh)を実行します。エラーを修正します。警告は一度読んでから決断します。修正するか、そのまま維持するか、その理由をREVIEW.mdに記述します。対応すべき警告の例:3秒以上変化がない、最初のフレームが空、テキストがコンテナからはみ出している。

スナップショットは安価です。レンダリングは高価です。レンダリング前にできる限りの確認を行いましょう。

2. ドラフト

ドラフトは低品質の作品全体です。npx hyperframes render --quality draft -o renders/draft-01.mp4で、100秒の1080p映像なら1〜3分で完了します。その後:

  • レンダリングされたファイルのシートを作成します(scripts/sheet.sh renders/draft-01.mp4 sheet.jpg 1/2.6 8x5)。それを読みます。実際にエンコードされた映像が表示されるため、スナップショットでは見逃す可能性がある問題も確認できます。
  • ラウドネスを測定します:ffmpeg -i draft.mp4 -af ebur128=peak=true -f null -
  • 2秒ごとのレベルを測定します(scripts/levels.py draft.mp4 2)。計画と比較します。静かな部分は静かか、製品が登場するタイミングで盛り上がりが来ているか。

ドラフトを関係者に渡す際は、その内容と、特に注目してほしい点(映像と音声)を短いメモで伝えます。最初のドラフトは修正されるために存在します。完璧に仕上げるよりも、早めに渡すことを優先します。

3. オプションの提示

問題が見た目に関する場合(ハイライトスタイル、フォント、レイアウト、色など)は、レンダリングではなく静止画で示します。

  • 各オプションをビルドし、同じ3〜4か所をスナップショットし、コンタクトシートを横に並べて保存します。ファイル名は簡潔に(A-underline.jpg、B-band.jpg)。
  • AとBが何であるか、どちらを選ぶか、その理由をそれぞれ1行で述べます。
  • この点に関する回答だけを待ちます。それに依存しない作業は並行して進めます。

相手の言葉が複数の意味にとれる場合、これが確認する方法です。これには1分しかかかりません。間違ったフルレンダリングには10分と相手の忍耐が必要です。

4. フィードバックへの対応

フィードバックは短く、インフォーマルで、時にはイライラした形で届きます。次のように対応します。

  • 行動として言い換えてから行動に移します。1行で:「シンガポールの写真:他の写真と同じ小さな書体で、問題部分とエンディングの両方で。」
  • 該当するすべての箇所に適用します。 ある要素が間違っていた場合、映像内の同種の要素も同様に間違っています。
  • 好みはそのまま受け入れます。 「遅い」「退屈」「安っぽい」「太すぎる」:変更します。弁護しません。事実に反すると思われる点(顔が隠れる、主張が虚偽になるなど)については、理由を添えて一度だけ述べます。
  • よくある指摘とその意味:
相手の言葉対応
遅い、眠い、退屈ショットを短く、ナレーションを速く、セリフをカット、よりエネルギッシュな音楽に。エフェクトは増やさない
リアルじゃない、AIっぽい実際の人物が写った実際の映像を使用。作り物のグラフィックは減らす
ストッククリップを貼り付けただけに見える全体に統一したグレード、繰り返し登場する人物、一貫性のあるカード
共感できない名前、職業、具体的な要望。問題を相手自身の言葉で
音が平坦で単調ムードに合わせてスコアリング。盛り上がる前に静けさを
キャッチーにしてフックとまとめの一文を書き直す。コールバックを追加
これは他と違う兄弟作品と完全に一致させる
この言葉をもっと強調して1行に1つの強調マーク。まず静止画で表示
  • 複数のメッセージが同時に来た場合: それぞれに対応し、その方法を1行で伝えます。後のメッセージが前のメッセージを上書きします。
  • 決定事項を記録します: REVIEW.mdに、そして記憶にも。相手が選んだもの、拒否したものを、相手の言葉で。

5. マスターレンダー

ドラフトが承認されたら、または残りの変更が小さくなったら:

  1. 空きディスク容量を確認します。4Kレンダリングには、100秒あたり約11GBの一時領域が必要です。
  2. npx hyperframes render --quality delivery --resolution landscape-4k -o renders/<名前>-4k.mp4をバックグラウンドで実行します。高速化が必要な場合や依頼があった場合は--gpuを追加します。その代償(ビットレートが約半分になること)も伝えます。
  3. 所要時間を聞かれたら、レンダリングの進捗を読み取り、数値で回答します。

バージョン名は簡潔に付けます(-v2、-v3)。拒否されたバージョンは削除し、誤って開かれないようにします。

6. 完成ファイルの検証

これはプロジェクトではなく、これから引き渡すファイルに対して実行します。

  • ffprobe:解像度、フレームレート、再生時間、サイズ。
  • ファイル全体のシート:すべてのセクションが存在する、空白やフリーズした部分がない、最後のフレームが正しい。
  • テキストと顔のフルサイズ切り抜き:シャープな文字、映像がブロックノイズでないこと。
  • ラウドネス:統合ラウドネス約−16 LUFS、トゥルーピークが−1 dBFS以下。
  • 後半のフレームからデコードしたQRコード(scripts/scan.py):正確なリンク、フルサイズと半サイズの両方で確認。
  • エンドカードのアドレスは、要求された場合のみ回答。

7. プロジェクト記録

報告前に4つのファイルを更新します。templates/に各ファイルの雛形があります。

  • SCRIPT.md:スクリプトテーブル(時間、映像、ナレーション)、登場人物、各セリフの出典、数字。
  • SPEC.md:目的、出力、タイミングとサウンド計画、見た目、タイポグラフィ、モーション、フレーム付きショットリスト、QAリスト。
  • CREDITS.md:すべてのソースとそのライセンス。
  • REVIEW.md:行われた判断。測定済み、確認済み、未確認の項目。未解決の決定事項。最も弱いショット。意図的に維持した警告。映像の変更方法(どのファイル、どのコマンド)。

8. 引き渡しメッセージ

簡潔に、次の順序で:

  1. ファイル:パス、解像度、長さ、サイズ。
  2. 前回のバージョンからの変更点を簡潔なリストで。
  3. 確認した内容と方法。確認しなかった内容(例:音声は聞いていない)。
  4. 決定が必要な事項。重要度順:プロダクトに反映されていないもの、会社が表示を望まない可能性のある画面上のもの、確認が必要なライセンス、確認が必要な発音。

自分の作業に対する形容詞は使わないでください。何かが失敗した、または欠落している場合、それを最初の行に書きます。

9. ハウスキーピング

  • 映像の元となるソースダウンロードとマニフェストは保持します。使用しなかった候補、古いドラフト、キャッシュは、容量が不足している場合や依頼があった場合に削除します。削除しようとしているものを確認し、自分が作成したものだけを削除します。
  • 依頼がない限り、リポジトリをコミットしたりプッシュしたりしないでください。
  • ジェネレータースクリプトやヘルパースクリプトはプロジェクト内に置き、再起動で消える一時フォルダには置かないでください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル