前言¶
電商詳情頁往往要同時滿足平臺規範、品牌視覺和賣點敘事：同一款 SKU 要在 Amazon A+、Shopify 商品頁或旗艦店裏保持版式一致，又要拆成賣點、材質、場景、尺寸對比等多張模塊圖。設計外包週期長，內部用通用文生圖工具又難保證「三至六張圖」風格統一，也缺少可直接交給運營的版式說明。
下面介紹 SkillHub 上的 AI電商詳情頁模塊（@beatra-ai/ecommerce-detail-module-studio）：在已確認的 SKU 信息與商品照片基礎上，生成三至六張統一的 AI 電商詳情頁視覺模塊，並附帶敘事與版式說明，便於按頁面順序拼裝詳情。
這是什麼¶
AI電商詳情頁模塊 是 beatra 發佈的企業級 Skill（來源標註爲 enterprise），當前版本 0.1.9，SkillHub 分類爲 design-media。
它面向「詳情頁模塊化」這一具體環節：輸入側強調 已確認的 SKU 信息 和 商品照片；輸出側是 3～6 張風格統一的視覺模塊，以及 清晰的敘事與版式說明。官方簡介中列出的適用載體包括 Amazon A+、商品詳情頁、品牌旗艦店、Shopify 商品頁和新品活動頁；模塊類型可覆蓋商品賣點圖、材質細節、使用場景、尺寸或對比展示、包裝信息與品牌故事等，目標是讓用戶順着頁面理解商品。
SkillHub 頁面數據（以頁面展示爲準）：評分 100000，下載 13348 次；標籤標明 requires_api_key=true，使用前需準備對應 API Key。
- SkillHub 頁面：https://www.skillhub.cn/skills/beatra-ai/ecommerce-detail-module-studio
- API 資源地址：https://api.skillhub.cn/beatra-ai/ecommerce-detail-module-studio
核心功能¶
依據官方簡介，可覈實的能力如下：
- 模塊化出圖：在固定數量區間（三至六張）內生成詳情頁視覺模塊，而非單張海報式輸出。
- 信息輸入結構化：以已確認的 SKU 信息與商品實拍/產品圖爲前提，減少「憑空編造商品參數」的空間（具體字段以 Skill 內
SKILL.md爲準）。 - 敘事與版式說明：除圖片模塊外，輸出便於運營或設計落地的敘事順序與版式說明，方便對照平臺切片上傳。
- 場景類型覆蓋：賣點、材質、場景、尺寸對比、包裝、品牌故事等常見詳情模塊類型均在官方描述範圍內。
未在公開頁面單獨列出的能力（例如具體圖像模型、分辨率、是否自動摳圖）不在本文展開，安裝後請閱讀技能包內文檔。
安裝與啓用¶
SkillHub 推薦通過 skillhub CLI 安裝，並必須把技能裝到當前 Agent 能識別的 skills 目錄，否則默認會落到 ./skills/ 且可能不被加載。
1. 檢查或安裝 CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可使用官方安裝腳本（完整安裝含 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¶
官方頁面給出的安裝座標爲 @beatra-ai/ecommerce-detail-module-studio，並指向 SkillHub 安裝說明：https://skillhub.cn/install/skillhub.md。
將技能安裝到當前環境的 skills 目錄（--dir 需按實際 Agent 替換）：
skillhub install @beatra-ai/ecommerce-detail-module-studio --dir <skills 目錄>
常用客戶端的 skills 路徑示例（來自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使技能被加載。
3. API Key¶
SkillHub 標籤 requires_api_key=true 表示本 Skill 依賴外部 API。具體環境變量名、配置位置以技能包內 SKILL.md 及 beatra 相關說明爲準；在 Key 未配置完成前，圖像生成類步驟通常無法執行。
典型用法¶
公開頁面未提供逐條複製的對話示例，下面是根據官方簡介整理的、可復現的工作順序；細節約束以安裝後的 SKILL.md 爲準。
- 準備輸入：整理已確認的 SKU 信息（規格、賣點文案、尺寸等）以及可用的商品照片（主圖、細節、場景素材等）。
- 說明載體與模塊意圖：在對話中寫明目標頁面類型（例如 Amazon A+、Shopify 商品頁）以及希望覆蓋的模塊類型（賣點、材質、場景、對比、包裝、品牌故事等）。
- 指定模塊數量：在 3～6 張的範圍內說明需要幾張模塊，便於 Skill 控制敘事節奏與版式統一。
- 獲取交付物：接收生成的視覺模塊方案/圖片，以及敘事與版式說明，再按平臺切片規範上傳或交給設計微調。
若你使用 Cursor、Claude Code 等支持 Skills 的客戶端，也可將 SkillHub 頁面上的提示發給 Agent：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @beatra-ai/ecommerce-detail-module-studio。」由 Agent 按同一文檔完成 CLI 與目錄安裝。
適用場景與注意¶
適合誰
- 運營或品牌方：已有 SKU 定稿和產品圖，需要快速產出多套詳情模塊草案。
- 設計協作：需要統一視覺語言的多張模塊，並附帶版式說明以減少反覆對齊。
- 多平臺上架：同一商品要在 A+、獨立站、旗艦店等場景保持敘事一致。
限制與注意
- 企業來源（enterprise）：分發與授權策略以 SkillHub 與 beatra 爲準，安裝前留意來源與版本（當前 0.1.9）。
- API Key 必填：未配置 Key 時不要假設能直接出圖；先完成認證與計費相關配置。
- 輸入質量決定輸出：SKU 若未「已確認」，或照片與實物不一致，模塊圖容易偏離可上架標準；建議在生成前做一次信息覈對。
- 安裝目錄：務必使用
skillhub install ... --dir <skills 目錄>，避免裝到 Agent 不掃描的路徑。
結尾¶
AI電商詳情頁模塊 把「三至六張統一風格的詳情視覺模塊 + 敘事與版式說明」收斂成一個 Skill 工作流，適合在 SKU 與商品圖已就緒時加速詳情頁拼裝。安裝與優先源配置以 SkillHub 文檔爲準；技能詳情與下載入口：
https://www.skillhub.cn/skills/beatra-ai/ecommerce-detail-module-studio
