creative-qa

クリエイティブ QA

使用する場合

• 生成された画像、ボイステイク、動画レンダー、最終エクスポートに対する human-in-the-loop の品質判断を記録します。
• 人がアセットをレビューした後に、構造化された判定、理由、問題カテゴリ、責任ステージ、提案アクション、再実行ガイダンスが必要な場合に使用します。

使用しない場合

• 人の判定がまだ存在しない場合。
• ユーザーが自律的な AI 承認を求めている場合。
• 生成前のプロンプト批評がタスクである場合。代わりに preflight またはプロンプト QA を使用してください。

必須入力

• 人間のレビュアーによる判定と理由。
• 対象オブジェクトの種類、ID、バージョン。
• レビュアーとレビューのタイムスタンプ。
• 提案アクション。

人間のルール

品質を決めるのは人間です。AI はメモの要約、カテゴリの正規化、責任ステージの候補提示を行うことはできますが、人間が確認したフィードバックのみが永続的な QA レコードになります。

承認、却下、レビュアーの意図を捏造しないでください。

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

1. レビュー対象のアセットを確認します: 種類、ID、バージョン、および任意でキャンペーン/ペルソナ/コンセプトとの関連付け。
2. 人間のレビュアー、タイムスタンプ、判定、理由を確認します。
3. 理由を goodReasons、badReasons、問題カテゴリ、責任ステージに正規化します。
4. 提案アクションを決定します: 承認、特定ステージの再実行、ソース入力の修正、または却下。
5. 再実行ガイダンスが存在する場合は、具体的な rerunTarget を含むフィードバックハンドオフを構築します。
6. 構造化された QA レコードを、レビュー対象オブジェクトの隣、または作業フォルダの QA エリアに保存または返却します。

対応オブジェクト

• image
• voice_take
• video_render
• final_export

判定

有効な判定は approved、revise、reject です。

revise または reject の場合、空でない badReasons と issueCategories が必要です。approved の場合、これらは空の配列でもかまいません。

カテゴリ

一般的な問題カテゴリ:

• lip_sync、persona_drift、audio_style、audio_pacing、hook_weak、ad_like、ugc_native_feel、visual_realism、subtitle_accuracy、mixed

一般的な責任ステージ:

• image、script、voice、render、subtitle、mixed

責任ステージは診断ガイダンスとして使用し、人間の判定の代用にはしないでください。

停止条件

• 必要なユーザー意図、ソース証拠、または所有する入力アーティファクトが欠けており、 推測すると結果が変わる場合は停止します。
• 所有する CLI またはスクリプトコマンドが、実行中の PostPlus スキルで許容される範囲の リカバリを行ってもなお失敗する場合は、正確なエラーを報告して停止します。メタデータのみの回答、レディネスプロービング、ローカル ペイロードの書き換え、フォールバックプロバイダー、未公開ツールで失敗を回避しないでください。

出力形式

qaReport:

• qaReportId、targetObjectType、targetObjectId、targetVersion、campaignId、personaId、conceptId、reviewer、reviewedAt、verdict、goodReasons、badReasons、issueCategories、blameStage、scores、proposedAction、status

任意の feedbackHandoff:

• feedbackId、qaReportId、targetObjectType、targetObjectId、feedbackCategory、feedbackText、dependencyImpact、rerunTarget

アンチパターン

• アセットを黙って承認する
• 人間の判定を AI の推測で置き換える
• 曖昧なステージラベルを再実行ターゲットとして使用する
• レビュー対象オブジェクトのバージョンとの関連付けを失う
• 主観的なチャットメモを構造化された理由なしに保持する

ハンドオフ

• 構造化された QA レコードを構造化出力として返すか、明示的なブロッカーを返します。フィードバックが存在する場合は、QA レコードを添付して、指定された再実行ターゲットにハンドオフします。

公開コマンドの境界

• ユーザー入力から最小の一致するコマンドまたはワークフローを選択し、直接 実行します。
• 所有する CLI またはスクリプトコマンドが、実行中の PostPlus スキルで許容される範囲の リカバリを行ってもなお失敗する場合は、正確なエラーを報告して停止します。メタデータのみの回答、レディネスプロービング、ローカル ペイロードの書き換え、フォールバックプロバイダー、未公開ツールで失敗を回避しないでください。