Communitygithub.com

ChatCut-Inc/agent-plugin

透過 Seedance、Kling、Gemini Omni、MiniMax H3 與 MiniMax H3 Max 進行 AI 影片生成。當使用者想要產生影片片段時使用 — 包括文字轉影片、圖片轉影片、首尾幀轉場、參考引導生成,或修改/編輯/延伸現有已生成的片段。

agent-plugin 是什麼?

此技能提供一個統一的介面,透過多達八種前沿模型進行 AI 影片生成,包括 Seedance 系列(2.5、2.0、2.0 Fast、2.0 Mini)、Kling、MiniMax H3(標準版與 Max 版)以及 Gemini Omni。它支援多種生成任務,例如從文字或圖片建立全新片段、使用首尾幀進行轉場、透過參考影像/影片/音訊進行引導生成,以及對現有片段進行編輯或延伸。該技能遵循一個結構化的四步驟工作流程:與使用者對齊範圍、根據特定模型的參考文檔編寫提示詞、一次提交一個生成任務並等待使用者確認,然後根據需要進行迭代。它強制執行嚴格的模型選擇邏輯,其中 `seedance-2-5` 是預設值,僅在使用者明確要求其他模型或 Seedance 無法滿足特定需求(例如快速草稿、精細情感控制或 2K 輸出)時才切換。此技能專為 ChatCut 平台設計,需要付費的影片生成權限,並與 `browse_assets` 和 `track_progress` 等資產管理工具整合以處理作業狀態。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ChatCut-Inc/agent-plugin/tree/HEAD/claude/skills/video-gen

在你喜歡的 AI 中提問

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

說明文件

影片生成

如果 submit_video 尚未載入,請先使用 ToolSearch 載入它,然後再呼叫,這樣就能使用其真實參數,而不是猜測。

每次呼叫提交一個影片生成作業,並返回一個 jobId。作業狀態和後續檢查屬於 track_progress;此技能不會自動將影片放置到時間軸上。

使用時機

每當使用者想要產生影片片段時 — 文字轉影片、圖片轉影片、首尾幀轉場、基於參考的生成,或是基於現有影片進行生成式編輯/延伸(根據來源片段產生新的生成素材;非時間軸修剪)。

模型

模型參考資料優勢
seedance-2-5references/seedance25.md預設。4-30 秒,最多 50 個多模態參考,僅音訊參考,時間戳控制,以及 mp4/mov 輸出。用於新生成、編輯和延伸時最強的 Seedance 選擇。
seedance2references/seedance2.mdSeedance 2.0 完整模型。4-15 秒,豐富的多模態參考,最高 1080p 輸出。
seedance2fastreferences/seedance2.mdSeedance 2.0 Fast — 與 seedance2 相同的輸入和 4-15 秒範圍,幾分鐘內返回而非約十分鐘,約便宜 20%,最高 720p。當使用者在迭代且週轉時間比最高保真度更重要時使用。
seedance2minireferences/seedance2.mdSeedance 2.0 mini — 與 seedance2 相同的輸入和 4-15 秒範圍,約便宜 50%,最高 720p。用於不需要完整模型保真度的廉價草稿和高批次量。
klingreferences/kling.md透過提示詞進行攝影機控制語言;在角色鏡頭的精細情感/表演控制方面表現強勁。透過 mode:"pro" 支援 1080p。
minimax-h3references/minimax-h3.mdMiniMax H3。4-15 秒,768p/2k,首尾幀,最多 9 張圖片 + 3 個影片 + 3 個音訊參考(共 12 個)。強大的多模態參考跟隨能力。
minimax-h3-maxreferences/minimax-h3-max.mdMiniMax H3 Max。5-15 秒,480p/768p,文字或首尾幀生成。無參考模式或 2K 輸出。
omnireferences/omni.mdGemini Omni 1.1 Flash。透過 continueFrom 進行目標編輯/延伸,首尾幀,以及便宜的 360p 草稿。3-10 秒;預設 720p,最高可放大至 1080p/4k。

重要: 在生成之前,請閱讀所選模型的參考文檔,了解其功能、輸入通道、模式、提示結構和特定模型的行為。

模型選擇

對於新生成,seedance-2-5 是預設值。僅在以下情況切換:

  • 使用者明確指定了模型(「用 Kling」、「use Kling」、「用 Omni」、「用 mini」、「/kling」)— 立即切換,無需再次詢問。
  • 使用者明確要求 MiniMax H3 或需要結合圖片/影片/音訊參考引導,且可選 2K 輸出 — 使用 minimax-h3。
  • 使用者明確要求 MiniMax H3 Max 或想要其最高保真度的文字/幀生成而不需要多模態參考 — 使用 minimax-h3-max。
  • Seedance 明顯無法或無法很好地完成 — 當您遇到 Seedance 已知的弱點時,建議切換到 kling 並在提交前確認。
  • 使用者明確要求快速/便宜的草稿,且預計會修改 — 建議使用 omni(360p 草稿,≤10 秒,支援目標編輯)並在提交前確認。
  • 使用者需要 1080p 的 Seedance 輸出 — 優先使用 seedance-2-5;它和完整的 seedance2 都支援 1080p。
  • 使用者想要便宜的 Seedance 2.0 輸入,或一次產生多個片段,且接受 720p — 建議使用 seedance2mini(4-15 秒,約為 2.0 完整模型成本的 50%)並在提交前確認。
  • 使用者正在迭代 2.0 風格的輸出,且在乎週轉時間 — 建議使用 seedance2fast(480p 或 720p,4-15 秒,約為 2.0 完整模型成本的 80%,返回速度更快)並在提交前確認。

否則請繼續使用 seedance-2-5。

對於修改已存在的片段,選擇在第 4 步進行 — 而非此處。修改請求不是更改未來新生成預設值的理由。Omni 1.1 取代了先前的 Omni 選擇;請保留 omni 別名,不要發明第二個舊版選擇。

存取注意:所有八個模型都需要 ChatCut 付費影片生成權限(訂閱或付費點數)。切勿將其他模型呈現為繞過訂閱閘門的免費替代方案;當使用者要求免費路徑時,請改為提供免費的動態圖形動畫。

工具參數

參數值預設值
prompt影片描述(必填)—
modelseedance-2-5, seedance2, seedance2fast, seedance2mini, kling, minimax-h3, minimax-h3-max, omniseedance-2-5
durationSeconds秒數5
ratio請參閱模型文檔16:9
resolution依模型而異;H3: 768p/2k;H3 Max: 480p/768p;Seedance: 480p/720p/1080p;Omni: 360p/720p/1080p/4k720p(H3 模型:768p)
outputFormatmp4, mov(僅限 seedance-2-5)mp4(生成);mov(編輯/延伸)
taskModegenerate, edit, extend(僅限 seedance-2-5 或 omni)generate
name描述性資產名稱(必填)—
firstFrame專案資產參考—
lastFrame專案資產參考—
continueFrom影片資產參考 — 僅限 omni,要編輯/延伸的來源—

特定模型的參數(例如 Kling 的 mode、Seedance 的 refImages / refVideos / refAudios)— 請參閱該模型的參考文檔。

輸入解析度

firstFrame / lastFrame / refImages / refVideos / refAudios 都接受專案資產參考。優先使用來自 browse_assets 的完整 UUID 或短前綴;asset://<id> 以及資產工具返回的同一專案資產 URL 也都接受。按插槽類型:幀插槽和 refImages → 圖片;refVideos → 影片;refAudios → 音訊。

不接受外部 URL 和 base64。如果來源是公開 URL,請將其下載到沙盒工作區,透過 asset-import + push_asset 匯入本地檔案,並傳入產生的資產 ID。

工作流程

四步驟循環。對於每次新生成,如果使用者的意圖已改變,請從步驟 1 重新開始。

步驟 1 — 與使用者對齊範圍

在撰寫任何提示詞之前,請在三個維度上對齊:

  1. 時長與片段數 — 總長度、有多少個鏡頭,以及它們是在一個片段中還是多個片段中。

    如果使用者已指明方向(「做一段」、「in one video」、「分別生成」、「split into N shots」等),請遵循它 — 不要質疑。

    否則,提出兩種路徑讓使用者選擇:

    • 單一片段內的多個鏡頭(請參閱模型參考文檔)— 單次推理,主體/光線/風格在子鏡頭間物理上一致;適合在每個片段的時長限制內講述連貫的故事。
    • 多個片段 — 每個片段可獨立控制和重新生成,但身份和風格連續性必須透過錨點來維持;適合超過時長限制或場景硬切換的情況。

    提供權衡方案;不要替使用者做決定。

  2. 內容 — 每個片段描繪的內容。分段總結您理解的內容。當內容模糊時(例如「生成一段女孩跳舞的影片」),使用者通常未指定以下一項或多項:

    • 主體:主要主體是誰/是什麼(外觀、服裝、定義特徵)?
    • 動作:他們在做什麼?(對於說話/情感鏡頭,有什麼微表情?)
    • 場景:在哪裡 — 設定、一天中的時間、環境細節?
    • 光線/色彩氛圍:什麼氛圍?
    • 攝影機:是否有任何景別/角度/運鏡偏好?
    • 風格:視覺風格或參考(電影感/動漫/紀錄片/...)。

    專注於對於此特定請求重要且無法安全推斷的項目 — 不要將其變成填空練習。在繼續之前,向使用者總結您理解的部分。

  3. 連續性錨點 — 僅當多個鏡頭重複使用角色、物體或場景時:識別要在多個鏡頭間固定的錨點(參考圖片或影片)。關於來源規則,請參閱下面的「跨鏡頭的視覺一致性」。

對於每個維度,檢查使用者的措辭:

  • 明確 — 繼續。
  • 模糊或缺失 — 詢問使用者。不要猜測,不要預設您自己的解釋。一輪確認比一次浪費的生成更便宜。

不應做的事

  • 不要「告知後提交」 — 宣布「我將把它做成 2 個片段」然後立即提交不是對齊,而是單方面決定並宣布。
  • 不要預設將單一影片請求拆分為多個片段。 單一片段可以攜帶多個子鏡頭(請參閱模型參考文檔),主體/光線/風格在它們之間物理上一致。提出權衡方案,然後讓使用者選擇。
  • 不要跳過提問,因為您認為答案很明顯。

硬性覆蓋(使用者的明確措辭優先)

  • 「one clip / single clip / 一條 / 一個鏡頭 / in 1 clip」→ 永遠不要拆分,即使描述很長。
  • 「N shots / N 段 / N 個鏡頭」→ 精確生成 N 個。
  • 「use this image / 用這張圖」→ 用作參考,不要替代。

步驟 2 — 撰寫提示詞

請參閱所選模型的參考文檔,了解提示詞結構和參數組合(例如,Seedance 的 8 元素結構和模式;Kling 的提示詞技巧)。在提交之前,檢查:

  • name 是描述性的資產名稱 — 描述性要足夠,讓使用者(以及您在後續回合中)能夠在專案庫中識別此資產。避免使用模糊的名稱,如「Untitled」或「clip 1」。
  • 參數組合符合使用者的意圖 — 請參閱模型參考文檔中的模式部分。
  • 生成的影片音訊不是工具參數。Seedance 和 Kling 在提交時後端預設啟用音訊。
  • 如果驗證失敗,請閱讀錯誤訊息並修正輸入 — 不要盲目重試相同的無效參數。

步驟 3 — 提交一個、等待、確認

一次提交一個生成作業。 除非使用者明確要求並行生成多個片段,否則在當前片段完成且使用者審查之前,不要提交下一個片段。並行提交會隱藏問題:如果第一個鏡頭出現偏差或構圖錯誤,使用者寧願重做一次,也不願有多個不符合要求的鏡頭需要丟棄。

  • submit_video.ratio 僅控制生成的資產;它不會更改專案時間軸畫布。如果使用者要求最終輸出長寬比(例如「9:16 垂直」或「16:9 橫向」),請在放置完成的資產之前,使用 manage_timelines action=update 將時間軸畫布設定為相同的長寬比(例如 ratio:"9:16")。如果使用者要求沒有黑邊/滿版,請在設定畫布或更新/添加視覺項目時傳遞 fit:"cover"。
  • 不要使用此技能進行作業管理 — 請使用 track_progress 來取得即時狀態,並遵循其後續檢查指南。
  • 提交後,結束您的回合(告知使用者作業已建立),除非已有後續任務排隊。
  • 當作業完成時,將結果呈現給使用者審查,然後再繼續下一個鏡頭。
  • 對於 Omni 來源編輯,請在其參考文檔中遵循第一/中/末幀審查步驟,然後再聲明請求的變更已成功。
  • 特定模型的故障處理 — 請參閱該模型的參考文檔。

步驟 4 — 迭代

當使用者想要下一個片段、修訂或延續時...

Individual skills in this repo

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

相關技能