Communitygithub.com

UGCレンダリングレビューゲート

生成されたUGC動画のレンダリング結果の音声と承認済み台本をWhisperで照合し、単語レベルの差分をチェックする必須の事前公開レビューゲートです。

UGCレンダリングレビューゲート とは?

このスキルは、UGC(ユーザー生成コンテンツ)動画のレンダリング結果を公開前に自動チェックするための必須の品質ゲートです。Seedanceなどの音声生成エンジンが時々引き起こす「単語の誤読」(例:'human‑vetted'が'human witted'と発音される)を検出し、誤った発音を含むレンダリングが公開されるのを防ぎます。 具体的には、レンダリングされた動画の音声をWhisper(OpenAI APIまたはローカルCLI)で文字起こしし、事前に保存された承認済み台本と単語レベルの差分を計算します。差分がある場合(exit 2)は公開をブロックし、問題箇所と修正方法(例:シードの再生成、音声の再レンダリング)をレポートします。 このスキルはClaude Codeや同様のAIエージェント環境で動作し、`remix-ugc-*-from-sample`や`create-ugc-*-video-from-refs`などのレシピの中で、レンダリング後かつ`set_final_render`の前のQCフェーズで実行されるように設計されています。 より大規模なcontent-gooseのレビューエンジンの中から、特に「音声と台本の整合性」に特化した切り出し版であり、単一ファイルで完結しているため軽量かつ確定的に動作します。環境変数`OPENAI_API_KEY`が設定されていればOpenAI経由で、なければローカルWhisperCLIを利用して文字起こしを行い、`ffmpeg`がPATHに存在する必要があります。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/gooseworks-ai/goose-skills/tree/HEAD/skills/ads/packs/ugc-video-formats/review-ugc-render

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

review-ugc-render

すべてのUGC動画レシピが公開前に必ず通過しなければならないQCゲート。目視による/watchではなく、決定論的な文字起こし対台本の差分チェックであり、欠陥があれば非ゼロ終了コードを返してレシピがset_final_renderをハードストップできるようにする。

なぜこれが必要か

Seedance は音声をネイティブに生成する。しかし、単語を誤読することがある——承認された台本の human-vetted が human witted と発音されたり、他にも Hume→Hune、Alitu→al-too といった事例が確認されている。この欠陥はレンダリングの音声に存在するため、目視の /watch(「台本通りに聞こえる」)では見逃されてしまい、後続のキャプションパスで誤った単語がそのまま焼き込まれてしまう。これまでは、実際に発音された音声とユーザーが承認した台本を比較する仕組みがなかった。

このゲートはまさにそれを決定論的に実行し、不一致があれば公開を拒否する。

実行タイミング

  • 必須: remix-ugc-*-from-sample および create-ugc-*-video-from-refs のすべてのレシピで、QCフェーズのマスターレンダリング作成後かつset_final_renderの前に実行する。
  • 修正/再レンダリングのたびに、PASSするまで再実行する。

契約

レンダリング前に、承認された正確な発話内容(ビートノートなどは含めず、そのままの発話)を working/approved-script.txt に保存する。その後、レンダリング後に以下を実行:

python3 <pack>/review-ugc-render/scripts/review_render.py \
  --video working/final.mp4 \
  --script-file working/approved-script.txt \
  --json working/review-verdict.json
  • exit 0 → PASS — 公開に進む(set_final_render)。
  • exit 2 → FAIL — 公開しない。レポートを読み、修正して再実行。
  • exit 3 → ERROR — チェックを実行できなかった(下記参照)。環境を修正し、盲目的に公開しない。

文字起こしバックエンド(優先順): OPENAI_API_KEY(OPENAI_BASE_URL を尊重するため、gooseworks Whisper プロキシが設定されている場合はそれを経由)→ ローカル whisper CLI。ffmpeg が PATH に含まれている必要がある。

FAIL の意味と修正方法

レポート行根本原因修正方法
[high] said [witted] where script has [vetted]Seedance が生成音声で単語を誤読した新しいシードで再生成。 ブランド名や造語の場合は、SPOKEN LINE で発音的にスペルする(例: Ali-too、(pronounced ...) のような括弧書きは絶対に使わない——Seedance は括弧書きをそのまま読み上げる)。create-video-seedance-2-fal の障害モードを参照。
[medium] dropped [...] / 類似度が低いSeedance が承認されたフレーズを飛ばした再生成。末尾の単語のみであれば、stitch_replacement.py で局所的に修正できる可能性がある。
⚠ audio is effectively silent間違ったレンダリング / ポストプロダクションで音声トラックが失われた再レンダリング / マルチプレクスを再確認。無音のテイクを公開してはならない。
ERROR: no transcription backendOPENAI_API_KEY もローカル whisper もないキー(プロキシ OPENAI_BASE_URL)を設定するか、whisper をインストールして再実行。

--expect-music は助言のみ(音楽がなければ警告を出す)であり、それ自体でゲートを失敗させることはない。

入力

  • --video PATH(必須)— レンダリングされたマスターmp4。
  • --script-file PATH または --script "text" — 承認された発話台本。スクリプトのないクリップ(ドリフトチェックはスキップされ、ゲートは助言のみとなる)の場合のみ両方を省略できる。
  • --min-ratio FLOAT(デフォルト 0.90)— 文字起こしと台本のトークン類似度の合格ライン。
  • --json PATH — アプリのレビューパネル向けの機械判定結果を書き込む。

テスト

python3 tests/test_review_render.py    # 純粋な判定ロジック。音声/ネットワーク不要

代表的な vetted→witted 誤読、ブランド名の誤読、末尾脱落、無害なフィラー、スクリプトレス助言パスをカバーする。

content-goose レビューエンジンとの関係

これは、より本格的な coworkers/video/molecules/review/review-loop(18軸評価ルーブリック)の、単一ファイルで切り出されたゲート版である。ここでは、公開時に音声と台本の欠陥を捉える1軸(review-transcript-integrity / brand_text_accuracy)を強制する。より深い多軸レビューは content-goose ラボに残されている。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

gooseworks-ai/goose-skills

Burned-in captions for a finished vertical video, three kinds. transcribe.py gets word timings from the video's own audio through the GooseWorks proxy (fal Whisper, bills the Ads agent, cents); captions.py burns one to three words at a time with Pillow + ffmpeg (no libass needed), either pinned to a split-screen seam (plate 25% above / 75% below) or at a fixed height, in a plate, outline or one-word serif style, with an optional red hook card; plates.py burns per-beat caption blocks (black, one union silhouette, placed in the emptiest band) for formats with no voice. The last caption (the CTA) holds to the final frame. Use as the last step of any video ad.

gooseworks-ai/goose-skills

Assemble a cartoon / animated / hand-crafted music-video ad from a config — a sung song carries the whole narrative while N per-bar i2v clips (one recurring animated character, one look pack) are each cut to their BAR window from librosa beat-tracking and hard-concatenated on the bar, VEED-whisper white bold-sans captions in the BOTTOM third (Alignment 2, above the logo bug, no pill) burned from the song's word timings re-spelled against the locked lyrics, a persistent brand logo bug held over the body (suppressed on the end card), and closed on a solid-brand-color PIL end card with the song still playing under it — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-bar + hard concat + logo bug + captions + end card + song mux); the song, character, keyframes, and clips come from create-music-elevenlabs / create-image-fal / create-video-fal. Use for the cartoon-music-video format.

gooseworks-ai/goose-skills

Assemble a cinematic live-action-style music-video ad from a config — an original sung anthem carries the whole narrative while N 35mm-film-look i2v clips are each cut to their lyric window and hard-concatenated on the beat as a 3-act arc, the anthem muxed at loudnorm I=-14, cinematic lower-third serif captions built from the song's OWN word timings (never Whisper) with the hook line landing on the chorus drop, and closed on a brand end card composited from the real asset — never AI-rendered text. This is the FREE deterministic assembly stage (cut-to-window + hard concat + anthem mux + captions + end card); the anthem, keyframes, and clips come from create-music-elevenlabs / create-image-gpt-image-fal / create-video-fal. Use for the cinematic-music-video format.

gooseworks-ai/goose-skills

Assemble an editorial-motion podcast-clip ad from a config — a real clipped podcast MP3 carries the narrative while N flat limited-palette editorial-illustration keyframes (one look pack) are animated NOT by generative i2v but by DETERMINISTIC ffmpeg ken-burns (zoompan) + hard cuts (no crossfades, which expose geometric drift), each beat snapped to its spoken line, the real audio muxed, Whisper-driven captions burned only mid-sentence, and closed on a PIL brand end card — never AI-rendered text. This is the FREE deterministic assembly stage (ffmpeg ken-burns + hard concat + audio mux + captions + end card); the real audio is clipped from source and the keyframes come from create-image-fal. Use for the editorial-motion-podcast format.

gooseworks-ai/goose-skills

Analyze the message match between your ads and landing pages. Checks if the promise in the ad copy carries through to the landing page headline, body, and CTA. Flags disconnects that kill conversion rates. Works with Google, Meta, and LinkedIn ads.

gooseworks-ai/goose-skills

Generate a single 4-15s vertical video clip with ByteDance Seedance 2.0 reference-to-video via fal.ai. Multi-image reference (avatar + product + setting), native lip-synced VO + ambient audio (generate-audio on by default), internal multi-cut handling within one render. Routes through the GooseWorks FAL proxy (bills the Ads agent). The default clip atom for AI-creator UGC ads built on the NB2 + Seedance architecture. Validated on beauty-by-earth/video-01.

gooseworks-ai/goose-skills

Render pixel-accurate Apple Notes (iPhone, light mode) screenshot mockups from a JSON note spec. Outputs HTML + PNG at the iPhone 16/15 Pro native 1180×2556. Supports paragraphs, images, checklists, dividers, autocorrect underline, smart quotes, and an optional iOS keyboard chrome overlay used by the parent video-ad molecule.

gooseworks-ai/goose-skills

Extract competitor and customer intelligence from any company's landing page HTML. Discovers tech stack, analytics tools, ad pixels, customer logos, SEO metadata, CTAs, hidden elements, and more. No API keys required.

gooseworks-ai/goose-skills

Find speakers, hosts, and guest profiles at conferences and events on Luma. Two modes - free direct scrape for hosts, or Apify-powered search for full guest profiles with LinkedIn/Twitter/bio.

gooseworks-ai/goose-skills

Find Twitter/X influencers to promote a product or brand. Use when asked to find influencers, discover Twitter accounts for partnerships, identify creators in a niche, or build an influencer outreach list.

関連スキル