Asset QA は何をしますか？
アップロード前にAI生成結果をチェックし、そのまま貼り付け可能な修正プロンプトを作成します。最良のチェックは、ご自身の目（画像を直接読む）とスクリプト（目では見えない数値：パレット外の色の割合、安全圏に対するテキスト位置、コントラスト、フレーム間のジャンプ）を組み合わせることです。
ワークフロー
- 入力を受け取る: 画像・動画の成果物、目的のフォーマット（story, reels, feed, square, og, wide, pinterest;
python scripts/qa_image.py --formats）、ブランド（profile.jsonまたは--colorsからのカラーパレット）、期待されるテキスト（正確な文のリスト）、および参照用のロゴ/キャラクター画像（ある場合）。フォーマットが指定されていない場合は、画像のアスペクト比から推測し、その仮定を明記します。 - まずは目で確認する。 画像（または動画のコンタクトシート）を開き、テキストを自分で読みます。各単語のスペルミス、ロゴ、キャラクター、指・体の部位の数、不自然な物体、意味不明なテキスト、端の切れを記録します。OCRは補助的なものです（英語、装飾フォントは誤認識が多いため）ので、目視確認は常にOCRより優先されます。
- スクリプトを実行する。
- 画像:
python scripts/qa_image.py hasil.png --format story --profile profile.json --expect "文1|文2" - 動画:
python scripts/qa_video.py klip.mp4 --format reels --profile profile.json --expect-duration 24（または--colors "色名=#HEX,..."）その後contact.jpgとマークされたフレームを確認します。 - ロゴ/キャラクター:
python scripts/logo_compare.py acuan.png hasil.png [--crop x0,y0,x1,y1]; 高いスコアは確実な証拠ですが、単純なフラットロゴで低いスコアが出ても異なるとは限らないので、並べて比較します。
- 画像:
- レポートを作成する 表形式で: 検査項目 | 結果（合格/修正必要） | 所見 | 修正方法。最も重大なもの（スペルミス、ロゴ/キャラクター、UIで隠れるテキスト）から、軽微なもの（見た目の問題）の順に並べます。実際に検査していない項目については「合格」と報告せず、データがない場合は「未検査」と記載します。
- 修正プロンプトを作成する:
issues.jsonに記入後、python scripts/fixprompts.py issues.json fix.mdを実行します（タイプ: spelling, palette, logo, character, safe_zone, small_text, contrast, extra_text, ratio, anatomy, video_text, video_glitch）。プロンプトは問題ごとに1つ; ChatGPTやFlowは一度に一つずつ変更する方が安定します。優先順位と戦略についてはreferences/qa-checklist.mdを参照してください。 - 成果物を提出する: 返信には簡潔なレポートを、修正プロンプトはコードブロック内に（1～3個まではそのまま返信に、それ以上は
.mdファイルにしてpresent_filesで提出）。最終判断を明記します: アップロード可能 / 先に修正 / 再生成。
判断ルール
- アップロード可能: スペルミスなし、ロゴ・キャラクターが一致、UIで隠れるテキストなし、色がパレット内。
- 先に修正: 局所的な問題が1つまたは2つ（スペルミス、1色のずれ、位置の問題）。
- 再生成: キャラクター・ロゴが全体的に変わっている、形状が壊れている、または複数の問題が同時に発生; より厳密なプロンプトで再生成した方が早い。
- 動画内のテキスト: 動画からテキストを削除し、CapCut/Canvaで追加することを推奨; AI動画内のテキストは安定しないことが多い。
正直に伝えるべき限界
- OCRはすべてのフォントを認識できるわけではありません。装飾フォントで「見つからない」と出ても必ずしも間違いとは限らず、OCRで正しく読めたテキストも目で確認する必要があります。
- パレットチェックは平均色差を使用します。照明やグラデーションにより色が多少ずれるのは正常です。
- 安全圏は一般的な目安です。アプリの表示は変わるため、最初に1つの投稿でテストしてください。
- スクリプトは美しさやメッセージの適合性を評価しません。それはあなたの判断です。
ファイル
scripts/qa_image.py- アスペクト比、パレット、OCR、安全圏、テキストサイズとコントラスト、--expectに対するスペルチェックscripts/qa_video.py- 技術情報、フレーム、コンタクトシート、ジャンプ、色ずれ、音声、尺scripts/logo_compare.py- ロゴ/キャラクターの参照画像との比較scripts/fixprompts.py- そのまま貼り付け可能な修正プロンプトの生成references/qa-checklist.md- チェックリストと修正戦略