电商素材生图 by CreatOK

概述

E-Commerce Image Generator (CREATOK 版)

基于 25 个电商场景模板 的电商素材生图 Skill。识别用户意图 → 匹配场景模板 → 组装精简 Prompt → 通过 CreatOK CLI 调用生图模型，支持参考图一致性。

本 Skill 是 creatok CLI 的薄客户端：所有认证、上传、提交、轮询、产物持久化都由 CLI 完成，本 Skill 只负责意图理解、模板匹配、Prompt 组装和读取 CLI 的 JSON 输出。不要直接调用 HTTP 接口。

前置检查（强制，第一步）

开始任何生图任务前，先运行：

creatok doctor

按以下分支处理（该命令输出一个 JSON envelope，可能带 update 字段）：

A. CLI 不存在 → 引导安装（重要）

如果提示 command not found / creatok 不是内部或外部命令，说明本机没有安装 creatok CLI，停止生成，引导用户安装：

1. 确认是否有 Node.js 18+：运行 node --version。没有则先引导安装 Node.js LTS（https://nodejs.org）。
2. 安装 creatok CLI（任选其一）：
   • 通用方式（Windows / macOS / Linux）：

“bash npm install -g @creatok/cli “

• macOS / Linux 快捷脚本：

“bash curl -fsSL https://get.creatok.ai/install.sh | sh “

1. 重启终端 / 重启 Agent，让 creatok 进入 PATH（Windows 下新装的 npm 全局命令通常需要新开终端）。
2. 重新运行 creatok doctor 验证，然后继续。

给用户的说明要务实、非技术化，不要贴一堆错误细节。

B. 认证问题 → 引导配置 API Key

如果 data.api_key_configured 为 false，或 error.kind 为 auth：

1. 引导用户到 https://www.creatok.ai/app/workspace/api-keys 生成 API Key（格式 ok_xxx）。
2. 配置环境变量（stable 通道用 CREATOK_API_KEY；preview 通道用 CREATOK_API_KEY_PREVIEW，两者互不通用）：
   • Windows：setx CREATOK_API_KEY "ok_xxx"（之后需要重开终端）
   • macOS / Linux：echo 'export CREATOK_API_KEY="ok_xxx"' >> ~/.zshrc && source ~/.zshrc
3. 配置完成后重新运行 creatok doctor。

C. 版本更新提示

如果输出含 update: { "available": true, ... }：告诉用户有新版本（update.latest），询问是否更新，用户同意后运行 creatok update --apply。用户拒绝则继续用当前版本。

D. Skill 漂移

如果 data.skills_drift 为 true：本地安装的 creatok 官方 skill 与 CLI 不同步，运行 creatok skills install 重新同步后继续。

工作流

Step 1: 意图识别

从用户请求中提取：

• 场景类型（Scene type）：hero image / lifestyle / flat lay / macro detail / poster-banner / social media / UGC / model showcase / before-after / packaging / infographic / creative concept / size spec / multi-product / livestream / virtual try-on / exploded view / ghost mannequin / multi-angle grid / magazine editorial / seasonal campaign / luxury atmospherics / device mockup / storefront / sports campaign
• 产品信息（Product info）：品类（beauty/electronics/food/fashion/home/jewelry/sports）、外观描述、材质、核心卖点
• 风格偏好（Style）：luxury / fresh / tech / minimal 或其他变体
• 参考图：用户是否提供了产品照片路径；以及参考图的用途（见下方「参考锁定」）：
  • 默认（电商主图/产品一致性场景）→ 身份锁定（identity lock）：产品外观必须与参考图完全一致
  • 用户说"参考这个风格/感觉/色调" → 风格参考（style reference）：只参考风格氛围，不锁定产品外观
  • 不确定时按身份锁定处理，并在确认时向用户说明

Step 2: 模板匹配

读取 references/templates/ 下匹配的模板，按关键词和触发短语匹配：

无匹配 → 默认 01-hero-image.json。

只读取匹配到的模板文件（渐进式加载），不要一次加载全部 25 个模板。

Step 3: Prompt 组装

基于匹配到的模板 JSON：

1. 以 prompt_template 字段为骨架（subject 替换为用户产品描述）。
2. 用户指定风格变体 → 应用 variants.<name>.overrides。
3. 已知产品品类 → 追加 category_tips.<category>。
4. 若模板有 anti_ai_tips（UGC/直播/社媒场景）→ 必须并入。
5. 组装成一段精简、流畅的英文自然语言 Prompt（不要输出完整模板元数据，不要字段堆砌）。

组装示例（护肤品白底主图，高端风格）：

Professional product photography of frosted glass serum bottle with matte white cap,
premium gradient background from dark to light, Rembrandt lighting with subtle rim light,
centered front view composition, 8K commercial e-commerce photography quality.
Emphasize texture and glow, show formula details.

关键原则：Prompt 保持简单。 只保留必要信息，自然语言描述句优于关键词罗列。CREATOK 生图模型对简洁聚焦的描述响应最好。

有参考图时：最终 prompt = 组装好的描述 + 参考锁定块（见「参考锁定」一节），锁定块直接拼在 prompt 末尾。

Step 4: 生图参数解析（运行时能力）

运行：

creatok capabilities

• 读取 default_model 作为默认模型（当前为 nano-banana-2）；只有用户明确指定其他受支持模型时才更换。
• 模型选择建议：模型列表通常包含 gpt-image-2-official（GPT Image 2）——本 Skill 的模板与提示词是为 GPT-Image 风格调优的，若用户希望最大程度还原原版 GPT-Image-2 效果，生成前确认时可推荐该模型。
• 读取模型的 limits（分辨率、宽高比、数量 n、参考图上限）校验参数。
• 用户没指定的参数（分辨率/宽高比/n）省略，交给 CLI 默认值，不要自行硬编码。

Step 5: 参考图上传（如适用）

用户提供本地参考图时，逐个上传为正式资产：

creatok assets create --type image --file "<绝对路径>"

• 解析每个 data.asset.object_key，按输入顺序收集到 imageObjectKeys。
• 之后用这些正式 key 提交，不要再把本地文件传给生成命令（避免重复建资产）。
• 资产创建发生在付费确认之前；即使用户最后取消，已建资产仍会占用媒体库空间，无需特别向用户强调，但流程上要知道。
• 上传前先确认参考图用途（身份锁定 / 风格参考），见下方「参考锁定」。

参考锁定（Reference Lock）

当用户提供了参考图且意图是身份锁定（默认）时，必须启用参考锁定：让生成结果的产品外观严格对齐参考图，只允许展示方式变化。

CLI 层目前没有独立的 reference-lock 参数（reference_roles 仅区分 avatar / reference），因此锁定在 prompt 层实现——把以下锁定块拼接到最终 prompt 末尾，模型无关、最可靠。

锁定块（拼接在 prompt 末尾）

REFERENCE LOCK: The product in the output MUST be identical to the product in the
reference image — same design, silhouette, color, material, texture, logo, stitching
and proportions. Do NOT redesign, restyle, recolor, add, remove or substitute any
product feature. Only the presentation may change: pose, scene, lighting, angle,
background or surrounding styling.

锁定 vs 可变维度

锁定强度分级

按用户意图选择，默认 L2：

• L2 身份锁定（identity lock，默认）：产品外观与参考图完全一致，只换展示。使用上面的锁定块。
• L1 风格参考（style reference）：用户说"参考这个风格/感觉/色调"时，不锁产品外观，改用：

  STYLE REFERENCE: Match the overall mood, color palette and photographic style of
  the reference image. The subject/product itself may differ.

• L0 无锁定：用户没给参考图，或明确表示"自由发挥"，不注入任何锁定块。

多参考图

• 多张参考图时，第一张视为产品身份主参考（锁定主体），其余作为辅助（材质、细节、场景）。
• 在锁定块中显式声明主参考：

  REFERENCE LOCK: Primary reference image defines the exact product identity; the
  other reference images only inform texture/detail/context. Product must match the
  primary reference exactly.

确认时说明

在 Step 6 确认门中，向用户说明采用的锁定级别（如"已启用身份锁定：产品外观与参考图严格一致，仅展示方式变化"），让用户有机会改为风格参考或解除锁定。

Step 6: 生成前确认（强制付费门）

生成是付费操作，必须征得用户确认。向用户简要说明：模型、分辨率、数量（n）、宽高比（如指定）、参考图数量，然后询问是否开始。用户明确同意前不要运行 creatok image。

Step 7: 生成

creatok image --prompt "<组装好的 prompt>" --options '<json>' --out <输出目录>

• 需要参考图时，options 里带上 imageObjectKeys：

  creatok image --prompt "..." --options '{"model":"<默认模型>","resolution":"2K","n":1,"aspect_ratio":"1:1","imageObjectKeys":["<asset_key_1>"]}' --out ./generated

• Windows PowerShell 下 inline JSON 引号容易出错：优先把 options 写入临时文件再传入：

  creatok image --prompt "..." --options-file options.json --out ./generated

• 除 --prompt 之外的参数（模型、分辨率、n、宽高比、imageObjectKeys 等）一律放 --options 里，不要发明 CLI 不存在的 flag。
• CLI 会负责提交、轮询到完成、持久化产物；Skill 不关心轮询细节。

Step 8: 响应与产物处理

• 解析 stdout 的 JSON envelope。
• 成功：data.result.images[].url 原样返回给用户（URL 是最终交付物）。CLI 同时把产物写到 artifacts.dir，result.json 可用于恢复，如需本地交付可把图片复制到用户指定目录并起个描述性文件名。
• 失败：根据 error.kind 给出对应指引：

• 同一对话中多次提交失败时，提示用户本地 skill 可能过期，可到 https://www.creatok.ai/agent-skills 升级后重试。

Step 9: 任务恢复（可选）

用户已有 task_id 且想查进度/结果时，不要重新生成：

creatok status --task <id> --type image_generation [--wait]

• 恢复模式不需要用户重述 prompt。
• 成功 → 返回 data.result.images[].url；排队/运行中 → 说明状态并询问是否继续等待；失败 → 说明原因并建议下一步。

反 AI 感提示（UGC / 直播 / 社媒场景）

生成 UGC、直播、社交媒体内容时这些规则很关键：

• 指定具体手机型号：iPhone 14 Pro、iPhone 15 Pro
• 加入可见瑕疵：毛孔、轻微噪点、暖色偏、不完美构图
• 用口语化描述：NOT professional photography、NOT AI-generated look
• 真实环境：略微凌乱、真实物件、水渍、用过的毛巾
• 胶片色调参考：Kodak Portra 400 color feel
• 明确写出：NOT retouched, NOT smoothed
• 避开 AI 感词汇：不用 perfect、flawless、stunning、hyper-realistic

Prompt 编写原则

• 简洁为王：只传核心信息，不过度约束
• 自然语言优先：模型理解描述性句子优于关键词堆砌
• 材质描述：明确写出纹理（磨砂玻璃、拉丝金属、哑光质感）
• 光照很重要：始终包含光照方向和质感
• 善用参考图：传入产品图可显著提升一致性

转交（Skill Handoff）

当用户后续需求更匹配其他 CREATOK skill（如视频生成、数字人口播、图片增强等）时，转交对应 skill 并携带已确认的产品信息与生成方向，不要让用户重复描述。

中文内容完整性门

使用本 Skill 前若需要读取含中文的参考文件，先确认中文内容可读、完整（无乱码/替换字符），否则用 UTF-8 安全方式重新读取后再继续；无法恢复时停止并告知用户本地文件读取异常。