先保护真实 SKU，再做不套模板的电商详情页
真实产品保真 · 三阶段决策 · 防同质化生产 · 逐屏商业图
下载 V1.3 全平台合集 · 安装说明 · 查看示例 · 公共安全规则
KeRo SKU Skill 是一组用于 真实 SKU 商品事实分析、平台路由、详情页策划与 AI 视觉生产 的 Codex Skills。
它的核心不是让 AI 直接“发挥想象”生成商品图，而是先保护真实产品，再把电商详情页拆成可控流程：
上传真实产品图
↓
sku-product-core：产品事实与保真分析
↓
kero总路由：识别平台与素材槽位
↓
淘宝 / 天猫 / 拼多多 / 京东 / 1688
Amazon / Shopify / TikTok Shop 专用 Skill
↓
平台原生素材方案、Prompt 与质检
V1.3 开发版不再把平台差异简化为视觉风格，而是分别处理各平台的素材槽位、商品数据、采购逻辑、网页结构和合规要求。
| Skill | 主要职责 |
|---|---|
$sku-detail-page-director |
平台未知、旧版兼容和多平台路由 |
$sku-product-core |
事实、证据、保真模式和跨平台 SKU_CONTEXT |
$sku-taobao |
淘宝主图、轮播、SKU 属性图和详情模块 |
$sku-tmall |
天猫品牌、资质、SPU/SKU 和品牌详情 |
$sku-pinduoduo |
拼多多 SKU—价格—图片一致性与详情素材 |
$sku-jd |
京东参数、兼容性、包装、服务和专业详情 |
$sku-1688 |
1688 MOQ、阶梯价、定制、生产交付和询盘 |
$sku-amazon |
Amazon Main Image、附图、A+ 和 Brand Story |
$sku-shopify |
Shopify PDP sections、媒体、变体、SEO 和 CTA |
$sku-tiktok-shop |
TikTok Shop PDP、变体图、广告源图和内容交接 |
- 电商运营：需要快速判断一个 SKU 详情页怎么做。
- 设计师：需要把产品图拆成可执行的视觉方向和分屏方案。
- AIGC 创作者：需要更安全、更稳定的商品图 Prompt。
- 跨境卖家：需要 Amazon A+、Shopify、TikTok Shop 商品图方向。
- 批量上新团队：需要避免所有 SKU 都长得像同一套模板。
| 你的需求 | 建议入口 |
|---|---|
| 第一次安装 Skill | 安装说明 |
| 换新电脑后在 Codex 使用 | 新电脑安装与迁移 |
| 不知道怎么启动 | 第一次使用 |
| 想看完整流程 | 三阶段工作流 |
| 想做淘宝详情页 | 淘宝移动端详情模块示例 |
| 想做 Amazon A+ | Amazon A+ 示例 |
| 想看同一 SKU 的平台差异 | V1.3 跨平台墨镜示例 |
| 查看八个平台前向测试结果 | V1.3 前向测试报告 |
| 想做墨镜类商品图 | 墨镜详情页示例 |
| 想参考竞品但不想侵权 | 安全参考竞品示例 |
| Skill 没有触发或产品变形 | 常见问题 |
| 想了解商用边界 | 安全与使用边界 |
只分析产品，不输出正式生图 Prompt。
这一阶段会判断：
- 图片里能确认的产品事实。
- 哪些信息不能编造。
- 产品适合严格保真、AI 辅助商品图，还是概念生成。
- 类目中常见的同质化套路。
- 这个产品自己的视觉记忆点。
- 下一步只需要你确认的一个关键决策。
识别平台和素材槽位，再由对应平台 Skill 给出二至三个商业任务明显不同的方向。A/B/C 只是选择标签，不再固定等于功能、场景和高端。
每个方向会说明：
- 目标平台、地区、类目和素材槽位。
- 该平台真正需要解决的购买或采购问题。
- 页面、模块或媒体顺序。
- 未来每个素材大概长什么样。
- 如何避开常见模板感。
- 优点、风险和推荐程度。
只有你确认方向后，才进入主图、轮播、SKU 图、详情模块、A+、PDP section 等对应资产生产。
正式生产阶段的每一屏、每个图片槽位、A+ 模块或含媒体的 PDP section 都必须完整输出 Prompt、Negative Prompt、产品处理模式、文案位置、后期排版、镜头矩阵、产品一致性质检和通用 Prompt 拦截；不会因为平台 Skill 拆分而降低旧版逐屏生产深度。
每一屏会包含：
- 素材槽位和商业任务。
- 构图说明。
- 文案方向。
- 生图 Prompt。
- Negative Prompt。
- 产品保真要求。
- 文字安全区或真实网页组件要求。
- 一致性质检点。
V1.3 完整版由 10 个 Skill 组成：1 个统一入口、1 个产品事实核心和 8 个平台专用 Skill。只安装旧版 SKU详情页导演Skill.skill 不等于安装完整套件；该文件现在只承担兼容路由。
完整安装后应包含：
sku-detail-page-director
sku-product-core
sku-taobao
sku-tmall
sku-pinduoduo
sku-jd
sku-1688
sku-amazon
sku-shopify
sku-tiktok-shop
在 Codex 新任务中粘贴以下指令：
请使用 $skill-installer，从公开 GitHub 仓库
https://github.com/Youks7/KeRo-SKU-skill
的 main 分支安装以下 10 个 Skill：
1. SKU详情页导演Skill/sku-detail-page-director
2. skills/sku-product-core
3. skills/sku-taobao
4. skills/sku-tmall
5. skills/sku-pinduoduo
6. skills/sku-jd
7. skills/sku-1688
8. skills/sku-amazon
9. skills/sku-shopify
10. skills/sku-tiktok-shop
要求：
- 安装到当前用户的 Codex Skills 目录；
- 不要只安装旧版 SKU详情页导演Skill.skill；
- 安装后检查每个目录中是否存在 SKILL.md；
- 列出最终安装的 10 个 Skill 名称和路径；
- 如果同名目录已经存在，不要直接覆盖，先检查并报告版本冲突。
安装完成后，新建一个 Codex 任务再开始使用。新任务仍未识别时，再重启 Codex App。
下载并解压合集，再导入其中的独立 .skill 文件：
如果当前 Codex 版本提供 Import Skill 或 Upload Skill，应导入全部 10 个独立 .skill 文件，不要把外层合集 ZIP 或旧版兼容包误当成完整套件。
已安装 Git 的 Windows 用户可以在 PowerShell 中执行：
git clone https://github.com/Youks7/KeRo-SKU-skill.git
$source = Resolve-Path ".\KeRo-SKU-skill"
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$destination = Join-Path $codexHome "skills"
New-Item -ItemType Directory -Path $destination -Force | Out-Null
Copy-Item `
-LiteralPath "$source\SKU详情页导演Skill\sku-detail-page-director" `
-Destination $destination `
-Recurse `
-Force
Get-ChildItem -LiteralPath "$source\skills" -Directory | ForEach-Object {
Copy-Item -LiteralPath $_.FullName -Destination $destination -Recurse -Force
}如果 Windows Git 报出 SEC_E_NO_CREDENTIALS，可改用：
git -c http.sslBackend=openssl clone https://github.com/Youks7/KeRo-SKU-skill.git仓库是公开仓库，只下载和使用不需要 GitHub 登录；只有修改后需要推送时才需要配置 GitHub 凭据。
更详细的安装和排错说明见 docs/INSTALL.md 与 docs/TROUBLESHOOTING.md。
换电脑时不要只把 GitHub 仓库作为普通项目打开。打开仓库可以让 Codex 阅读文件，但要让这些工作流在其他任务中被 $skill-name 调用，仍需按上面的推荐方法把 10 个 Skill 安装到新电脑的 Codex Skills 目录。
建议迁移顺序：
- 在新电脑安装并登录 Codex。
- 使用方法一从
main分支安装全部 10 个 Skill。 - 新建 Codex 任务，让新安装的 Skill 被重新发现。
- 运行下面的完整性检查。
- 上传真实产品图片，并从
$sku-detail-page-director开始工作。
在 PowerShell 中验证安装：
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$expected = @(
"sku-detail-page-director",
"sku-product-core",
"sku-taobao",
"sku-tmall",
"sku-pinduoduo",
"sku-jd",
"sku-1688",
"sku-amazon",
"sku-shopify",
"sku-tiktok-shop"
)
$expected | ForEach-Object {
$skillFile = Join-Path $codexHome "skills\$_\SKILL.md"
[pscustomobject]@{
Skill = $_
Installed = Test-Path -LiteralPath $skillFile
SkillFile = $skillFile
}
}正确结果是 10 项的 Installed 全部为 True。如果缺少任意平台 Skill，导演入口可以识别平台，但不能保证进入对应平台的完整生产规则。
以后需要更新时，让 Codex 先备份本机同名 Skill、比较版本，再从 main 重新安装全部 10 个目录；不要只更新导演入口，也不要在未检查差异时静默覆盖本地修改。
推荐只记住一个入口。上传真实产品图后，发送：
请使用 $sku-detail-page-director 从我上传的真实产品资料开始，
在同一任务中完成事实分析、平台识别和方向提案。
不要让我重复调用其他 Skill；方向确认前不要输出正式生图 Prompt，
不要编造无法确认的规格、材质、认证、功效或评价。
总导演会在内部复用 $sku-product-core 和命中的平台 Skill。高级用户已经知道平台时，也可以直接调用专用 Skill：
请使用 $sku-amazon 基于我的真实产品资料规划 Amazon US Listing Images 和 A+ Content。
先核对 Main Image、附图和 A+ 的不同规则，再给方向。
| 模式 | 适合场景 | 产品处理方式 |
|---|---|---|
| A 严格保真 | 品牌款、高客单、外观必须完全一致 | 使用真实产品抠图，AI 只生成背景、场景、光影和留白 |
| B AI 辅助商品图 | 平台与槽位允许、且有足够真实参考图的快速生产 | 基于指定真实产品图做有限背景替换或场景化生成；关键细节变化时退回模式 A |
| C 概念生成 | 新品提案、方向测试、没有实物图 | 只用于概念探索，不能当作真实 SKU 成品图 |
- 真实产品图是唯一产品身份来源。
- 不编造品牌、规格、尺寸、材质、认证、功效、评价和售后承诺。
- 材质无法确认时，只能描述“可见质感”“视觉上接近”或“真实材质待确认”。
- 不改变真实 SKU 的颜色、结构、比例、Logo、包装文字和关键细节。
- 竞品图只参考构图、节奏和信息结构，不复制产品、Logo、文案和品牌资产。
- AI 图像模型不负责最终文字、Logo、参数表、认证标识和 CTA，这些建议后期排版并人工校对。
SKU详情页导演Skill/
├── sku-detail-page-director/
│ ├── SKILL.md
│ ├── agents/openai.yaml
│ └── references/
└── SKU详情页导演Skill.skill
skills/ 公共产品核心与八个平台独立 Skill
shared/ 构建时同步的公共安全、状态和质检规则
scripts/ 同步、校验、素材检查与安装包构建
tests/ Skill 触发回归语料
packages/ 独立 .skill 包和全平台合集
docs/ 安装、排错、安全边界和 GitHub 设置说明
examples/ 典型电商场景使用示例
assets/ 仓库封面和展示素材
website/ 可选静态网站
当前开发版本：V1.3.0-dev 多平台 Skill 拆分版
稳定基线版本：Lite V1.2.1，已由 Git Tag v1.2.1 保留。
版本变化见 CHANGELOG.md。
后续规划见 ROADMAP.md。
本仓库的 Skill、文档、规则和示例文字可以用于学习、参考和非商业使用。
如果你引用或改编本仓库内容，请注明来源并链接回本仓库。
请不要直接搬运本仓库内容进行商业转卖。
仓库中涉及的第三方平台名称、商标、产品名和工具名，仍归各自权利人所有。
秋水 Kero，AIGC 创作者，持续分享 AI、图片和电商视觉工作流。
X（推特）：@Isonlyonenice