openmontage-house：OpenMontage ＋ Josh 本家規則

openmontage-house：OpenMontage ＋ Josh 本家規則 は何をしますか？

OpenMontage 本体：<SKILLS_DIR>/OpenMontage（commit 9327439，2026-10-03，AGPLv3）。 本体の完全な説明：AGENT_GUIDE.md、CLAUDE.md、skills/INDEX.md、pipeline_defs/*.yaml。 このスキルは下書きのみを作成し、公開しません。 公開はすべて、Josh の確認後にメインボットが処理します。

最初に OpenMontage を使うかどうかを決定する（<SKILLS_DIR>/INDEX.md の判断表を参照）

• ナレーション付きのバイリンガル Reel、実素材の編集 → stock-footage-reel（本家フォーマット）を使用し、OpenMontage の documentary-montage は使用しない。さらに古い映像／パブリックドメイン素材が必要な場合は、以下の om_clips.py で取得し、pick: {"source":"file", ...} で shots.json に挿入する。
• Vox／知識解説アニメーション → huashu-art-motion を使用し、OpenMontage の animated-explainer は使用しない。
• その他（クリップ分割、スクリーン録画、翻訳吹き替え、ポッドキャスト、リファレンス動画分析、ナレーションなしモンタージュ）→ OpenMontage を使用し、以下の本家ルールでデフォルトを上書きする。

環境

source <SKILLS_DIR>/OpenMontage/om-env.sh   # .venv と Node 22 を有効化し、OpenMontage に cd する
python -c "from tools.tool_registry import registry; import json; registry.discover(); print(json.dumps(registry.support_envelope(), indent=2))"   # 利用可能なツールを確認

• インストール済み：requirements.txt、Remotion composer（npm）、piper-tts、faster-whisper、yt-dlp、youtube-transcript-api、opencv-headless、HyperFrames（npx キャッシュ 0.8.147）、および CPU 版 torch 2.14.1＋transformers 5.19（GPU パッケージなし）。CLIP セマンティックマッチングが利用可能：corpus_builder で素材ライブラリを構築後、clip_search の rank_for_slot でテキスト記述に基づいて素材を並べ替え（スコア 0.25 以上で使用可能）；video_understand（CLIP モード）も使用可能。初回は Hugging Face から CLIP モデル（openai/clip-vit-base-patch32）をダウンロードします。CPU で 5 つの素材の小規模ライブラリを構築するのに約 1 分かかります。corpus_builder で degraded と表示されるのは、素材ソースの半分にキーがないためで、使用には影響しません。
• キー：PEXELS_API_KEY、ELEVENLABS_API_KEY はマシンの環境変数（新しいシェルを開いた場合のみ利用可能。必要に応じて bash -lc を使用）。om-env.sh で引き継がれ、.env には意図的に記述していません。出力したりファイルに書き込んだりしないでください。 他のキーはすべて空です。**OpenMontage のために新しいアカウントや有料キーを取得しないでください。**追加する前に Josh に確認してください。
• 有料生成（Kling、Veo、Seedance、FLUX など）のキーは現在ありません。セレクターは自動的にスキップします。OpenMontage は費用が発生する前に見積もりを提示し、Josh の承認を必要とします。

本家ルール（OpenMontage のデフォルトを上書き。すべての動画で実施）

1. 画面：縦型 1080x1920（OpenMontage のほとんどのデフォルトは 16:9。作業開始時に 9:16 を指定）。3 分以内。簡潔さよりも完全性を優先。
2. 吹き替え：ElevenLabs 英語女性音声 Sarah Explains（voice_id Nhs7eitvQWFTQBsf0yiT）、model eleven_multilingual_v2。
   • 優先：OpenMontage 独自の elevenlabs_tts ツールを直接使用（動作確認済み）。voice_id を指定し、tts_selector に自動で音声を選択させたり piper にフォールバックさせたりしない。例：ElevenLabsTTS().execute({"text":..., "voice_id":"Nhs7eitvQWFTQBsf0yiT", "model_id":"eleven_multilingual_v2", "output_path":".../vo.mp3"})。原稿は 1 回につき 1 回送信し、重複送信しない（ポイントが重複して消費される）。
   • 代替：直接 API が失敗した場合、user-Elevenlabs コネクタ（creative_generate_speech、generations_count: 1）を使用して vo.mp3 を生成し、既成のナレーションとして OpenMontage に渡す。piper を正式な吹き替えに使用しない。
3. 字幕：繁体字中国語のメイン字幕＋その下に小さな英語字幕（英語は吹き替えに対応）。台湾の用語、「」引用符、ダッシュは使用しない。字幕の下端は y=1490 を下回らず、IG インターフェースを避ける。
4. カバー：B剪報 Vox テンプレート、<YOUR_WORKSPACE>/media-team/00-profile/covers/render.py（OpenMontage 独自のカバー／サムネイルは使用しない）。
5. ライセンス：すべての素材を credits.json に記録（URL、作者、ライセンス）。Archive.org のライセンスは「verify per item」。各アイテムのページを開いて、パブリックドメイン、CC0、または CC BY であることを確認する必要がある。BBC、テレビ局、映画会社の映像は使用しない。CC BY の場合は、投稿の説明に明記する。
6. ファイル：IG 完成動画は H.264／AAC、45 MB 以下に圧縮（ffprobe でサイズと長さを確認）。
7. 内容：原文に忠実に。数字や引用を捏造しない。原作者を明記する。
8. 出力：完成品は <YOUR_WORKSPACE>/media-team/03-drafts/<題目>/ に配置。OpenMontage の projects/ は作業領域としてのみ使用。

各ワークフローの開始方法

OpenMontage フォルダで Claude Code を開く（CLAUDE.md を読み込む）、または他のボットで直接 skills/pipelines/<ワークフロー>/executive-producer.md を読み、フェーズに従って実行する。作業開始の最初の文で、上記の本家ルールを貼り付ける。

• clip-factory：長尺動画（YouTube、ライブ配信、ポッドキャスト録画）を複数の縦型ショートクリップに分割。動画を yt-dlp で取得する前に、Josh に使用権限があることを確認する。
• screen-demo：実際のスクリーン録画チュートリアル（screen_recorder／cap_recorder が利用可能）。
• localization-dub：動画を別の言語に翻訳して吹き替える。吹き替えも同様に、最初に ElevenLabs コネクタで生成し、タイミング調整とミキシングのために渡す。
• podcast-repurpose：ポッドキャスト音声ファイルをハイライトショート動画に変換。
• リファレンス動画分析：Reel／Short を貼り付け、テンポ、導入、構成を分析させ、2～3 のオリジナルバージョンを提案し、コストを見積もる（animated-explainer、animation、cinematic、character-animation には reference_input がある）。構造のみを学習し、映像やコピーをコピーしない。
• documentary-montage：ナレーションなし、または少ないテーマモンタージュ（Adam Curtis スタイル）。CLIP セマンティックマッチングを使用して、各セクションに自動で素材を選択。ナレーション付き Reel は引き続き stock-footage-reel を使用する。
• Backlot 絵コンテボード：python -m backlot open <project-id>（ローカルボード。観察用のみ。失敗しても制作に影響しない）。進捗とチェックポイントの確認のみ。Josh の確認は引き続きチャット内で行う。

stock-footage-reel に素材を追加して取得

python3 <SKILLS_DIR>/openmontage-house/scripts/om_clips.py \
  --query "1960s computer room" --query "mission control" \
  --sources archive_org,nasa,loc,nara,wikimedia --n 3 --out $D/work/om_clips

各クリップのサムネイルパスと、shots.json に直接貼り付け可能な pick（{"source":"file",...}）を出力。ライセンス記録は om_clips/om_credits.json に書き込まれる。サムネイルを Read で確認し、各クリップのライセンスを確認してから動画に使用する。 利用可能なソース：pexels（キーあり）、archive_org、wikimedia、nasa、nara、loc、coverr、pond5_pd。NASA のダウンロードは時々タイムアウトする（images-assets.nasa.gov）。失敗した場合は note: が出力されるので、ソースを変更する。

ライセンス（AGPLv3）

OpenMontage をツールとして使用して動画を作成したり、商用投稿を行ったりすることは可能です。生成された動画は AGPL の制約を受けません。**「そのコードを変更し、ネットワークサービスとして他人に提供する」**場合のみ、ソースコードを公開する必要があります。したがって、改変した OpenMontage を外部サービスとして公開しないでください。