社内研修の短い動画や、製品の操作を説明する動画をAIに頼んだとします。MP4ができても、指定した秒数、画面の大きさ、日本語の文言、数字の正しさまでそろっているとは限りません。brief2mp4は、動画の依頼文から制作と検査を進める、Claude Code・Codex向けの公開スキルです。
v0.3.0の公式check_delivery.shをMacで実行し、2秒の人工テスト動画が合格すること、秒数の不一致と無音の許可漏れで失敗することを確認しました。日本語の文字が一つもない動画でも形式検査は通ります。PASSを、依頼内容すべての保証と読み替えないことが導入の要点です。
何が新しいのか:v0.3.0でWindows対応と追加制作ツールを拡充
v0.3.0リリースの公開時刻は2026年11月15日14:01:35 UTC、日本時間では15日23:01:35です。16日夕方の確認時点から約17時間前に当たります。Show HNへの投稿日時ではなく、GitHub Releasesのpublished_atを基準にしています。
| v0.3.0の主な変更 | 読者にとっての意味 |
|---|---|
| セットアップの案内とWindows対応 | OSごとの準備、PowerShell用インストーラー、Git Bashを使う経路を追加。Windowsで試す入口が用意された |
| 動画形式別のガイド | 短い解説、縦長動画、データの説明、製品紹介など、依頼文とチェック項目を考えやすくする |
| 任意の3Dパック | CAD・メッシュ、材質、物理シミュレーション、分解図などを組み込むための追加機能 |
| 任意の編集パック | 映像編集、音声、合成などに外部の編集ツールを組み合わせる選択肢 |
差分はCHANGELOGで確認できます。今回の記事では、まず基本の制作・検査の流れを対象にします。3Dや編集パックは初回から全部入れる必要はなく、それぞれ別の依存ツールと確認が必要です。
仕組み:依頼文、制作、実ファイルの測定、画面の確認を往復する
公式READMEと制作構成の説明では、依頼文から仕様と完成条件を整理し、用途に応じた描画ツールを使い、MP4を書き出して確認する流れを示しています。ここでいう「ブリーフ」は、誰に何を伝え、どんな形で完成させるかをまとめた依頼書です。
| 工程 | 作るもの・確かめること | 残す根拠 |
|---|---|---|
| 依頼を仕様へ | 秒数、縦横、画面の文言、場面ごとの時間、音の有無を決める | 依頼文、仕様、完成条件の一覧 |
| 制作・描画 | 2DはHyperFrames、3DはThree.jsや任意の追加ツールなどを使う | 編集できる素材と制作ファイル |
| 形式を測定 | ffmpeg・ffprobeなどでMP4の長さや映像・音声形式を確認する | PASS/WARN/FAILを含む測定結果 |
| 画面と内容を確認 | 実際のフレームを見て、文字、配置、場面、依頼との対応を点検する | 条件ごとの確認結果とREPORT.md |
| 修正して再確認 | 未達の条件を直して再出力する | 最終MP4と残る未確認事項 |
動画ファイルを測る検査と、依頼の意味を読み取る確認は別です。長さや解像度が合っていても、棒グラフの数字、固有名詞、操作順序が正しいとは決まりません。制作エージェントが出した報告も、根拠のフレームや元資料と照合して使います。
導入条件と料金:「無料スキル」と制作全体の費用を分ける
| 項目 | 公式に示された条件・注意 |
|---|---|
| 対応環境 | macOS、Windows、Linux。Windowsではbashスクリプトを動かすGit for Windowsが必要 |
| 基本のツール | Node.js 22以上、ffmpeg・ffprobe、git |
| 任意のツール | 写実的な制作ではBlender、3DパックではPythonなど。選んだ工程によって変わる |
| ライセンスと費用 | スキル自体はMIT。Claude Code・Codexの利用料金や実行環境の費用は別。外部ツール・素材の利用条件も別に確認 |
| 日本語 | 日本語の字幕・改行・フォント・読みやすさを保証する実測値は今回確認できていない。完成した画面で検査する |
| OS別の検証範囲 | READMEはWindows・macOS・UbuntuのCIと、Macでの全工程レンダリング試験を説明。同じ品質や速度を全OSで実証したとは扱わない |
条件はv0.3.0の導入ガイドとライセンスを参照してください。機能説明にある「ローカルで描画」は、利用するAIモデルまで端末内で動くという意味ではありません。エージェントへ渡す依頼文・素材と、そのサービス側のデータ取り扱いを別に確認します。
初回は、社外へ出してよい架空の題材と短い動画で始めます。未公開の製品図面や顧客の画面を最初のテストに使う必要はありません。追加パックは、その制作に必要になった段階で導入範囲と容量を確認すれば十分です。
最初の使い方:12秒の説明動画に完成条件を書く
- 1公式リポジトリのSETUP.mdと導入ガイドを開き、自分のOSで必要なツールを確認する。既存環境への変更内容を確認してから、案内された導入経路を一つ選ぶ。
- 2導入ガイドのdoctor.shで準備状態を確認する。必須ツールの不足を解消し、最初は3D・編集パックを追加せずに試す。
- 3スキルを利用する新しいセッションを、専用の作業フォルダーで始める。次のような日本語依頼文を渡す。
- 4完成後に、元の依頼文の各条件と照合するよう指示する。final.mp4だけでなく、REPORT.mdと確認に使ったフレームを読む。
- 5日本語の文言、数字、音の有無、停止画面の読みやすさを人が確認し、未確認の項目が残る場合は公開を待つ。
導入操作の具体的な経路は公式SETUP.mdを参照してください。以下は本誌が作成した依頼文の教材で、これによる完成動画を今回生成したわけではありません。
brief2mp4を使い、社内研修用の12秒の説明動画を作ってください。
題材は「データの確認を3段階に分ける」です。架空の例とし、外部素材や実在の顧客情報は使いません。
納品仕様:1920×1080、30fps、MP4。長さ12秒。無音を意図した動画です。
画面の文言は次の3つを、そのまま使用してください。
0〜4秒:「① 数字を確かめる」
4〜8秒:「② 出典を確かめる」
8〜12秒:「③ 人が判断する」
各場面の最後の2秒は文字を静止させ、読み取る時間を確保してください。
白に近い背景、濃い文字、強調色は1色。日本語の全字形を表示でき、利用条件を確認したフォントを使います。
完成条件:
- 指定文言の欠落・誤字・文字化けがない。句読点や丸数字も照合する。
- 文字や図が画面からはみ出さない。一般的なスマートフォンで読めるか、人が確認できるフレームを出す。
- 指定の3場面が正しい順にあり、各場面の表示時間が仕様と一致する。
- 無音は意図した仕様として報告に残す。検査に必要な無音の音声トラックの扱いも明記する。
- final.mp4とREPORT.mdを納品し、各条件に根拠となる時間・測定値・フレームを対応付ける。
- 自動検査で確認できないことは「未確認」と書く。PASSだけで日本語や内容の正しさを保証しない。
追加の契約・課金・素材購入・外部への公開は行わず、必要なら作業前に知らせてください。日本語ブリーフをTXTで保存できます。「読みやすく」だけでなく、画面の正確な文言と時間を先に決めると、直す箇所を示しやすくなります。フォントサイズの数値だけで合格にせず、出力後の実寸でも確かめます。
Macで試した結果:形式検査の成功と失敗を分けられた
今回はv0.3.0のcheck_delivery.shを取得し、内容を確認して単体実行しました。環境はmacOS 27.2.1、arm64、ffmpeg 7.1.1です。動画はffmpegで作った2秒・640×360・30fpsの人工テストパターンで、映像はH.264/yuv420p、音声は48kHzのステレオAAC無音トラックです。実務動画や日本語テキストを含めていません。
| 試験条件 | 期待結果 | 実行結果 |
|---|---|---|
| 2秒・640×360・30fps、無音を許可 | 形式が一致して合格 | PASS、終了コード0 |
| 同じ動画に「3秒」を要求 | 長さが違うので不合格 | FAIL、終了コード1。長さの不一致1件 |
| 同じ動画で無音許可を付けない | 意図しない無音として不合格 | FAIL、終了コード1。無音1件 |
この結果の意味は限定的です。スクリプトが秒数や音声条件の違いを検出した一方、日本語を一文字も含まないテストパターンも、指定した形式を満たせば合格しました。スクリプトは依頼文そのものを引数に受け取っていません。したがって、形式検査だけで「日本語依頼を満たす動画が完成した」とは言えません。
自分で確かめる:同じ動画に違う完成条件を与える
以下はmacOSまたはLinuxのbashで、ffmpeg・ffprobeが利用できる環境向けの再現手順です。Windowsでは対応するGit Bash環境が必要ですが、本誌では未実行です。公式v0.3.0からcheck_delivery.shを作業フォルダーに保存し、内容を確認してから使います。スキル全体のインストールやAPIキーは、この試験には必要ありません。既存ファイルを上書きしない空のフォルダーで実行してください。
# 人工テスト動画を作成。日本語や業務データは含めない。ffmpeg -hide_banner -loglevel error -n \ -f lavfi -i 'testsrc2=size=640x360:rate=30' \ -f lavfi -i 'anullsrc=r=48000:cl=stereo' \ -t 2 -c:v libx264 -pix_fmt yuv420p -c:a aac format-fixture.mp4
# 期待:PASS(終了コード0)bash check_delivery.sh format-fixture.mp4 \ --seconds 2 --size 640x360 --fps 30 --silent-ok
# 期待:長さが不一致なのでFAIL(終了コード1)bash check_delivery.sh format-fixture.mp4 \ --seconds 3 --size 640x360 --fps 30 --silent-ok
# 期待:無音を許可していないのでFAIL(終了コード1)bash check_delivery.sh format-fixture.mp4 \ --seconds 2 --size 640x360 --fps 30元の検査スクリプトは、長さの許容差をおよそ1フレームとし、映像形式、解像度、フレームレート、音声形式や音量などを確認します。48kHz以外のサンプルレートやモノラルなどはWARNになる項目があり、警告があっても最終結果がPASSになる場合があります。終了コードだけでなく、各行と依頼条件を読み合わせます。
また、--silent-okは「音声トラックを省いてよい」という指定ではありません。この版では音声トラック自体がないと失敗します。無音の映像を納品する場合も、どの仕様を求めているかを先に決めます。黒い画面や静止が長いという警告も、意図した演出なら報告へ理由を残します。
日本語の仕事で残したい確認表
以下は運用上の確認項目です。check_delivery.sh単体がすべてを自動検査するわけではありません。場面・文字・値を確認するには、制作ファイルや実際のフレームなど、別の確認材料も用意します。
| 確認対象 | 機械で測る項目 | 人が確認する項目 |
|---|---|---|
| 研修の手順説明 | 秒数、画面サイズ、場面のタイミング | 実際の業務と操作順が一致するか |
| 日本語の見出し | 領域からのはみ出しや表示時間の確認材料 | 誤字、丸数字、改行、フォント欠落、読み切れる長さ |
| データの説明 | 描画へ渡す値や表示値の照合 | 単位、期間、母数、グラフの軸が誤解を招かないか |
| 製品の紹介 | 指定画像や場面があるかの確認材料 | 実在の機能・価格・外観と一致するか、素材を使う権利があるか |
| 音声付き動画 | 音量・ピーク・音声形式 | 固有名詞の読み、字幕との一致、聞き取りやすさ |
最初の導入対象には、文言と根拠を自分たちで確定できる短い研修動画や手順説明が向いています。これは用途の提案であり、brief2mp4での日本語品質を実測した評価ではありません。字幕や仕様の誤りを検査で減らせるか、同じ題材で修正回数と人の確認時間を記録して判断します。
導入判断:生成の速さだけでなく、確認できる根拠を見る
今回確認した範囲では、公開直後の作者によるShow HN紹介がありましたが、独立した利用者による性能検証は確認できませんでした。作者の制作例を、全モデル・全OSで再現できる実績として扱っていません。日本語で製品名や動画検査を検索した範囲でも、本製品の詳しい第三者解説は確認できませんでしたが、日本初・解説ゼロとは断定しません。
日本語動画では、依頼文の文言と完成した画面を照合できることが重要です。brief2mp4の採用判断も、「MP4が出たか」から一歩進めて、どの条件にどの証拠があり、どこに人の確認が残るかで行うと実務につながります。
確認日:2026年11月16日。仕様・単体試験の対象はv0.3.0です。スキル全体による動画生成、3D・編集パック、Windows/Linuxでの描画、日本語字幕や音声品質は未実測です。無料で使えるコードと、エージェント利用料金・素材の条件を分けて確認してください。