動画制作(エントリ)
出典: docs/MONTAR_VIDEO.md. このスキルは操作スクリプトです。詳細(推論テーブル、完全なコマンド、並列処理、よくある問題)はそちらにあり、セクション(§)で参照します。リポジトリの CLAUDE.md のルールも読んでください。これらが優先されます。
ステップ0 · 起動(まだ何も質問しない)
- 開始時刻:
date '+%Y-%m-%d %H:%M:%S'。保存します(BRIEF.md › 開始とレポートに使用)。 node scripts/doctor.mjs(約1秒、読み取り専用)。「準備完了」を読み取ります。該当フローの ✗ → 出力された解決策を適用します(ローカルかつ無料の場合)、またはインタビューと同じメッセージでユーザーに伝えます。ls brutos/ projects/を確認します。プロジェクトが既に存在する場合は、再開します(BRIEF.mdとinforme.mdを読み、インタビューは行いません)。brutos/のファイル名に人物名が含まれている場合、チャットではその名前ではなく、ffprobeで再生時間と解像度を説明します。
ステップ1 · インタビュー: AskUserQuestion を1回呼び出し(3~4の質問)
その前に、ユーザーの発言から可能な限り推論します(§2)。ユーザーが既に言ったことは質問しないでください。その質問を予備の次の質問に置き換えます。各質問: 2~4の選択肢、推奨するものを最初に「(推奨)」のラベルとその理由を説明に付けて表示します。常に自由回答(「その他」)を残します。各質問の詳細: §1。
| # | ヘッダー | 質問 | 選択肢(コンテキストに応じて推奨) |
|---|---|---|---|
| 1 | 素材 | どんな動画で、どんな素材を使いますか? | 講演者収録(brutos/ に raw 素材あり) · AI音声ナレーション(ニュース、解説動画;収録なし) · 生成・プロモーション(HyperFrames) |
| 2 | テンプレート | どのテンプレートを使いますか? | 1に応じて: clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / HyperFrames フロー — そしてテンプレートなし、自由。1が未確定の場合: 長編チャプター形式 · 短編 · 自由 |
| 3 | スタイル | どのスタイルを使いますか? | カタログから2つ、該当するもの。参照先のパス付き(estilos/README.md) · Webサイトまたは動画から新規作成(estilos-video §5)。自由 → その他 |
| 4 | フォーマット | 長さとフォーマットは? | 16:9、テンプレートの長さ(Remotion) · 9:16 · 16:9 と 9:16(video-corto で推奨)。他の長さ → その他 |
予備(順番): 言語 · 音声(デフォルトは .env のもの、モデル eleven_v4) · 音楽と効果(スタイルのものか、ElevenLabs で新規) · フォント(ユーザー提供または公式のものを調査) · 講演者の切り抜き · 対象者と公開先。パスによるスタイルの推奨、テンプレートの長さと実際の例: §1 および §1.1。
必須項目で不足がある場合のみ、2回目の質問: どの raw 素材か(複数ある場合)、トピック、URL。
その他のエージェント(Codex…): 同じ内容を1つのメッセージに、質問番号と選択肢をリストにして送信します。
ステップ2 · Brief
回答をもとに、確認済みの内容と推論した内容(出典付き)を1段落にまとめ、無料の作業をすぐに開始します。plantillas/<テンプレート>/BRIEF.md から BRIEF.md を作成します(§3):
- Remotion:
tools/kaleidos nuevo …(空のものを作成)の後、テンプレートの内容で置き換えます。 - HyperFrames:
npx hyperframes initの後にフローが作成します(init はファイルが既にあると拒否します)。
ステップ3 · ルーティング(正確なコマンドは §4)
| 素材 | ルート | 手順 |
|---|---|---|
| 講演者収録 | §4.1 | スキル edicion-ponente に従う: tools/kaleidos nuevo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo をバックグラウンドで実行 → 文字起こし全体を読む → guion.json(plantillas/<テンプレート>/ にスケルトン) → linea / media / capitulos |
| AI音声ナレーション | §4.2 | tools/kaleidos nuevo <slug> --narracion --estilo milikito --escenario → plantillas/<テンプレート>/* をコピー → fuentes.md に公式フォント → locucion.json → 並列で images.mjs ‖ capture.mjs ‖ voz --simular と voz --max-caracteres N → transcribir → python3 plantillas/herramientas/cues.py <slug> → media → linea → media → capitulos |
| 生成・プロモーション | §4.3 | スキル /hyperframes をロード(video-corto、product-launch-video、general-video…を選択)、プロジェクトは proyectos/<slug>/、スタイルは init 後に frame.md として保存 |
| 新スタイルまたはバリエーション | §4.4 | スキル estilos-video(§5 新規、§6 バリエーション)を使用し、validar.mjs が成功してから使用 |
ナレーションでは intro.previo はあり、intro.hasta はなし。チャプタータイトルの3〜4秒の間にイベントはなし。吹き出しは x 0.2~0.25、y 0.16~0.17(§4.2、ポイント6)。
ステップ4 · 並列処理(§6)
競合しないものは同時に起動: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ 調査とスクリプト作成;preparar --paralelo(CPU でポーズ、GPU で切り抜き)と、文字起こしができ次第スクリプト作成。16 GB では同時実行不可: recortar + transcribir + pose、2つの GPU ステップ、2つの stills.mjs、el-audio.mjs と voz。長時間処理は完全なログ付きでバックグラウンド実行(ffmpeg に grep は不可)。Lambda は --concurrencia max を使用。
ステップ5 · 制御点(§5)
- 有料 API:
voz --simular(文字数)と画像生成前の枚数確認;Apify は brief で要求された場合のみ、--dry-runと--budget付き。 - Lambda の前に必ずスチル確認:
node motor/scripts/stills.mjs <slug> --at eventos→ シート(motor/out/stills/<名前>/hoja.jpg)を Read で開き、実際に確認して修正(コードより先にスクリプトを修正)。スタイルへの準拠はestilos-video§7。HyperFrames:npx hyperframes check --snapshots。 - AWS:
node motor/scripts/lambda.mjs <slug> --dry-run --concurrencia max→ リソース(関数、サイト、プライベートバケット、アップロード)、関数数、推定コストと時間を表示 → 明示的な OK を待つ。ユーザーが既にこのリクエストで Lambda レンダリングを明示的に要求した場合: 表示してすぐに実行。リソースの作成(バケット、スタック、IAM)には常に別途 OK が必要。HyperFrames で Lambda がデプロイされていない場合 → 警告し、ローカルレンダリングかデプロイかを提案。 - 出力:
ffprobe+ フレーム数カウント、1分あたり1フレームのシート、python3 plantillas/herramientas/normalizar_audio.py 結果/<slug>.mp4 --en-sitio(Lambda 出力は約 −13 LUFS)。 - 最終レポート(
proyectos/<slug>/informe.md+ チャットでの要約): 長さ、構造、確認内容(全フレームではなくサンプリング)、警告、矛盾、実経過時間(開始 → MP4 確認完了、work/logs/tiempos.jsonの内訳付き)、費用(実際の Lambda + S3 + 転送;ElevenLabs の文字数はwork/voz/manifest.jsonから;画像;Apify)。金額をでっち上げないこと: 価格がわからない場合は、消費量を記載します。AWS に何が残っているかを伝えます。
絶対に破ってはいけないルール(§8 および §9)
- プライバシー: 回答、レポート、グラフィック、タイトルに顧客の個人データを含めない。個人データを含む文字起こしの断片を引用しない。画面に表示されるものはぼかす。タイトルは汎用的に。
.env: 値を表示したりURLに入れたりしない。doctor は名前のみを出力する。- コンテンツ: グラフィックは音声の内容を要約するもの。捏造しない。時事問題は
fuentes.mdに日付付きで引用された公式情報源のみを使用(Web サイトがダウンロードに 403 を返す場合は、統合ブラウザで読む)。矛盾はレポートに記載。法律・医療関連は専門家の検証が必要。 brutos/および~/videos-opusは読み取り専用。Remotion 4.0.529 を厳密に使用。フォントは OFL/Apache ライセンスのもののみ。