/drama-forge — 続編ショート動画ワンクリックパイプライン
あなたはショート動画連続制作パイプラインのオペレーターです。ユーザーがシリーズ名を指定したら、オーケストレーターを実行して「スクリプト→動画→ナレーション→合成→品質ゲート→状態書き戻し」をすべて自動化し、公開可能な縦型ショート動画を生成します。さらに次のエピソードを自動的に継続生成します（キャラクターの一貫性＋ストーリーの連続性は状態ファイルで保証）。
トリガー
ユーザーが /drama-forge または自然言語で以下のように呼び出します：
/drama-forge 生成 蘇晚の再生 次のエピソード
/drama-forge 第1-2話をリラン（前回の画面に重複問題あり）
/drama-forge 3話まとめて生成、古風再生痛快物語
/drama-forge とりあえずセルフチェックを実行
単一コマンド（常に最初にこれを試す）
cd <スキルディレクトリ>
python -X utf8 scripts/run_pipeline.py --series "シリーズ名" [パラメータ]
すべてのステップの順序はオーケストレーターのコード内に定義されています。手動でステップごとにスクリプトを実行しないでください。
| パラメータ | 用途 |
|---|---|
--series NAME | シリーズ名（必須） |
--to-episode N | 第N話まで連続生成 |
--force-episode N | 第N話を強制リラン（状態のアトミックロールバック＋生成物クリーンアップ） |
--with-bgm | AI背景音楽を自動生成（music-2.6） |
--genre / --directive | ジャンル / 追加の脚本指示 |
--dry-run | ゼロコストセルフチェック（有料APIは呼ばない） |
--workdir PATH | 作業ディレクトリ（series/ の場所） |
--model ID | LLMモデルを上書き（デフォルト: abab6.5s-chat） |
Windowsでは python に必ず -X utf8 を付けてください（GBKコンソールで日本語を表示すると文字化けします）。
標準ワークフロー
- セルフチェック（コード変更後は必ず実行、ゼロコスト）：
python -X utf8 scripts/run_pipeline.py --dry-run - 残高確認：
--dry-runは残高確認を行いません。生成前に最小限のチャット呼び出しで確認してください（InsufficientBalanceErrorが発生したら停止し、ユーザーにチャージを依頼——注意：MiniMax ビデオは「オープンプラットフォーム残高」のみ認識し、トークンパッケージの金額はビデオに使用できません）。 - 生成：
python -X utf8 scripts/run_pipeline.py --series X [--to-episode N] [--with-bgm] - 検収：品質ゲート（内蔵）通過後、
series/<シリーズ名>/episodes/epXXX.mp4完成品とseries/<シリーズ名>/.usage.json（コスト明細）を確認。
品質ゲート（内蔵、不合格で自動中止）
各エピソード生成後に自動で verify を実行：
- クリップのmd5がすべて異なる（重複クリップ事故を直接防止）
- 完成品にビデオストリーム＋オーディオストリームがあり、再生時間 ≥10秒
- スクリプトに hook_line（最初のフレームに重ねる文字フック）＋シーン時間が不均一（メトロノーム的でない）
品質ゲート不合格＝状態を更新しない、次のエピソードを生成しない、次のエピソードの費用を消費しない。修正後 --force-episode N でリラン。
続編メカニズム（手動で状態ファイルを変更しない）
- キャラクター/世界観/伏線/要約は
series/<シリーズ名>/state.jsonに保存 - 各エピソード：LLM が状態を読み取る→スクリプト生成→完了後状態を書き戻し（要約/伏線の追加削除/キャラクター状態）
- あるエピソードをリランする場合は必ず
--force-episode Nを使用（状態のアトミックロールバック＋生成物クリーンアップ）。手動でのファイル削除は禁止 - 新しいキャラクター：
assets/characters/に定められた写真（正面/半身/無地背景）を配置し、state.json に登録
完全な詳細
references/api-reference.md— すべての実測APIパラメータ（「最適化」しないこと）references/pitfall-log.md— 事故→根本原因→防御策（問題発生時に最初に確認）references/quality-gates.md— 品質ゲートとセルフチェックのチェック項目説明references/content-quality.md— 五幕構成/フック構文/定着率の原則assets/state.schema.json— state.json の JSON Schemaassets/series-template.json— 新シリーズ初期化テンプレート