前言¶
电商详情页往往要同时满足平台规范、品牌视觉和卖点叙事：同一款 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
