Communitygithub.com

Malik-rgb43/editing-workflow

將新的影片點子、簡報或規格清單,轉換為可檢查的概念分類帳,並持續提問直到所有參數精確無誤,然後才開始任何概念、提示或建置。

editing-workflow 是什麼?

這個技能(名為 video-intake)是所有新影片專案的第一道關卡(階段 wf-00)。它的核心功能是將使用者提供的任何影片概念、簡報或具體規格,透過嚴謹的提問循環,轉化為一個可量化、可檢查的「概念分類帳」(Concept Ledger)。技能會產出 INTAKE_LOG.md、BRIEF.md 等規劃文件,並在必要時產出三個概念卡片,但**絕對不會**產出任何逐幀的 PROMPT、程式碼或生成內容。它強制執行一組鐵則:所有參數(如平台、長度、語氣、品質標準)在精確鎖定前不得跳過;每個使用者的具體陳述都必須對應到分類帳的一行;且任何鎖定的行不可被覆寫,只能新增並標記舊行。該技能支援 Claude Code、Cursor 等 AI 代理平台,並內建多道檢查關卡(Gates),確保資料完整性與無猜測原則。它特別適合於專案初期、使用者尚未有完整腳本或素材時使用,能有效避免因規格模糊而導致的重工與浪費。

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

在你喜歡的 AI 中提問

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

說明文件

video-intake

每個新影片專案的第一道關卡(階段 wf-00)。產出:一份逐字記錄的攝取日誌、一個每個具體事項都有可衡量欄位的概念分類帳、BRIEF.md,以及(如果使用者未指定概念)三個概念卡片。它不撰寫逐幀的 PROMPT、不寫程式碼、不進行生成。

永不妥協的規則

  1. 持續攝取直到精確。 若無參考資料,則提問。平台、長度、語氣、CTA、結構(僅剪掉靜音 vs 重建)和品質標準絕不猜測。
  2. 使用者的每個具體陳述都成為分類帳的一行,帶有 ID,使用使用者自己的措辭(希伯來文保留希伯來文)。複合性陳述需拆分("地球變大且人物變高" = 2 行)。
  3. 在阻塞行鎖定之前,不產出概念卡片、PROMPT 結構或進行建置:FMT、LEN、TON、BAR、CTA、FILE;若有素材則加上 STR 和 COLOR;若交付超過一個檔案則加上 VAR。
  4. PROMPT.md 必須在使用者同意後才能撰寫第一行程式碼,在自主執行亦然:代理先草擬,由人類核准(決策預設 Q6)。變更順序:分類帳 -> PROMPT -> 程式碼。
  5. 此處不進行任何花費。 攝取是規劃階段。AI 生成需要 paid-generation-gate;"僅規劃"意味著零生成。權利不明 + 計畫生成 = 受阻。
  6. 已鎖定的行絕不覆寫:新增一行並劃掉舊行(由 L<nn> 取代,或 ~~舊行~~ -> 新行,時間 在規格中)。
  7. 只問未知且關鍵的事項。 不要詢問工具或資料夾;自行決定並用一行說明原因。
  8. 技能是程序,而非權限:使用者和專案對花費與安裝的限制優先。未在模型上測試過(決策預設 Q4)。

流程

  1. 讀取現有內容:訊息、附件以及完整的原始碼樹:python scripts/source_inventory.py <原始檔資料夾> --write projects/<名稱>/_work/intake(會寫出 source_ls.txt + probe.json;一個 4K 攝影機原始檔曾經被忽略在一旁,旁邊就是粗剪)。檢查 projects/ 是否有共用相同原始檔的同級專案:詢問 "新專案還是 X 的延續?"。分支(參考資料、貼上的提示、"חדש לגמרי"、"רק תכנן"):references/branches-and-mistakes.md。
  2. 逐字記錄 到 _work/intake/INTAKE_LOG.md:使用者的話語作為純文字行,您的提問作為 Q: 行,放在 ## 第 N 輪 標題下。
  3. 解析分類帳 到 hf/PROMPT.md 的 <ledger> 區塊中(一個尚未有 <structure> 的草稿):ID、維度、said、可衡量的 spec、where / when、驗收檢查、src U/R/D/A、狀態(references/ledger-template.md)。
  4. 提問循環(references/question-bank.md):每輪 3-4 個問題,具體選項,第一個為建議選項;BAR 放在第一輪。每輪結束後印出 נעול:... | פתוח:... 並更新分類帳。"תמשיך" / "continue" = 採用建議選項,標記為 D,用一行說明。
  5. 有參考資料嗎? 交給 reference-style-transfer 並詢問哪個時間範圍是 "風格"。沒有:繼續提問;絕不憑空創造風格。
  6. 概念:如果使用者未指定,則產出三張在概念上不同的卡片:Proven / Bold / Wild;建議其中一張(references/concept-cards-and-brief.md)。
  7. BRIEF.md 根據範本(agent-content/techniques/templates/BRIEF.md)填入正確的事實,執行 ledger_check.py,交給 PROMPT 撰寫者,等待核准,然後在 hf/CHANGELOG.md 中記錄 PROMPT_APPROVED <日期> "<用語>"。

提問循環簡述

  • 每輪 3-4 個問題,影響最大的優先:FMT / LEN / STR / BAR,然後是 HOOK / TON / LOOK / MOT,再來是 TYPE / 3D / BROLL / BRAND,然後是 CAP / MUS / SFX / CTA,最後是 FILE / VAR / DUE。
  • 每個選項都是具體的(數字、名稱、色碼、檔案);第一個選項是建議選項,標示 (מומלץ) / (建議) 並用一行說明原因。視覺選擇:加入預覽,或當有 3 個以上待決的品味選擇時,加入 choice-board。
  • 絕不問 ls、ffprobe 或訊息中已回答過的問題;絕不問關於工具或資料夾的事。
  • 每輪之後:נעול:L01 L02 ... | פתוח:HOOK LOOK ...。
  • 沒有提供參考資料意味著提問;提供了參考資料則分析它,並只問參考資料無法回答的問題(長度、比例、結構、CTA、檔案名稱、BAR、音樂授權、截止日期)。

第一輪訊息(希伯來文 / 英文)

סבב 1 - ארבע שאלות, לכל אחת ברירת מחדל מומלצת:
1. פלטפורמה ויחס? (מומלץ: 9:16 ריילס/טיקטוק; מאסטר אחד, שאר היחסים בעיצוב מחדש)
2. כמה שניות בדיוק? (מומלץ: התוכן המלא בצילום; 45 במושן)
3. חיתוך שתיקות בלבד, או בנייה מחדש? (מומלץ: שתיקות בלבד, סדר טבעי, משפטים שלמים)
4. רמת איכות? (מומלץ: פרימיום - ביט גרפי כל 3-6 שניות, צבע מדוד)
Round 1 - four questions, each with a recommended default: 1. platform and ratio, 2. exact seconds, 3. silence cut only or rebuild, 4. quality bar.

分類帳行一覽

| L02 | TRN | "פילם ברן בשניה 1-2" | 使用者的燃燒檔案,全影格,螢幕混合 | 1.00-2.00 秒 (f30-60) | 影格條 f28-62:燃燒可見,檔案名稱相符 | U | 已鎖定 | 每行一個主張;said 逐字;spec 可衡量;有時序的 said 需要一個範圍和影格層級的檢查(檢查器會強制執行兩者)。

攝取出錯的跡象

長度或平台出現在沒有使用者句子支撐的情況下;概念卡片存在於 FILE 或 CTA 鎖定之前;使用者從未見過的 D 行;從未列出原始檔資料夾;PROMPT 有 <structure> 區塊但沒有 PROMPT_APPROVED 行。

關卡

狀態:pass | fail | blocked | n/a 並附帶原因。缺少日誌、空的分類帳、超時或無法讀取的資料夾絕不會通過。

關卡條件證據若為假負責人重新檢查時機
G1 分類帳完整性攝取日誌中的每個具體條款都有一行對應;每個 U 行的引用都在日誌中;無憑空創造的行python scripts/ledger_check.py hf/PROMPT.md --source _work/intake/INTAKE_LOG.md 退出碼為 0(狀態 PASS,覆蓋率 checked)新增缺失的行,或用 --waive 跳過某個條款並附理由;切勿編輯日誌以符合條件video-intake任何新的使用者訊息或分類帳編輯
G2 無猜測FMT、LEN、TON、BAR、CTA、FILE(+STR、COLOR 搭配 --footage;+VAR 搭配 --variants)都來自 U/R/已核准的 A,或來自使用者看過的 D 行;每輪最多 4 個問題同一腳本:blocking 全部 ok,無 too_many_questions進行下一輪提問;不撰寫概念video-intake某個答案改變了阻塞行
G3 原始碼樹已讀取整個原始碼樹已被列出;已報告或標記為 unknown 的原始相機素材候選項目_work/intake/source_ls.txt 和 probe.json 存在並被引用重新執行;一個 blocked 的清單保持受阻狀態video-intake新檔案被加入原始碼
G4 參考分支有參考資料 -> reference-style-transfer 並記錄了風格時間範圍;無 -> 循環繼續攝取日誌中的分支行不要憑空創造風格video-intake使用者新增參考資料
G5 三個概念3 張卡片,在鉤子裝置 / 結構 / 視覺語言上至少有兩對不同;每張列出它遵循的分類帳 ID卡片重新生成最弱的那張video-intake某個阻塞行改變了
G6 權利BRIEF.md 有填寫完整的 "來源與權利" 區塊(素材所有者/同意書,每個檔案的音樂/素材庫授權,客戶 vs 自有帳戶)BRIEF.md受阻:無付費生成,無廣告使用 授權:未知(決策預設 Q2)video-intake新素材出現
G7 交接ledger_check.py hf/PROMPT.md --source ... --prompt hf/PROMPT.md 退出碼為 0(每個 ID 被引用 >= 2 次)且 hf/CHANGELOG.md 中有 PROMPT_APPROVED 行腳本輸出 + 該行PROMPT 維持草稿狀態;不寫程式碼PROMPT 撰寫者任何分類帳或 PROMPT 變更

產出

_work/intake/{INTAKE_LOG.md, source_ls.txt, probe.json}、hf/PROMPT.md 中的 <ledger> 區塊、hf/BRIEF.md、選定的概念卡片、變體行(每個檔案一行)、OPEN: 列表、分類帳檢查 JSON。

停止條件

  • 使用者說 "直接開始":將建議的預設值作為 D 並說明哪些;仍須詢問 CTA、FILE 以及任何他們尚未見過的阻塞項目。
  • 新請求與已鎖定的行衝突:顯示兩者,詢問哪個勝出;絕不暗中選擇。
  • 使用者想跳過 PROMPT 核准:拒絕此捷徑,提供一個更短的 PROMPT,而非一個被跳過的。
  • 攝取經過 4 輪:總結已鎖定 | 未鎖定項目,並請使用者用一個 "continue" 解決其餘部分。

參考資料與腳本

  • references/ledger-template.md:在建立或編輯分類帳時載入(檢查器可解析的格式、維度代碼、檢查類型、範例)。
  • references/question-bank.md:在缺失欄位時或在組成新一輪提問前載入(希伯來文 + 英文、選項、輪次計畫)。
  • references/branches-and-mistakes.md:當輸入是參考資料、貼上的提示、同級專案,或在關卡失敗後載入。
  • references/concept-cards-and-brief.md:在撰寫概念卡片、BRIEF.md、權利事實或進行交接時載入。
  • scripts/ledger_check.py、scripts/source_inventory.py:標準庫;每個都有 --self-check。
  • 共享技巧(其他負責人):agent-content/techniques/concept-ledger.md(規範性分類帳規則)、agent-content/techniques/question-bank.md(完整的希伯來文銀行);階段劇本 agent-content/playbooks/wf-00-intake.md。

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

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).

相關技能