voice-batch-runner

Voice Batch Runner

使用する場合

• ペルソナ、コンセプト、スクリプトの入力がすでに存在し、次のステップがホスト型の 音声デザイン、クローン音声テイクの生成、またはポーリングである場合。
• 音声が、単発の音声副産物ではなく、スクリプトをまたいで持続するペルソナ資産として 維持されるべきである場合。

使用しない場合

• タスクがアイデア出し、QA、または引き継ぎセクションに記載された別のリリース済み スキルに属する場合。
• 必須の入力が欠けており、推測すると結果が変わってしまう場合。
• 音声戦略、タスククラス、翻訳ポリシー、またはリップシンクの意図がまだ 未解決である場合。まず audio-generation を使用してください。

実行境界

• このランナーは、正規化された音声リクエストを検証して実行します。創造的な戦略、 音声ポリシー、または参照ポリシーの決定を行ってはなりません。
• ワークフローを音声プロファイル、オプションの音声アイデンティティ、および具体的な 音声テイクに分離します。スクリプトのテキストは変更できますが、ペルソナ音声の 継続性は変更すべきではありません。
• 音声デザインは、text、voice_description、および language から、 ペルソナに沿った初期のサウンドを得るためのものです。
• 音声クローンは、承認された参照 audio とオプションの reference_text によって 音色と話し方を保持すべき場合に、新しいスクリプトテイクを得るためのものです。

ソースとパス

• リクエストを、アクティブなプロジェクトのペルソナレジストリ、音声ベースライン、 スクリプトテキスト、および動画の目的/レーンに基づかせます。
• まずアクティブなプロジェクト/クライアントフォルダーを使用します。あるクライアント ディレクトリがすべての音声作業のソースベースであると想定しないでください。
• 内部のリクエスト/レスポンス/実行状態は、ユーザー向けの引き継ぎでない場合は .postplus の下に保持します。最終的な音声およびレビューファイルは、アクティブな 音声アセットフォルダーに保持するか、選択したワークスペースパスを明記してください。

リクエスト境界

• 音声デザインは、発話される text、自由記述の voice_description、および オプションの language（デフォルトは auto）から、ペルソナ音声を合成します。
• 音声クローンは、発話される text、audio 参照、オプションの reference_text トランスクリプト、およびオプションの language から、承認された音声を再現します。 ローカルパス、HTTPS URL、既存の PostPlus メディア参照、またはデータ URI を --audio に直接渡してください。CLI は、単一のホスト型送信の前にローカルメディアを 検証して準備します。事前にアップロードしたり、手動でリクエストを構築したりしないで ください。
• 正確なフィールド名、必須性、およびデフォルトは、postplus media schema --json および以下の生成された例から確認してください。ここにプライベートなリクエスト エンベロープをハードコードしないでください。

レビューと引き継ぎ

• 生成の前に、ペルソナレジストリ、音声ベースライン、スクリプトの安定性、 ルート（voice_design または voice_clone_take）、ソースの根拠、および出力パスを 確認します。
• 生成の後に、リアリズム、ペルソナへの適合、ペーシング、広告的なデリバリー、 再利用の可能性、およびクローン出力の場合は参照からの音色/アクセントのドリフトを レビューします。
• 保留中の場合、結果パスを保持し、同じ操作のために返された CLI アクションまたは 再開コマンドに従ってください。代替ジョブを送信しないでください。 CLI の待機/リカバリー境界で停止して報告してください。
• 完成したテイクは postplus media-file download で保存し、存在する場合は完了した 結果のアーティファクト参照を、そうでない場合はその出力 URL を使用します。

停止条件

• 必要なユーザー意図、ソースの証拠、または所有する入力成果物が欠けており、推測すると結果が変わる場合は停止します。

• バッチ分離: 独立した項目のバッチを生成する際、項目ごとのコンテンツ/安全性に関する拒否はその項目に限定されます。それは型付きコード postplus_cli_hosted_media_content_policy_blocked によってのみ識別され、エラーの文面の照合によって識別されることは決してなく、次のいずれかの境界で表面化します。型付きエラー code がそのコードである失敗した postplus media create、またはポーリング結果が output.data.status: failed と output.data.error.code にそのコードを伴う送信済み実行です。いずれの場合も、どの項目がブロックされたかとその正確な理由を記録し、その項目をスキップし、残りの項目の送信とポーリングを続行し、最後に不完全なセットを報告します。ブロックされた項目を再試行、緩和、または再送信しないでください — それは禁止されたペイロードの書き換えです。 その他のすべての失敗（型付き code がそのコンテンツポリシーコードではない、失敗した所有 CLI/スクリプトコマンド、または error.code がそのコンテンツポリシーコードではない実行 — 認証、転送、クォータ、不正なリクエスト、サービス停止）はシステム的です。上記のルールに従って停止します。

パブリックコマンド境界

• ユーザー入力から一致する最小のコマンドまたはワークフローを選択し、それを直接実行します。

• レディネス診断: postplus doctor --skill voice-batch-runner。

• 保留中のボイステイクをポーリング: postplus media poll --handle <output.data.id> は、それが返されたアクションである場合にのみ実行し、その待機/復旧の境界を尊重します。

• postplus media schema --json は、未知のリクエスト形状を構築または修復する場合にのみ使用します。

• 以下の生成されたコマンドでホストされた送信を実行します。別の実行インターフェースを使用しないでください。

postplus media create voice-design \
  --text "example text" \
  --voice-description "example voice_description" \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。フリーテキストのメッセージから復旧を推測しないでください。 要求された場合は明示的なユーザーの承認を待ちます。アクションは支出、公開、または上書きを承認するものではありません。 返されたチェックポイントまたはアクションを通じて同じ操作を再開します。不確実な作業を再送信したり、使い果たした復旧を繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしないでください。

• CLI が引用確認チャレンジを返した場合、postplus quote confirm --json --challenge-file <challenge.json> を実行する前にその範囲とコストについてユーザーの承認を得て、返されたトークンで再試行します。