前言¶
電商和本地門店常見需求是：主圖旁邊要一條能講清楚賣點的主圖視頻，或一條能直接發抖音、小紅書的種草短片。傳統做法要拍素材、寫腳本、配音、剪輯，週期和成本都壓在運營或小團隊身上。若你已經在用 Agent 處理文案和素材整理，更希望把「從商品圖到成片」收成一條可重複的工作流，而不是每次從零搭時間線。
下面介紹 SkillHub 上的 商品視頻工作室（@beatra-ai/product-video-studio）：從一張商品圖出發，生成帶口播的 9:16 豎屏視頻，適合上架、主圖視頻和門店推廣等場景。
這是什麼¶
商品視頻工作室 是 beatra 發佈的企業來源 Skill（SkillHub 分類：design-media，當前版本 0.2.1）。座標爲 @beatra-ai/product-video-studio。
它解決的是：在不上傳拍攝素材、不手工剪輯的前提下，用一張商品圖加上你補充的商品信息，產出一條可發佈的豎屏帶貨短視頻。官方說明中的處理順序是：先做 9:16 豎屏首幀，再根據畫面可見細節與商品信息撰寫口播文案，選配聲音後合成成片。
SkillHub 標籤標明 requires_api_key=false，即按頁面說明安裝使用時不需要單獨配置 API Key（具體以你當前 Agent 環境與 Skill 包內說明爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在頁面上單獨展開的能力不寫入。
- 豎屏首幀：以你提供的商品圖爲輸入，生成 9:16 豎屏畫面的首幀，適配短視頻豎屏規格。
- 口播文案：結合圖中可見細節與你提供的商品信息，生成適合口播的帶貨文案。
- 配音與成片：選擇合適的聲音完成配音，輸出一條帶口播、可直接用於發佈的視頻。
適用方向在官方文案中包括：新品上架、商品主圖視頻、種草短視頻、門店推廣，以及把隨手拍的商品照片變成帶貨視頻。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓當前 Agent 按官方安裝文檔執行，目標 Skill 爲 @beatra-ai/product-video-studio。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已安裝：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需要 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法加載。常見路徑如下（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例（將 <skills 目錄> 換成你環境中的實際路徑）：
skillhub install beatra-ai/product-video-studio --dir <skills 目錄>
也可在對話中直接發給 Agent 的提示（與 SkillHub 技能頁一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@beatra-ai/product-video-studio`。
安裝後按你所用 Client 的要求重啓或刷新 Agent，使新 Skill 生效。Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄路徑 上，安裝步驟本身均遵循上述 skillhub install 與官方 install 文檔。
典型用法¶
公開頁面未提供帶固定參數的命令行示例；本 Skill 基於通用 SKILL.md 格式，實際交互在 Agent 對話中完成。可按官方描述的工作流復現如下。
- 準備輸入：一張清晰的商品圖（主圖、實拍或門店照片均可），以及口播需要的商品信息（名稱、賣點、價格或活動、適用人羣等——以你在對話中提供給 Agent 的內容爲準）。
- 啓用 Skill：確認
@beatra-ai/product-video-studio已安裝並被 Agent 加載。 - 發起任務：在對話中說明要生成豎屏帶貨視頻，附上商品圖，並寫明希望強調的信息；若需要特定音色或風格，在同一輪說明中提出（具體可選聲音以 Skill 運行時的能力爲準，頁面未枚舉時不臆造選項列表）。
- 驗收成片：按 Skill 輸出獲取生成的視頻文件或路徑，檢查畫面比例是否爲豎屏、口播是否與商品信息一致，再用於上架或發佈。
經過上面的步驟，你完成的是「圖 + 商品信息 → 9:16 口播成片」的閉環，而不是在剪輯軟件裏從零搭軌道。
適用場景與注意¶
適合誰
- 需要快速做商品主圖視頻、上新短視頻的電商運營或店主。
- 內容團隊要把已有商品圖擴展成口播種草片，但不想每次走完整拍攝剪輯流程。
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望把帶貨視頻生成嵌進現有 Agent 工作流。
使用上需注意
- 成片質量依賴商品圖清晰度、以及你補充的商品信息是否準確完整；圖中看不清的細節，口播不應指望憑空補全。
- 版本以 SkillHub 爲準（當前 0.2.1）；升級可用
skillhub按同一--dir策略更新，具體子命令以 install 文檔爲準。 - 企業來源 Skill，使用前請確認你所在環境對 SkillHub 與企業技能包的合規要求。
- 頁面統計（截至資料抓取）：SkillHub 評分 100000，下載 14049 次，可作爲選用參考，不代表單次生成效果保證。
結尾¶
商品視頻工作室把「豎屏首幀 → 口播文案 → 配音成片」串成一條從商品圖出發的鏈路，適合把主圖和隨手拍照片快速變成可發佈的帶貨短視頻。安裝與座標以 SkillHub 爲準。
- SkillHub 技能頁：https://www.skillhub.cn/skills/beatra-ai/product-video-studio
- 官方 API 座標頁：https://api.skillhub.cn/beatra-ai/product-video-studio
- 安裝說明：https://skillhub.cn/install/skillhub.md
