workflow-creation

ワークフローの作成

目的

PostPlus ワークフロープラットフォーム上で、UGC スタイルのマルチクリップ動画生成のための信頼性の高い動画制作ワークフローを 1 つ設計します。ユーザーに提示する成果物は、ユーザーのアカウント上に作成された名前付きワークフローであり、保存された定義バージョンを備え、見積もりと起動が可能な状態になっています。ユーザーが明示的に求めない限り、単体の定義ファイル、エクスポートされた JSON グラフ、監査パケット、ポストプロダクションのメモを作成しないでください。

品質チェックは内部で行います。ユーザーに QA を実行するかどうかを尋ねないでください。尋ねるのは、不足しているブランド、製品、参考情報、ワークフローの目標、命名、または主張の境界に関する事実がワークフローを変える場合だけにしてください。

プラットフォームのツールサーフェス

ワークフローのオーサリングは、サーバーで検証される 1 つの機能であり、2 つの入り口があります。現在のセッションで公開されている方を使用してください。決して混在させず、サーバー検証を決して回避しないでください:

• ワークスペースアシスタントの型付きツール: workflow_read（action=list で名前から解決し、get でノード/スロット/バージョンを検査し、runs_get で実行を読み取ります）、workflow_author（空のワークフローまたはテンプレートをシードしたワークフローを create します。propose_edit は構造編集 - add_node / update_node / remove_node / connect_nodes - を行い、永続化せずに正直な検証結果を返します）、apply_workflow_edit_to_canvas（ユーザーのライブキャンバスが接続されている場合の同じ操作）、save_workflow_version（提案を永続化します。常に人間の承認が必要です）、続いて quote_workflow_run と launch_workflow_run。
• CLI エージェントの postplus workflow コマンド - 同じ動詞で、結果は JSON、ログイン済みセッション（postplus auth login）が必要です: postplus workflow list / show と runs / run-show（読み取り）、create、propose（= propose_edit: プレビュー + 検証、何も永続化しません）、save（= save_workflow_version: 新しい不変バージョンを永続化します）、quote、launch。構造編集は、同じ add_node / update_node / remove_node / connect_nodes オペレーションの --operations JSON 配列に指定します。正確なフラグは postplus workflow help を実行してください。

2 つのサーフェスは、同じホスト型の動詞と 同じ検証に 1 対 1 で対応します。propose は propose_edit に、save は save_workflow_version に、quote は quote_workflow_run に、launch は launch_workflow_run にそれぞれ対応します。

境界:

• ID は推測せず解決してください。名前の一致が曖昧な場合は、候補としてユーザーに返してください。
• 完全な定義ドキュメントを手書きしないでください。create と編集オペレーションを通じて構造を構築し、サーバーに検証させてください。validation.ok=false の場合は、リストされたエラーを修正して再提案してください。サーバーが暗黙的に修復することはありません。
• 永続化は人間の承認がある場合のみ行い（save_workflow_version / postplus workflow save）、ユーザーの明示的な承認なしに起動しないでください - まず見積もりを行い、予約される PostPlus クレジットを報告し、CLI では見積もられた reservedCredits を --max-reserved-credits として --confirm とともに渡してください（launch は両方が揃わない限り実行を拒否します）。
• 現在のセッションでどちらのサーフェスも利用できない場合（ワークスペースアシスタントのツールもなく、ログイン済み CLI もない場合）、定義や代替のファイル形式を捏造しないでください。ワークフローのオーサリングには PostPlus ワークスペースアシスタントまたはログイン済みの postplus CLI が必要であると伝え、単発のレンダリングリクエストは video-batch-runner にルーティングしてください。

ワークフロー形状のデフォルト

• ワークフローはノードキャンバスです。生成動画ノード（各1クリップ、それぞれがモデル向けプロンプトと、ノード設定内の duration / aspect ratio / resolution / audio の各ノブを保持）と、順序付きクリップ入力スロットを持つ任意の単一アセンブリノードで構成されます。
• アセンブリノードがある場合、すべての生成動画ノードはアセンブリのスロットに接続する必要があり、スロットの順序がカット順序になります。アセンブリノードがない場合、各ノードは独立したクリップを出力します。
• パッシブな参照素材（クリエイター画像、商品画像、音声サンプル）は、プロンプトから <<<label>>> で参照されるラベル付きワークフローアセットとしてバインドされます。スクリプトテキストはアセットノードとして入力できます。アセットは実行されません。
• ノブの値は、ノードで選択された生成ケイパビリティから取得されます。キャンバスの検証と起動ゲートが正式な判断基準です。一般的な UGC のデフォルトは 9:16、720p、1クリップあたり 4-15 秒、音声生成オンです。
• 複数バージョンの出力 = ノードを複製するのではなく、複数のインスタンスを起動することです。ユーザーが名前を指定しない限り、ワークフローには {case-or-brand}-{script-feature}-{duration}s-v{version} という名前を付けます。

デシジョンルーター

最初に一致したルートを適用します。

もし	ならば
ユーザーがワークフローのレビュー、監査、QA、検証、承認、または検査を求めた場合	L2 を実行
センシティブな主張、正確な保持、事実の矛盾、レンダリング出力の失敗、またはバッチ作業	L2 を実行
ユーザーが先にロジック／カット設計のレビューを求めた場合、または複雑なナラティブ広告にアンロックされたフック、ペインビート、製品登場、証明／価値ビート、CTA、またはポストプロダクションの境界がある場合	構築前に短いカットプランを返して承認を得る
ユーザーがスクリプト、人物图、商品图、参照素材、またはクリップごとの参照を提供または要求した場合	Script-Locked Asset Mode を使用
表示される製品に商品画像がない場合	デフォルトで確認する。明示的に許可された場合のみ商品画像を生成する
不足している事実が主張、参照、ワークフローの動作、または命名を変える可能性がある場合	必要最小限の質問をする
それ以外	通常モード: references/prompt-quality.md を読み、クリッププロンプトを作成し、workflow_author で構築し、L0/L1 を実行

三者審判フレーム

すべてのワークフローを3つのレンズで審判します。以下のルールはこれらの判断にのみ資するものです。

• 広告主の審判: 製品の外観、主張、使用方法、参照、およびコンプライアンスの境界が、広告主が信頼するタスクローカルの事実と一致していること。
• 視聴者の審判: クリップが信じられる人間の瞬間から始まり、注意を保持し、自然な CTA で着地すること - 機能の発表ではなく。
• 生成器の審判: 下流のモデルが、具体的で目に見える詳細、明確な参照の責務、分離されたクリップスコープ、ポジティブなシーン構築によって、プロンプトを文字どおりに実行できること。

サイドカーガードレールの原則

ガードレールは診断し、プロンプトはコンパイルします。ビジネス経験に基づくガードレールはサイドカーの監査チェックであり、モデル向けのプロンプト言語ではありません。それらを使ってリスク（静的なペーシング、音声の空白、空間的なドリフト、エンティティの漏洩）を特定し、真実を保持する最小限の修復をポジティブなシーンの担い手に変換します。すなわち、アクション、音源、移動経路、小道具の扱い、カメラの挙動、または発話されたセリフです。ガードレールのカテゴリ、監査の根拠、禁止用語の壁を生成プロンプトに貼り付けないでください。

ワークフロー優先の契約

1. ロックするのは必要なコンテキストのみです。ユーザーの意図、製品の事実、主張の制限、参照、尺、保持すべき正確なフック/VO、および明示された除外事項です。ギャップがナレティブの論理にある場合は、まずコンパクトなカットプラン（フック、痛点のビート、製品の登場、証明/価値のビート、CTA、ポストプロダクションの境界）をロックします。
2. references/prompt-quality.md を読んだ後にプロンプトを作成します。do not/no/avoid/不要 はポジティブなシーンキャリアに解決し、すべての参照をジョブ、スコープ、境界に結び付けます。尺、アスペクト比、解像度、音声生成はノード設定に属し、プロンプトテキストとして再記述してはいけません。
3. workflow_author（または postplus workflow create / propose）を通じてビルドします。作成（ブランクまたはテンプレート）後、編集操作でノード/エッジ/設定の構造を提案します。
4. 返された判定と内部品質ゲートでバリデーションします。真実を保持する問題は直接修正し、主張や動作を変えてしまう事実の欠落がある場合にのみブロックします。
5. 人間の承認があった場合にのみ永続化と起動を行います。save_workflow_version（または postplus workflow save）、次に quote_workflow_run（または postplus workflow quote）を実行し、予約された PostPlus クレジットを報告し、明示的な承認後に launch_workflow_run（または postplus workflow launch ... --confirm）を実行します。見積もりの reservedCredits を --max-reserved-credits として渡し、正確なワークフロー名を --title として渡します。
6. ハンドオフでは、ワークフロー名と ID、保存されたバージョン、バリデーションステータス、見積もり/起動ステータス、および重要なブロッカーや残存リスクを伝えます。実行は非同期で人間のレビューゲートがあるため、状態とワークフローページのリンクを報告してください。実行が完了するまでポーリングしないでください。

スクリプトロック資産モード

ユーザーが先にスクリプトを計画している場合、人物图 / product 图 / 参照画像に言及した場合、クリエイター画像なしで製品画像を提供した場合、またはクリップごとの参照を希望する場合にトリガーされます。グラフ構築の前にスクリプト（フック、セリフ、CTA、総尺、製品アクション、主張の制限）をロックし、creator_identity、product_reference、voice_reference、style_reference をラベル付き資産としてロックし、尺、ビート、製品の登場、シーン参照のニーズを含めてクリップを計画します。グラフ creator identity image -> per-clip scene image -> per-clip generation video -> assembly を優先してください。このモードがトリガーされた場合にのみ references/asset-locked-workflow.md を読み、そのビルド順序に従ってください。

プロンプト契約

モデル向けの生成指示のみを記述し、内部制約、シーンキャリア、最終モデルプロンプトは別々のレイヤーとして保ちます。すべての生成ノードプロンプトには、ジョブ/スコープ/境界を含む参照バインディング、実際のハンドヘルド UGC スタイルと設定、1 つの発話姿勢（on-camera spoken / voiceover / silent）、具体的なアクションとカット境界の発話テキストを含むタイムスタンプ付きカット、音声ルール、不要な UI/テキスト/ロゴに対するポジティブな置き換えを含む視覚的制約が必要です。主張はタスクローカルの事実の範囲内に保ち、クリップ参照は分離し、発話密度（通常 2.4-2.8 語/秒、yapping は要求時のみ 3.0-3.8、信頼性が重要な場合は 2.2-2.6）を尺のルールとして使用し、高密度のブリーフでは 1-2s ごとに新しいビートを要求します。すべてのカットは、1 人のもっともらしいカメラオペレーターが物理的に実行できるものでなければなりません。完全なドクトリン、例、カメラ文法は references/prompt-quality.md にあります。

ユーザーが外部音楽、後からのサウンドデザイン、またはサイレントワークフローを希望する場合は、ノードの音声生成をオフにし、プロンプトから発話ダイアログと音声参照を削除してください。

内部品質ゲート

L0 ハードチェック（常時、propose 結果と workflow_read get から）: 検証判定がクリーンであること。アセンブリノードがある場合、すべての生成ノードが順序付けられたスロットに供給していること。すべての生成ノードに意図されたプロンプト + 尺 / アスペクト比 / 解像度 / 音声設定および参照バインディングがあること。名前に埋め込まれた尺が合計クリップ尺と一致すること。プロンプトにポストプロダクションの漏れ、ネガティブ合成の言い回し、またはサポートされていない医療/法律/保証に関する主張が含まれていないこと。スキャンのヒットはシグナルとして扱い、起動可能性、事実性、または生成品質に影響するものだけを修正してください。

L1 セルフレビュー（ハンドオフ前のデフォルト）: 真実性 - 最新の意図と制約が保持され、発明されたエンティティ、機能、主張、UI がないこと。視聴可能性 - 最初の 0-5s が視聴者の疑問を生み出すこと。製品の登場が信憑性があること。ペイオフと CTA が自然に読めること。実行可能性 - プロンプトがモデル向けのままであること。参照が明示的な責務とともに分離されていること。ネガティブがポジティブなキャリアにコンパイルされていること。カットが物理的に妥当であること。真実性を保つ小さな修正を適用し、L0 を再実行してください。

L2 ディープレビュー（自動トリガー、決して尋ねない）: 機密性の高い主張、正確な保持の要件、propose/validate ループ外で行われた編集、L0 の矛盾シグナル、矛盾する事実または参照、バッチ作業、人物/製品/設定/ストーリーの 30 秒以上のマルチクリップ連続性、複数エリアのシーントポロジー、報告されたレンダリング出力の問題、または明示的なレビュー依頼。workflow_read get で完全な定義を読み、次に references/ugc-workflow-audit-rubric.md を読んでください。リズム/音声/空間/漏れのトリガーには references/ugc-sidecar-guardrails.md を追加し、sidecar の検出結果が事実、製品、コンプライアンス、または参照バインディングの問題を露呈しない限り、それらを診断として扱ってください。アセンブルされた動画については、アイデンティティ、小道具、場所、対話の流れ、ポストプロダクションの漏れのクリップ間連続性をレビューしてください。独立したレビューが役立つ場合は、ワークフローごとに新しいレビューコンテキストを使用してください。レビュアーはレビューのみを行い、親が propose/apply 操作を通じて編集を所有します。パス、ブロッカー、または 3 回のレビュー・リビジョンサイクルの後に停止してください。欠落した事実が主張を変える場合にのみ、ブロックして最小限の質問をしてください。

コストと起動の規律

起動には実際のクレジットを消費します。常に最初に見積もりを提示し、予約された PostPlus クレジットを報告し、ユーザーの明示的な承認なしに決して起動しないでください。CLI では、postplus workflow launch は --confirm と承認された --max-reserved-credits 上限なしでは実行を拒否します。サーバーは再見積もりを行い、新たな予約がそれを超える場合は中止するため、確認されたコスト上限は拘束力を持ち続けます。実行は人間のレビューゲート（クリップごとの承認、最終レビュー）で一時停止します。ポーリングループに留まるのではなく、実行状態とワークフローページのリンクを報告してください。

ハンドオフ

ワークフロー名と ID、保存されたバージョン番号、検証ステータス、予約クレジットを含む見積もりまたは起動ステータス、およびブロックされた事実または意味のある残存リスクを報告してください。ユーザーが求めない限り、内部 QA ステップ、レビューサイクル、または監査の根拠を開示しないでください。