edit-ad-promo
將客戶的優惠、產品與影片素材轉換為希伯來語的付費社群廣告,該廣告精確陳述優惠內容,以排名鉤子開場,能夠通過合規審查與授權審查,並以一系列基於同一主體的鉤子變體形式交付。在打磨細節之前,會先檢查優惠、聲明與授權。
凌駕於本文件其他部分的規則
- 優惠、價格與行動呼籲必須完全依照書面資料。 字串與數字來自客戶確認過的帳目;不得自行發明、四捨五入或「美化」;僅在真實情況下才能使用急迫性用語。若客戶未提供優惠:提出一個低門檻的優惠並詢問;絕不自行撰寫。
- 合規封鎖表是阻斷性的。 其 12 個主題每個都有狀態;若某一行為
fail或blocked,則無論評分標準為何,都會阻止草稿提交。標籤(AI 揭露、免責聲明)絕不能用於掩蓋欺騙性聲明。 - 授權:
License: unknown= 不在客戶或廣告工作中(決策預設 Q2:所有者較舊的「僅限原生貼文」是他對自己帳戶的風險態度,而非授權)。音樂與音效僅在該檔案自己的行允許該投放版位與地區用於廣告時方可使用。第三方品牌的聲音與標誌需要書面的品牌廣告許可。歌曲比對不等於授權;熱門音效未經許可。 - 沒有通用的鉤子法則。 沒有來源驗證過 3 秒門檻或固定的留存數字;鉤子應根據明確的理由進行排名,並由客戶自己的結果進行測試。
- 安全區域是內部預設值 v1(已標註日期,未經設備驗證;決策預設 Q5),通過需要實際檢視疊加層,而不僅是幾何形狀。
- 花費與隱私: 未經
paid-generation-gate(一份標註日期的估算與核准)不得進行付費生成;AI 鏡頭僅作為氛圍或補充素材使用,並需揭露;未經每個客戶的決定,不得將客戶素材上傳至雲端工具;snapshot --describe false。 - PROMPT.md 在撰寫第一行程式碼之前需經由人類核准,也適用於自主運行(決策預設 Q6)。技能是程序,而非許可;使用者與專案限制凌駕於本文件之上。絕不向其他 Claude 會話發送訊息。
輸入 -> 輸出
輸入:書面優惠(價格、條款、截止日、免責聲明)、行動呼籲渠道(按鈕、WhatsApp、代碼、地址)、平台與投放路徑(原生貼文、競價廣告、Spark)、長度(預設 15 + 30 秒)、產品與品牌素材、影片素材與同意書。輸出:hf/OFFER 帳目行(在 PROMPT.md 中)、hf/ad_gates.json(優惠呈現、鉤子、合規性、素材)、基於同一主體的 N 個鉤子變體 + 片尾卡、合規封鎖表、各檔案品質保證、命名格式 <name>_<platform>_<hook>_<aspect>.mp4 並附帶清單(multi-video-variants)。
流程
| # | 執行項目 | 產出成品 |
|---|---|---|
| 0 | 透過 video-intake 接收:優惠 + 條款 + 截止日、行動呼籲渠道、平台/投放路徑、長度、比例、鉤子(3 個)、客戶素材檢查清單(references/ad-blueprint-and-hooks.md)、同意書;參考廣告 -> 先執行 reference-style-transfer;ls 整個來源資料夾 | BRIEF + 帳目 |
| 1 | 優惠帳目:每個精確字串一行(希伯來語逐字、貨幣符號、截止日、行動呼籲),並指定必須出現的表面(旁白、圖層文字、片尾卡) | 帳目行 |
| 2 | 在腳本撰寫前,根據簡報建立合規封鎖表(references/compliance-table.md):聲明、價格條款、前/後比較、評論、個人屬性鉤子、健康/金融、品牌素材、AI 揭露、音樂授權、人物同意、虛假 UI、平台政策 | ad_gates.json 合規 |
| 3 | 腳本:三個排名鉤子及其理由,依長度劃分的節拍表(鉤子、問題、解決方案、證明、優惠、行動呼籲),優惠出現三次,15 秒與 30 秒版本;旁白轉錄用於紙上剪輯 | SCRIPT.md |
| 4 | 含安全區域疊加層的風格畫格:鉤子、價格標籤、前/後比較、片尾卡;每個素材附帶授權行(references/sound-and-licences.md);僅透過 paid-generation-gate 進行付費生成 | 風格畫格、SOURCES.md |
| 5 | PROMPT.md + DESIGN.md(每個畫面:內容、以像素為單位的座標、以幀為單位的時間、緩動效果、聲音)-> 人類核准 -> 建造:剪輯、圖形(價格徽章、UI 以程式碼重建,不使用素材庫)、字幕、調色、混音 | hf/ 專案 |
| 6 | 機械閘門:python scripts/ad_gate_check.py hf/ad_gates.json 與 python scripts/safe_zone_check.py elements.json --aspect 9x16 --overlay-evidence <viewed snapshot>;兩者均以 exit 0 退出 | 報告 |
| 7 | 驗證:render-qa-deliver(對最終檔案進行逐幀品質保證)、評分標準 A1-A8(references/rubric-and-benchmarks.md)、無聲測試、對整套作品進行一次評論;每輪僅一次完整渲染 | 品質保證證據 |
| 8 | 批次處理:基於共用混音的鉤子變體、nomusic / nocaps 版本、透過 multi-video-variants 處理其他比例(manifest_check.py exit 0) | final/ + 清單 |
| 9 | 呈現:一次提交所有檔案、編號的變更、合規封鎖表、帳目勾選、誠實的差距說明(未經設備測試的部分) | 訊息 |
閘門
狀態為 pass | fail | blocked | n/a,並附帶理由。逾時、空範例或缺少輸入為 blocked,絕非 pass。成功的工具呼叫是執行證據;實際檢視的渲染是外觀證據。
| 閘門 | 條件 | 證據 | 若為假 | 負責方 | 重新檢查時機 |
|---|---|---|---|---|---|
| G1 優惠精確 | 每條帳目字串/數字逐字出現在每個要求的表面上;畫面上沒有未列在帳目中的價格或百分比;存在行動呼籲 | ad_gate_check.py 優惠發現清晰(無 OFFER_NOT_EXACT、UNLEDGERED_AMOUNT、NO_CTA) | 修正文字;絕不發明或四捨五入聲明;詢問客戶 | ad_gate_check.py + 人類 | 任何文字、價格或卡片編輯 |
| G2 合規性 | 所有 12 個主題均已評估;無 fail/blocked;pass 行附帶證據;n/a 行附帶理由 | ad_gates.json 中的表格;ad_gate_check.py exit 0 | 移除或替換該聲明;提出合規的措辭;不進行渲染 | 此技能(阻斷性) | 任何新的聲明、素材或投放版位 |
| G3 鉤子排名 | >= 3 個鉤子,附帶明確理由並排名;無通用的 3 秒聲明;無禁止的開場 | ad_gates.json 中的鉤子列表 | 重新排名;將理由重寫為編輯理據 | 此技能 | 任何鉤子編輯 |
| G4 安全區域 | 關鍵文字、行動呼籲、價格、標誌位於每個比例的內部區域內;9:16 比例下,字幕軌道底部 <= y 1450 | safe_zone_check.py exit 0 且附帶在鉤子、優惠與片尾卡處實際檢視的疊加快照 | 重新排版該元素;若未檢視疊加層則回報 blocked | 此技能 | 任何排版變更;設備測試結果 |
| G5 授權 | 每個音樂/音效/素材/標誌都有允許廣告的行、投放版位覆蓋範圍、若為 CC-BY 則有署名、第三方品牌資產的書面許可;AI 素材已揭露 | ad_gate_check.py 素材發現清晰;SOURCES.md | 更換為已授權的素材;詢問品牌 | 此技能 + paid-generation-gate | 任何素材或投放版位變更 |
| G6 批次與片尾卡 | 鉤子變體共用一個混音(僅前幾秒不同);片尾卡 2-3 秒,包含標誌、優惠、聯絡資訊、行動呼籲、音樂播放至結束;一位評論者審查整套作品 | 清單 check exit 0;已檢視片尾卡幀 | 僅對失敗的檔案進行去重、重新混合、重新渲染 | multi-video-variants | 任何主版本或鉤子變更 |
| G7 評分標準與無聲測試 | 平均分 >= 4.0,無任何維度 < 3,閘門 A1/A2/A6 高於 2;無聲情況下能理解優惠、品牌與行動呼籲;最終 -14 +/- 0.5 LUFS,TP <= -1 | 附有時間碼的評論報告;qa delivery | 僅修正並重新審查變更的範圍 | 評論者 + 此技能 | 每次草稿 |
數字(內部預設值與市場中位數,及其限制)
- 藍圖:鉤子 0-2/0-3 秒,優惠 7-9 秒(15 秒版本)/ 19-22 秒(30 秒版本),片尾卡 12.5-15 秒 / 27-30 秒;優惠加行動呼籲佔 30 秒廣告的 30-45 %(市場 31-42 %)。
- 視覺變化至少每 1.4 秒一次;約 36 次剪輯/分鐘(市場,16:9)與 34.5 次(所有者,9:16);品牌約在 1 秒內出現,產品約在 3 秒內出現;一個響度峰值,位於標誌上。
- 安全區域 9:16:上方 300 / 下方 672(關鍵文字 y <= 1248)/ 左方 140 / 右方 192,字幕軌道底部 <= y 1450:內部預設值 v1,日期 2026-10-02(
references/safe-zone-presets.md)。 - 鉤子區域的標題:最多 6 個字(針對付費 9:16 關閉聲音的內部建議)。
決策規則
| 如果 | 則 |
|---|---|
| 簡報中無優惠 | 以書面形式詢問,或提出一個低門檻的優惠並詢問;檢查器保持 INSUFFICIENT 直到獲得回覆 |
| 客戶想要一首熱門歌曲或電影片段 | 替換為已授權的音軌;解釋比對或趨勢並非授權;預留替換時間 |
| 鉤子「必須在前 3 秒內有效」 | 將理由重寫為編輯理據;無已驗證的通用門檻 |
| 聲明無證據(「最佳」、「100% 保證」) | 合規行為 blocked;提出有文件證據的措辭;不進行渲染 |
| 僅有 16:9 的素材用於 9:16 的廣告 | 透過 multi-video-variants 重新排版;絕不裁剪或縮小畫面以符合區域 |
| Meta 與 TikTok 版本剪輯不同 | 檔案名稱中帶有平台標記,每個投放版位有一行授權 |
| 廣告大部分為 AI 鏡頭 | 同時載入 edit-ai-generated,根據投放路徑揭露,僅透過閘門花費 |
| 客戶核准的外觀與技能簽名衝突 | 客戶的外觀優先;記錄評分標準偏差 |
封鎖狀態(回報它們,不要繞過)
與帳目不同的優惠字串;畫面上未列在帳目中的金額;任何合規行為 fail/blocked;帶有 unknown、NC 或無廣告允許列的素材;無書面許可的第三方品牌資產;無實際檢視疊加層的安全區域聲明;manifest_check.py 未就緒。每一項都是停止並說明解鎖原因的充分理由。
每個都會耗費一輪或一個廣告活動的陷阱
優惠折扣埋在 30 秒廣告的 21.6 秒處;價格被設計為字幕;以「大幅折扣」代替數字;品牌僅在結尾出現;商業歌曲或動畫片段出現在剪輯中;授權用於 TikTok 的音軌用在 Meta 上;付費廣告中使用第三方支付聲音;經 AI 修飾的前/後比較;真峰值高於 0 dBTP;品牌名稱或地址拼寫錯誤;要求 15 + 30 秒卻產出 46-53 秒的廣告;鉤子被評為「最佳」卻無理由;鉤子變體無聲地帶有不同的混音。
參考資料(載入時機)
references/ad-blueprint-and-hooks.md- 腳本撰寫:藍圖、鉤子階梯、優惠/行動呼籲/片尾卡、視覺文法、客戶素材檢查清單。references/compliance-table.md- 步驟 2 與呈現前:12 個主題、證據、合規措辭、平台備註(已標註日期)。references/safe-zone-presets.md(+references/safe_zone_presets.json,由腳本讀取)- 任何排版;在說出「passes」之前(已標註日期的預設值)。references/sound-and-licences.md- 選擇音樂/音效、授權行、混音與音量。references/rubric-and-benchmarks.md- 呈現前;為草稿評分;數字表格。- 其他技能:
video-intake、reference-style-transfer、multi-video-variants、render-qa-deliver、revision-round、paid-generation-gate、edit-ai-generated(主要由 AI 鏡頭製作的廣告)。平台事實:agent-content/references/platform-specs.md(歸屬於其他處,已標註日期);評分標準基準agent-content/benchmarks/ad-promo.rubric.md(歸屬於其他處)。 - 腳本:
scripts/ad_gate_check.py、scripts/safe_zone_check.py(標準庫,用法 docstring,--self-check,exit 0 / 1 / 2)。