Communitygithub.com

aliflazuardi/klip

將印尼語主題提示詞轉換為完整的 TikTok 影片(1080x1920 MP4,含語音旁白與字幕同步)。當使用者說 /klip、「buat video tentang …」、「make a TikTok about …」或要求渲染 Klip 規格時使用。

klip 是什麼?

Klip 是一個 AI 技能,能夠從印尼語主題提示詞自動生成完整的 TikTok 影片。它負責編寫場景規格 JSON,由使用者審閱後再透過管道渲染,產生 1080x1920 的 MP4 影片,包含語音旁白和與字詞同步的逐字字幕。此技能支援各種模板(鉤子、解釋、清單項目、迷思與事實、統計、比較、行動呼籲),並可選擇旁白語音(男性 Ardi 或女性 Gadis),目標時長預設為 45 秒,最長 60 秒。Klip 會自動進行事實研究、驗證規格並執行品質管控(QA),確保產出高品質內容。它主要在命令列環境中執行,但設計為可透過 Claude Code 或類似 AI 代理工具使用。開發者只需提供主題提示詞,Klip 就會處理整個腳本撰寫、媒體素材蒐集、影片合成與後製流程,讓 TikTok 內容創作變得前所未有的簡單。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aliflazuardi/klip/tree/HEAD/.claude/skills/klip

在你喜歡的 AI 中提問

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

說明文件

Klip:提示詞 → TikTok 影片

你是腳本作家。你撰寫場景規格 JSON,使用者審閱後,再由管道將它渲染出來。規格就是契約:重新渲染相同的規格會得到相同的影片。

流程

  1. 解析請求。 主題(印尼語)、語音(male = Ardi,female = Gadis;預設 female;「suara cowok」= 男性,「suara cewek」= 女性)、目標時長(預設 45 秒,最長 60 秒)。
  2. 閱讀契約(如果你在這個工作階段還沒讀過):schema/spec.schema.json 與黃金範例 examples/menguap.json。
  3. 研究事實:針對健康/科學/金融相關的主張,將每一項放入 facts[],並附上真實的來源網址。不要引用你無法指向的資料。
  4. 撰寫規格 到 specs/<slug>.json(slug = 主題的 kebab-case 格式,僅限 ASCII)。
  5. 驗證:uv run klip validate specs/<slug>.json --voice <voice>。修正所有錯誤,並調整字數,使預估時長落在目標時長的 ±15% 以內。
  6. 審查關卡 — 停下來並向使用者展示 腳本:每個場景的旁白與螢幕文字、預估時長,以及含來源的事實。要求核准或編輯。在使用者說「好」之前不要渲染(只有當他們明確表示不需要審查時才能跳過)。
  7. 渲染(對於 45 秒的影片約需 2–2.5 分鐘;在背景執行): uv run klip render specs/<slug>.json --voice <voice> 輸出會放在 projects/<slug>/ 中:final.mp4、cover.png(設計好的封面)、post.txt(含 B-roll 來源)、credits.json。
  8. 回報 檔案路徑、時長,以及從 post.txt 取得的 TikTok 說明文字。提醒使用者啟用 TikTok 的 AI 生成內容標籤(語音是合成的)。

一次處理多個主題? 撰寫一個 YAML 檔案(參見 examples/batch.yaml),執行 uv run klip batch topics.yaml --scripts-only,向使用者顯示規格,然後用 uv run klip batch topics.specs.yaml 渲染(在背景執行;每部影片約需 3–4 分鐘)。

如果 klip render 失敗,請執行 uv run klip doctor 並修正它所回報的問題。klip run <stage> 則可重新執行單一階段(voice | assets | compose | render | post | qa)。

QA: klip render 最後會產生一份 QA 報告,如果檢查失敗則以退出碼 1 結束。修正原因(例如時長超出範圍 → 縮短/加長旁白或調整 target_duration_s)並重新渲染;未變更的階段會被快取。告訴使用者你無法修正的任何檢查。

這個版本可以渲染的內容(Phase 3)

  • 模板(為每個節奏挑選最適合的模板;請多變換,因為整部影片都用 explain 會很無聊):
    • hook:永遠是第一個場景。on_screen_text 為 2–5 個有力的單詞。
    • explain:旁白的預設模板。on_screen_text 是一個簡短的標題。
    • list_item:提示(「Satu, …」、「Dua, …」)。使用 2–4 個連續的 list_item 場景;編號和「1/3」會自動產生。on_screen_text 是 ≤ 5 個單詞的提示。
    • myth_fact:需要 myth 和 fact(各 ≤ 8 個單詞)。旁白先陳述迷思,然後說「Faktanya, …」。將 reveal_at 設為那個詞(「Faktanya,」),讓事實卡片在提示出現時顯示。
    • stat:需要 stat: {value, suffix?, prefix?, decimals?, label?}。一個引人注目的數字,例如 `{

相關技能