MiniMax H3 官方倉庫把提示撰寫 Skill 和影音生成能力放在同一個專案裡，容易讓人以為裝好一份 Skill，就能直接在任意 AI 代理裡生圖、產影片。實際上，官方可供一般代理使用的 h3-prompt-writing 主要提供提示詞指南；另外八個風格型 Skill 使用 MiniMax Hub 的畫布節點與工具，不能直接移植到通用代理環境。安裝是否成功，只回答檔案有沒有被代理讀取，還沒回答模型、服務、權限和成品是否符合工作需求。
這會影響創作者要準備什麼：只整理提示詞，或還需要 API、雲端服務、模型權重與影音後製？可參考單卡 AI 影片工作流的硬體與流程條件，理解生成模型以外的執行環節；再把 Skill、代理和生成端分開驗收。
一、松音 H3 Skill 的工作流做了什麼？
官方倉庫列出的通用代理 Skill 是提示撰寫工具，附有不同模式的提示指南，不會自行呼叫外部 API。實際生成要交給 H3 模型、Hub 畫布或 API 工作流完成。
提示指南與生成工具不是同一層
Skill 是代理可讀取的指令與參考檔案，類似把特定任務的作法整理成可重用說明。MiniMax H3 官方 README 說明，h3-prompt-writing 使用 Markdown 和參考文件，沒有外部 API 呼叫；它協助代理依文字／關鍵影格或多模態參考模式整理提示。提示完成後，仍要把內容交給可用的模型或服務，才能取得影音檔。
倉庫另外列出的八個風格型影音 Skill 使用 Hub 的 hub_generate_video、hub_generate_image、畫布節點和選項卡等工具。官方指出這些 Skill 不適用通用代理環境。這表示「同一個倉庫有可安裝 Skill」不能推成「所有 Skill 都能在同一代理裡生成影片」。開始前應確認自己拿到的資料夾是哪個 Skill、面向哪種執行環境，而非只看專案名稱。
官方範例展示三種任務，不是獨立品質評測
MiniMax H3 官方倉庫提供三種可重現的 768p 影音生成案例：T2VA 以文字描述生成影片與音訊；FL2VA 以首格、尾格影像引導中間動作；Ref2VA 則以文字和多模態參考素材生成影音。這三個範例能證明官方文件提供了不同輸入模式的流程與結果連結，但不能代表每種素材、提示或代理環境都會得到相同品質。
官方示範的用處，是讓團隊把「想試試看」轉成可比較的任務：文字生成、關鍵影格延伸、參考素材生成各跑一次，記下輸入、模型模式、輸出檔和錯誤。再以同一套標準觀察主體是否一致、動作有沒有斷裂、音訊是否符合預期。這比只確認 Skill 能否載入，更能回答它能否進入工作流程。
「提示撰寫 Skill 是純 Markdown 與參考檔案，不含外部 API 呼叫。」（MiniMax H3 官方 README）
二、安裝前要先確認哪些模型與工具依賴？
先核對代理能否讀取該 Skill 的 SKILL.md 與參考檔，再確認生成服務、模型模式、憑證、授權和資料傳輸路徑各由誰提供。
代理是否支援 Skill 格式
官方 README 提供 npx skills add 安裝方式，將 h3-prompt-writing 從 MiniMax H3 倉庫加入代理。能讀取 SKILL.md 和本機檔案的環境可使用它。安裝後檢查代理是否讀到參考指南，再用短提示確認輸出格式；只看到 Skill 名稱，不代表指南已載入。
選擇影片 Skill 時，也要確認它使用的工具是否只存在於特定畫布。通用代理讀入 Hub 專屬節點或函式的指令，不代表能執行它們；需另找相容 API 或工具，並確認授權、金鑰和檔案交接。
生成能力來自模型服務或本地部署
模型負責產生結果；API 是代理與服務溝通的介面；連接器負責呼叫、憑證和回傳內容。託管 API 需要服務端點與金鑰，本機部署則需要模型權重、推論框架和運算資源。Skill 不會補上這些條件。
MiniMax 的官方 API 文件列有 H3 文字轉影片、首尾格影像轉影片、參考影片等輸入模式，並要求請求帶有文字提示。支援模式、解析度、片長等依模型版本而異，應以實際選用的文件為準。台灣使用者在接入前也要確認帳戶是否能啟用服務、付款方式、費用計算與地區限制；不要把倉庫公開或權重可下載，直接當成線上服務免費或本地運算需求很低。
權限、授權與素材處理要留下紀錄
安裝前列出代理可讀寫的目錄、金鑰可用服務，以及生成服務會收到的提示與素材。金鑰只給完成任務所需權限，並設定費用上限。使用外部服務前，查明素材傳輸、保存和刪除方式；客戶或未公開作品也要先確認上傳授權。
模型權重、Skill 程式碼和生成服務可能各有授權條件。檢查商用、衍生作品、第三方節點和後製程式的限制，並分別確認模型執行方式、API 計費和成品保存規則。「開源」不能代替這些核對。
「官方倉庫中的八個風格型影音 Skill 使用 Hub 畫布工作流，不能移植到通用代理。」（MiniMax H3 官方 README）
三、安裝完成後，怎麼驗收圖片與影片輸出？
用固定提示和素材分別測試文字生成、影格生成與參考素材生成，記錄每次輸入、檔案、耗時、錯誤與重跑結果，再由人工依用途檢查畫面和音訊。
固定輸入，讓重跑可以比較
先準備一份短測試卡，包含任務用途、提示文字、畫面比例、目標片長、指定參考素材，以及預期輸出格式。相同設定跑兩次，保留原始提示、代理產生的提示、服務回應、檔案名稱和錯誤訊息。若每次都臨時改提示或換素材，就很難分辨品質差異來自 Skill、模型版本還是輸入改變。
圖片驗收可以比較主體、構圖、文字和參考圖是否符合需求；若流程只有產影片而沒有獨立圖片輸出，就不要假設它包含通用 AI 生圖功能。影片則逐段檢查人物或物件是否變形、動作有無跳接、鏡頭是否按描述改變、字幕或可見文字是否錯誤，以及音訊和畫面是否同步。預先定義不能接受的缺陷，例如品牌標誌錯置或產品外觀變形，會比用「看起來不錯」作結論更能重複驗收。
看輸出之外，也要檢查流程是否可追溯
每個任務都應保留提示、模式、版本、素材、任務識別碼和結果檔。確認失敗原因是否可見、重試會否重複扣費或覆寫成品。官方 API 文件提供狀態查詢；整合時將任務狀態、下載檔及人工確認連在同一筆紀錄。
接入剪輯流程前，實測檔案格式、影音軌和後製軟體相容性。評估時也把影片重做與儲存成本及人工檢查、剪輯時間列入；檔案不能交給下一步，就還未通過驗收。
四、為什麼安裝成功仍可能接不進現有工作流？
因為 Skill 載入、模型呼叫、素材權限、輸出下載和後製交接是不同環節；其中任何一處未配置或未授權，代理就可能只寫出提示，無法交付成品。
錯誤要依發生位置分類
提示缺少資訊，先查 Skill 指南或輸入；認證錯誤查金鑰；生成失敗查服務狀態、額度和回應；檔案無聲或格式不合，則查下載和後製交接。記下錯誤所在層，再決定修正位置。
失敗也可能來自素材目錄權限、輸入超限、API 權限不足或非同步任務未處理。修正前保留原始輸入與錯誤回應，避免只留下「沒成功」的印象。
成本和維護責任屬於接入條件
試用成本還包括整理素材、人工挑選、重做和保存檔案。若 Skill 綁定特定服務或畫布，需指定介面、價格或授權改變時的維護者與回退方式。交付 API 金鑰時也限制目錄和操作範圍。
先界定要改善的是提示撰寫、素材轉交還是產出格式。若瓶頸在素材授權或剪輯交接，提示 Skill 未必能處理。指定責任人、停用方式和替代路徑，再判斷是否擴大試用。
五、用接入檢查表判斷是否進入小規模試用
在隔離環境確認代理讀得到 Skill、模型服務可呼叫、權限與費用有邊界、固定任務可重跑、輸出可檢查且有失敗回退方式，才進入小規模試用。
- 確認目標：列出要改善的步驟和交付格式。
- 盤點依賴：記錄 Skill、版本、代理、模型或 API、外部節點、金鑰權限及授權。
- 隔離素材：使用可公開或已授權素材，設定代理可讀目錄和費用上限。
- 跑固定任務：測文字轉影片及所需影格或參考模式；保存提示、結果與錯誤。
- 設定通過條件：依用途檢查畫面、動作、聲音、格式和後製交接。
- 記錄失敗回退：指定錯誤處理人、停用方式、成品保存和既有流程回切方法。
只有在這些條件能被重複檢查時，試用結果才可供團隊決策。若服務帳戶是否可用、素材如何保存或輸出品質標準尚未釐清，先把缺口補上再擴大範圍。這套檢查也適用於其他 Agent Skill：先問它負責哪一段工作，再確認剩下的模型、工具和人為檢查是否有人承接。
h3-prompt-writing協助撰寫 H3 提示，不等於生成端；其他風格型 Skill 依賴 Hub 畫布。- 官方提供的 T2VA、FL2VA、Ref2VA 案例是工作流範例，不能當成獨立品質評測。
- 用固定輸入記錄代理、服務、輸出和錯誤，再核對權限、資料處理、費用與回退方式。
常見問題
Q1：裝好 h3-prompt-writing 就能直接生成影片嗎？
不一定。官方文件將它描述為提示撰寫 Skill，不含外部 API 呼叫。仍需使用可生成影音的模型服務、Hub 工作流或其他相容工具。
Q2：不使用 MiniMax Hub，可以用官方 H3 Skill 嗎？
官方 README 說明，h3-prompt-writing 可供能讀取 SKILL.md 與本機檔案的代理使用；同倉庫另八個風格型影音 Skill 則使用 Hub 畫布工作流，不可視為通用代理 Skill。
Q3：驗收時只看影片畫面是否好看就可以嗎？
不夠。還要依用途檢查主體與參考素材一致性、動作連續、音畫同步、檔案格式、下載和後製交接，並保留任務與錯誤紀錄。
Q4：試用時可以上傳客戶影片或未公開素材嗎？
先確認素材授權，以及外部服務的傳輸、保存和刪除方式；同時限制 API 金鑰權限和代理可讀取的目錄。未釐清前使用可公開或已授權的測試素材。
