Communitygithub.com

Malik-rgb43/editing-workflow

為付費社群廣告、贊助貼文或品牌宣傳企劃進行腳本撰寫、剪輯或審查(Meta、Instagram、TikTok,15-60 秒):包含精確的優惠與行動呼籲、排名鉤子、鉤子變體、片尾卡、合規封鎖表與授權檢查。觸發詞:ad, promo, sponsored, campaign;מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק。不適用於推薦見證(edit-testimonial)、原生專家短影音(edit-talking-head)、純 AI 生成影片(edit-ai-generated)或比例匯出(multi-video-variants)。

editing-workflow 是什麼?

這個技能專為在 Meta、Instagram 與 TikTok 等平台上製作付費社群廣告、贊助貼文或品牌推廣影片而設計,影片長度介於 15 到 60 秒。它的核心原則是「優惠、價格與行動呼籲必須完全依據客戶提供的書面資料」,任何字串或數字都不得自行發明、四捨五入或「美化」。整個流程從影片素材接收開始,經過優惠分類帳、合規封鎖表、腳本撰寫(含三個排名鉤子及其理由)、風格畫格與安全區域檢查,再到建造、渲染與最終交付。其中一個關鍵機制是合規封鎖表,它涵蓋 12 個主題,任何一個主題若為「失敗」或「封鎖」狀態,都會直接阻止草稿提交。此外,每個音樂、音效或素材檔案都必須有明確的廣告授權欄位,第三方品牌資產則需要書面許可。技能也會產出多個鉤子變體,並使用 manifest_check.py 進行批次驗證。支援平台包含 Claude Code 等 AI 代理工具。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-ad-promo

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

edit-ad-promo

將客戶的優惠、產品與影片素材轉換為希伯來語的付費社群廣告,該廣告精確陳述優惠內容,以排名鉤子開場,能夠通過合規審查與授權審查,並以一系列基於同一主體的鉤子變體形式交付。在打磨細節之前,會先檢查優惠、聲明與授權。

凌駕於本文件其他部分的規則

  1. 優惠、價格與行動呼籲必須完全依照書面資料。 字串與數字來自客戶確認過的帳目;不得自行發明、四捨五入或「美化」;僅在真實情況下才能使用急迫性用語。若客戶未提供優惠:提出一個低門檻的優惠並詢問;絕不自行撰寫。
  2. 合規封鎖表是阻斷性的。 其 12 個主題每個都有狀態;若某一行為 fail 或 blocked,則無論評分標準為何,都會阻止草稿提交。標籤(AI 揭露、免責聲明)絕不能用於掩蓋欺騙性聲明。
  3. 授權: License: unknown = 不在客戶或廣告工作中(決策預設 Q2:所有者較舊的「僅限原生貼文」是他對自己帳戶的風險態度,而非授權)。音樂與音效僅在該檔案自己的行允許該投放版位與地區用於廣告時方可使用。第三方品牌的聲音與標誌需要書面的品牌廣告許可。歌曲比對不等於授權;熱門音效未經許可。
  4. 沒有通用的鉤子法則。 沒有來源驗證過 3 秒門檻或固定的留存數字;鉤子應根據明確的理由進行排名,並由客戶自己的結果進行測試。
  5. 安全區域是內部預設值 v1(已標註日期,未經設備驗證;決策預設 Q5),通過需要實際檢視疊加層,而不僅是幾何形狀。
  6. 花費與隱私: 未經 paid-generation-gate(一份標註日期的估算與核准)不得進行付費生成;AI 鏡頭僅作為氛圍或補充素材使用,並需揭露;未經每個客戶的決定,不得將客戶素材上傳至雲端工具;snapshot --describe false。
  7. 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
5PROMPT.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 1450safe_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)。

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

相關技能