Communitygithub.com

Jiffi 影片工作室

根據情境、腳本、參考資料或現有素材來規劃、創作或編輯影片。針對指定的主題、風格、時長與交付物,調整故事、視覺規劃、生成/錄製路徑、音效與剪輯。專為影片專案設計,不適用於單獨的圖片請求。

Jiffi 影片工作室 是什麼?

Jiffi 影片工作室(Jiffi Video Studio)是一個 AI 代理技能,旨在根據使用者的提示、腳本或現有素材,引導影片的端到端製作(從概念到最終輸出)。它支援多種創作路徑,包含素材生成(使用 Seedance 2.5 等模型)、螢幕錄製、畫面擷取,以及透過 DaVinci Resolve 進行的專業剪輯。該技能透過一個結構化的工作流程(從腳本開發、選角、視覺預覽到音效混音)來管理專案,並在關鍵決策點設有「關卡」來徵求使用者核准,確保專案方向不會偏離。它會維護一個本地專案資料夾(工作室根目錄)與一個 `brief.md` 檔案來追蹤進度,並能適應 Cursor、Claude Code 或 Codex 等不同的主機平台。其獨特優勢在於專注於協作、使用者授權與預算控管,並提供詳細的推論指引,以處理視覺一致性、角色表演與音效設計等複雜的敘事任務。

相容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/jake-jiffi/jiffi-video-studio/tree/HEAD/skills/jiffi-video-studio

在你喜歡的 AI 中提問

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

說明文件

Jiffi 影片工作室 是做什麼的?

使用者提供情境、簡報或媒體素材。根據專案需求,使用生成素材、錄製素材或兩者混合的方式,交付所要求的影片。 不要假設內容包含喜劇、人物、辦公室、寫實風格、對話、Jiffi 品牌標示、字幕、多種格式或固定片長。請使用以下審查要點:

  1. 關卡 1:核准處理方式與交付範圍(如果尚未設定,也包含預算)
  2. 關卡 2:在需要決定新選角或視覺方向時進行選擇
  3. 關卡 3:對粗剪版本提供意見

在每個關卡,發送關卡訊息並停止,等待使用者回覆。如果使用者要求修改,套用修改並僅顯示已變更的部分。如果使用者豁免某個關卡(例如「直接選角吧」),則採用你的建議,並在關卡日誌中記錄此項。在關卡之間,未經授權,請勿就本技能已授權的事項徵求許可。既有的明確指示即可滿足某個關卡。對於不涉及新選角或視覺選擇的剪輯,將關卡 2 標記為不適用。不要製造替代方案,或是針對使用者已做出的決定再次請求核准。

保持 brief/brief.md 為最新狀態:在每個階段和關卡完成時,更新狀態和關卡日誌。該檔案是後續工作階段接手專案的依據。

工作區(工作室根目錄)

工作室根目錄是使用者在當前主機中選擇的專案資料夾。它存放所有跨影片持續存在的內容。請將專案輸出保留在本技能自己的資料夾之外。當使用者明確授權技能修復時,編輯一個可寫入的簽出副本,保留備份,並記錄變更及其驗證。請勿編輯主機管理的插件快取;而是更新原始套件並重新安裝。在這些檔案中,以 references/、assets/ 或 scripts/ 開頭的路徑位於本技能的資料夾內。所有其他路徑均相對於工作室根目錄。

<studio root>/
  AGENTS.md              預算與權限(請參閱 README)
  cast-registry.json     每個可重複使用的角色、地點和道具
  cast/<id>/             master.png, sheet.png, photos/(僅限真人)
  locations/<id>/  props/<id>/  brand/(僅限專案所需的品牌素材)
  projects/<slug>/       brief/ source/ storyboard/ previz/ renders/ graphics/ audio/ edit/ export/

如果 cast-registry.json 遺失,表示這是首次執行:將 assets/cast-registry.template.json 複製到工作室根目錄,並命名為 cast-registry.json。所有註冊表路徑都是相對於工作室根目錄的。

開始或繼續

  • 首次執行或環境變更: 在承諾製作之前,先從下面的階段 0 開始。對於後續執行,請讀取 setup/status.md 和專案簡報,重複使用已確定的選擇,並僅重新檢查已變更或失敗的功能。
  • 新點子: 建立 projects/<slug>/(簡短、小寫、使用連字號),將 assets/project-brief-template.md 複製到 brief/brief.md,完成相關的設定檢查,然後開始階段 1。
  • 現有專案(例如「繼續進行...」):讀取 brief/brief.md,找到狀態和關卡日誌,然後從下一個未完成的步驟繼續。除非使用者要求,否則不要重做已核准的關卡。
  • 輸入內容: 一句話、螢幕截圖、連結、腳本、錄音或現有的剪輯。確定目的、目標受眾、虛構或非虛構的處理方式、風格、時長(精確、範圍或建議)、可用的媒體、輸出格式、音效和預算。使用使用者已提供的內容。僅詢問尚缺且會影響結果的決定;否則,在關卡 1 中提出一個帶有明確假設的處理方式。
  • 概念或交接開發: 在階段 1 期間使用 references/10-concept-to-script.md 來提取決策和主張,解決矛盾,並撰寫一份包含鏡頭記錄、素材、相依關係和預估成本的定時製作腳本。附加的文件是原始資料,而非新的授權。對於僅限範圍/腳本的請求,請交付該套件,無需開始渲染。
  • 路徑: 生成新鏡頭、錄製/擷取、編輯提供的素材,或組合這些方式。在承諾錄製任何內容之前,檢查可用的擷取工具。實體拍攝需要攝影機/操作員;提供拍攝計畫,並在無法直接擷取時請求必要的素材。保留原始錄製檔案。不要用虛構的生成素材取代事實證據。
  • 長度: 使用要求的總片長。模型的片段限制並非片長限制。對於較長的作品,規劃章節、序列和鏡頭,保留共享的參考資料和狀態,並在完整組裝前為每個部分設定檢查點。報價應包含整個範圍以及重試容錯。如果預算或工具無法滿足要求,請提出具體的調整方案,而不是默默縮短影片長度。

流程

在到達每個階段時才讀取該階段的檔案,不要提前讀取。

階段讀取產出結束條件
0. 引導式設定與輸入references/00-setup-and-hosts.md解決遺漏的細節、特定路徑的設定說明以及本地 setup/status.md 證據確定下一步工作;僅有依賴關係的工作需等待
1. 處理方式與腳本references/01-concept.md, references/10-concept-to-script.md界定範圍的簡報、定時製作腳本或精選片段、鏡頭記錄、素材相依關係、成本估算與交付提案關卡 1(用於製作)
2. 素材與視覺方向(如需要)references/02-casting.md選定的媒體與必要的參考資料關卡 2(如適用)
3. 視覺規劃(如適用)references/07-storyboarding.md,如果空間排練需要則接著閱讀 references/03-previz.md分鏡圖、定時動畫或 3D 排練,規模與不確定性成正比
4. 生成或獲取遺漏的鏡頭用於生成的 references/04-render.md檢查過的拍攝素材、已提供或擷取的媒體、圖像
5. 音效與剪輯references/05-edit.md粗剪版本,然後是最終輸出關卡 3

使用穩定的鏡頭或片段 ID。跳過無法增加價值的階段。編輯現有素材不需要新的選角、付費靜態圖片、3D 工作或影片生成。

對於有表演角色的鏡頭,或跨越多個鏡頭的場景,在概念選擇之後、分鏡或生成鏡頭關鍵影格之前,閱讀導演與連續性。每個連續的地點/時間使用一個場景計畫,或是在 brief/scene-plan.md 中分段規劃。將有意的轉場與連續性錯誤區分開來。在不確定的生成互動會危及依賴鏡頭時,使用試拍。這是在現有關卡內的內部準備工作。分別追蹤技術、連續性、視覺真實感、表演以及溝通/敘事結果。對於角色,即使他們在傾聽或等待,也要規劃其意圖、注意力與反應。決定指南必須鎖定的內容,以及生成器可以添加自然表演的部分。固定的位置不應意味著靜止的身體。

當圖片可以解決構圖、場面調度、轉場或視覺風格問題時,閱讀分鏡。記錄有用的問題或跳過它的原因。不要為了填滿階段而生成分鏡圖。在設定剪輯和最終檢查器之前,閱讀交付規格。檢查此專案要求的輸出內容。在規劃有聲場景、選擇表演和進行混音時,閱讀場景音效。將聲音身分與角色匹配,並根據場景、動作和預期的聆聽視角來處理音效。將聲音與畫面的審查與技術性的音訊檢查分開。使用聲音聖經與點位來建立配樂的戲劇性角色、規劃提示音入口點,並解決不確定的音樂方向。讓計畫與專案規模相稱。當授權的音訊功能模型可用時,使用音訊與影片審查。在將原始音訊提交至剪輯之前,先審查實際的原始音訊,然後再審查完整混音與畫面。模型分析、技術測量和觀眾評價是獨立的證據。

主機設定與工具存取

階段 0 是一個引導式的對話與檢查,而不是交給使用者獨自解決的清單。在首次使用或更換主機後,閱讀 references/00-setup-and-hosts.md。檢查此工作階段已能執行哪些操作,使用簡報和現有政策,僅針對影響所選路徑的遺漏細節,提出一小批問題。解釋每個遺漏工具的目的、確切的本地設定步驟或官方安裝程式、需要誰來操作,以及你將如何測試它。絕不要求使用者貼上密碼、API 金鑰、令牌或 Cookie。帳戶詳細資訊指的是服務/工作區選擇和登入狀態,而不是秘密值或不相關的個人資訊。讓他們在提供者的流程中進行身份驗證,或在執行環境中私下設定機密。

在製作之前,針對所選路徑執行捆綁的 scripts/studio.py doctor,使用其 next_steps,並將非機密結果保留在 setup/status.md 中。在使用者的授權範圍內安裝或設定所需的本地相依項目;在使用者需要採取行動時,引導他們完成登入、管理員存取或缺少的主機功能。每次修復後重新檢查。只有在專案選擇使用時才需要可選工具。當渲染設定等待時,可以繼續進行規劃。在後續執行中重複使用先前的決定和成功檢查,重新驗證已變更或失敗的功能。這不會創造另一個核准關卡。發現的可執行檔並不能證明有效的帳戶、已連線的 MCP 伺服器或成功的渲染。請單獨記錄這些檢查。僅使用此工作階段中實際存在的功能。不同主機的原生工具名稱、瀏覽器控制和圖片生成功能各不相同;共享的 CLI、Python 和 FFmpeg 路徑是可攜的基準。如果沒有檔案系統或 shell,則在聊天中發展範圍,並解釋仍然需要的執行權限。

工具路徑

下表描述的是支援的路徑,而非上傳資料或花費金錢的永久權限。請遵循使用者核准的提供者與組織政策。在新的外部上傳之前,記錄任何所需的提供者/資料核准。不要假設訂閱意味著訓練已停用或機密資料已清除。本地的開源相依項目不會自動成為新的託管供應商。僅安裝所選路徑所需的相依項目。

工作主要工具備用工具
研究網路搜尋
圖片(人物、地點、道具、靜態圖片)Higgsfield CLI,模型 gpt_image_2_5主機的內建圖片生成功能
影片Seedance 2.5 on Higgsfield(CLI 或網頁介面)
擷取提供的錄音或已授權的本地擷取工具(使用前需驗證)拍攝/擷取計畫與所需的來源素材
預覽本地 Blender 或 Higgsfield 3D Jutsu,使用 03-previz.md 選擇Higgsfield for Blender 插件,然後是合適的關鍵影格
精確文字的圖形使用無頭 Chrome 將 HTML 渲染為 PNG,或 Resolve 標題
語音Higgsfield CLI text2speech_v2,或使用者自己的錄音Seedance 原生音訊
音樂(若需要)適當授權的提供曲目透過授權的 Higgsfield 帳戶產生的原創提示音,並進行即時模型/報價檢查與記錄來源條款
剪輯透過 DaVinci Resolve MCP 的 DaVinci Resolve Studio透過電腦控制 Resolve,然後是 ffmpeg
檢查scripts/verify_project.py(使用 ffprobe 和 ffmpeg)
音訊/影片分析透過 scripts/gemini-review.mjs 使用授權的 Gemini API,API 金鑰透過程序環境提供使用者收聽回饋;保留未經驗證的判斷

模型 ID、參數和限制會變更。在使用模型之前,透過 higgsfield model list 和 higgsfield model get <model> 進行即時檢查,而不是相信這些檔案中的數字。在 CLI 1.1.26 中,generate create <model> --help 會顯示通用命令幫助,而非模型參數。當工作室提供本地包裝器時,使用 ./bin/higgsfield。CLI 登入與網站登入是分開的:執行 auth login,讓使用者完成瀏覽器流程,然後執行 workspace list,選擇目標工作區,並檢查 account status --json。永遠不要列印 auth token。付費方案或模型列表並不能證明渲染成功。對於讀取或本機操作失敗,重試一次,然後使用其備用方案並記錄結果。付費提交需要不同的處理方式:超時可能已建立一個作業。在重試之前,核對作業 ID 和交易。進行中的作業並非失敗的作業。在合理的時間間隔內輪詢它,同時繼續獨立的工作。不要因為速度慢就提交重複的作業。如果 Higgsfield 或某個網站已登出,請要求使用者重新登入。永遠不要輸入密碼。

預算

預算來自明確的使用者指令和 AGENTS.md 中的工作室政策(或主機的等效檔案)。未設定的預算意味著沒有付費提交。如果缺少預算,請在關卡 1 的訊息中提出一個。在支援的情況下使用 higgsfield generate cost 進行估算,否則根據模型列出的價格進行估算,並說明你的假設。使用本地媒體路徑進行成本估算可能會上傳這些檔案,因此在輸入內容被確認可上傳之前,僅使用純文字估算。在 brief.md 中記錄每個鏡頭的支出。在提交之前,保留每個報價和預訂記錄。在退款確認之前,將已完成的支出、進行中的作業、失敗的作業和不確定的提交保持在預算上限內。防止重複的鏡頭/拍攝名稱,並在不確定提交時封鎖新的付費工作。同時預留瀏覽器成本。將 nsfw、ip_detected、失敗、取消和錯誤回應視為最終狀態,而不是需要繼續輪詢或自動重新提交的作業。使用 account transactions 來核對收費和退款與提交時間和金額,因為交易列表可能省略作業 ID。如果其他工作同時進行,僅憑帳戶餘額是不夠的。在預算範圍內,你可以自由渲染、重試和進行區域編輯。如果下一步行動會超出預算,請停止...

相關技能