---
name: sku
description: mayagi-ops 跑款入口 (款号→抖店上架). 用户说「/sku <款号>」「跑 <款号>」「上架 <款号>」「生 <款号>」时触发. 加载流程图 + 决策树 + 6 条核心铁律速查（Ref = #1 权重）. 详细操作分 4 个子 skill (sku-fetch / sku-generate / sku-htmlpage / sku-deploy).
---

# SKU 跑款入口 — mayagi-ops 款号 → 抖店上架

> 入口 skill. 触发后给流程图 + 跳转到具体阶段的子 skill. **详细操作不在本文件**.

---

## §1 触发词

`/sku <款号>` · `跑 <款号>` · `上架 <款号>` · `生 <款号>` · `<款号> 全套图`

---

## §2 端到端 6 步流程

```
┌─────────────────┬─────────────────────────────┬──────────────────┐
│ 步骤            │ 子 skill                    │ 时间 / 成本       │
├─────────────────┼─────────────────────────────┼──────────────────┤
│ 1. 扒 go2 图包  │ Skill(sku-fetch)            │ ~5min / 反爬节流  │
│ 2. 选 ref       │ 主对话看图选 (§4 流程)       │ ~5min / 0        │
│ 3. 生 PDP+Model │ Skill(sku-generate)         │ ~6-8min / $0.24   │
│ 4. 写详情页 HTML│ Skill(sku-htmlpage)         │ ~10min / 0        │
│ 5. 派生+部署+打包│ Skill(sku-deploy)           │ ~5min / 0         │
│ 6. 抖店上架     │ Skill(sku-deploy) §7        │ ~10min / 0        │
└─────────────────┴─────────────────────────────┴──────────────────┘
全流程 ~40min / $0.24 vip × 8 张
```

---

## §3 子 skill 决策树

| 用户意图 | 触发 | 备注 |
|---|---|---|
| "扒 go2 图包 X" / "下载 X" | `Skill(sku-fetch)` | 包含验证码处理 + GBK 解压 |
| "生 PDP" / "生 model" / "重跑 X" / "跑款" | `Skill(sku-generate)` | ⭐⭐⭐ 跑款最常用 |
| "写详情页 HTML" / "跑 HTML X" | `Skill(sku-htmlpage)` | 13 段模板 + 字体 + 命名 |
| "派生 1:1" / "打包发老婆" / "部署 X" / "上架 X" | `Skill(sku-deploy)` | PIL 派生 + Playwright + ECS + 抖店 |

---

## §4 ⭐⭐⭐⭐⭐ Ref 选图 = 跑款 #1 权重（用户铁律）

**用户原话**："**事实证明所有图都是我们选参考图的技术. 选参考图最重要, 权重最高. 参考图选不好, 操作不好, 后面的图全部出问题**."

90% 的输出问题都是 Ref 选错 / crop 错 / 跨类型用. **Ref 选不对, prompt 怎么写都救不回**.

### 6 条核心铁律（按 Ref 权重排序，详见 [Skill(sku-generate)] §1）

1. **Ref 处理** — Crop OK / Resize 拉伸禁止 / 必须含完整鞋边缘 + 完全裁干净其他色
2. **AI 跟 ref 同角度** — 没真 overhead → 别跑 top_down. 视角不必恒定
3. **PDP 用纯鞋 ref / Model 用上脚 ref** — 跨用 = 鞋角度拗歪
4. **永远不描述鞋** — 连 `sandals` / `Tabi cleft` / 跟形都不写
5. **图片 > 语言** — AI 看 ref 学最准
6. **鞋角度 + Pose 全链路守恒** — Model 只换人脸 + 环境，pose / framing / 鞋角度 100% 跟 ref

**违反任何一条 = 鞋型必偏移**.

---

## §5 模型选图流程（每款必走）

go2 图包扒完后, 主对话亲自看图选 ref（不靠脚本）：

```
Step 1 · ls 单图/ + 主对话 Read 所有候选 source
Step 2 · 给每张 source 标实际角度 (pure 90° / 3/4 / high-angle / overhead / 上脚)
Step 3 · 列 "目标视角 → source 映射表" 给用户审
Step 4 · 用户拍板 → PIL.crop 让鞋占 80%+ (不改比例 / 不 resize)
Step 5 · refs 入库 data/skus/<SKU>/refs/
```

⚠️ **没真 overhead source → 不跑 top_down**（按 §4 铁律 2）.

---

## §6 自审 → 用户审流程

**默认 §6.1 批量审**（mayagi-ops 不走 MVP, 跑款是全套图）.
**例外 §6.2 一张一张审**：用户明说 / BG anchor 校准等高风险场景.

### 6.1 批量自审

1. 完整套图跑完 → 主对话/subagent **先自审一遍**（不给用户）
2. 自审发现问题 → 立即重跑那张
3. 自审通过 → 给用户审（公网 URL + zip + 简要总结）
4. 用户审有问题 → 指哪张哪个问题 → 单张重跑
5. 用户审 OK → 部署 / 发老婆

### 6.2 SendMessage 中途纠正 subagent

subagent 跑款时主对话发现错 → 立即 `SendMessage(to=agent_id, message=...)` → subagent 自主审已跑出的图 → 决定重跑.

---

## §7 SKU 上架清单（2026-05 批次）

> 图包状态会变化，跑款号前先看本段.

### 黑妹档口（HM 前缀，10 款）

| # | 款号 | 缩略图判断 | 图包 | 跑款状态 |
|---|---|---|---|---|
| 1 | HM6995 | 深色凉拖 | ✅ 已扒 | baseline 跑过, 待按新铁律重跑 |
| 2 | HM6981 | 浅色编织凉鞋 | ❌ | — |
| 3 | HM6975 | 米浅色凉鞋 | ❌ | — |
| 4 | HM6965 | 深色高跟鞋 | ❌ | — |
| 5 | HM6128 | 棕色编织平底 | ❌ | — |
| 6 | HM6125 | 深色金属扣件凉鞋 | ✅ | baseline 跑过, 待重跑 |
| 7 | HM6124 | 红棕色平底 | ✅ | baseline 跑过, 待重跑 |
| 8 | HM6101 | 棕红色单鞋 | ❌ | — |
| 9 | HM2058 | 棕色 T 字带凉拖 | ✅ | baseline 跑过, 待重跑（隙影/CLEFT 命名）|
| 10 | HM2044 | 双色平底 | ❌ | — |

### Rich1991 档口（5 款预售）

| # | 款号 | 图包 | 跑款状态 |
|---|---|---|---|
| 11 | S7763 | ✅ | baseline 跑过, 待重跑 |
| 12 | L7825 | ✅ | **完整闭环** 2026-05-15（玳影/TORTOISE）|
| 13 | D7799 | ❌ | — |
| 14 | D7753 | ❌ | — |
| 15 | D7737 | ❌ | — |

---

## §8 跨项目家族

| 项目 | 路径 | 角色 | 边界 |
|---|---|---|---|
| **mayagi** | `~/mayagi/` | 选款 + anchors + wife_rating | 只读 mayagi.* |
| **mayagi-warehouse** | `~/mayagi-warehouse/` | 样鞋仓储 + 退货 | 只写 wh_* |
| **mayagi-ops** ⭐ | `~/mayagi-ops/` (本项目) | 款号 → 上架 | 只写 ops_* |
| 跨项目 | HTTP API | go2 / 老时光独立服务 | 不抽共享 Python 包 |

---

## §9 抖店与 MAYAGI 抖音号

- **主号**：MAYAGI 企业蓝 V 8554 粉 — **mayagi-ops 唯一服务对象**（不要再提废弃号「琪琪.」）
- **店铺**：`https://fxg.jinritemai.com/`
- **店铺类型**：现状「链接店铺」，目标升级「品牌旗舰店」（条件：自家商标 + 工厂资质）
- **业务模型**：全代发 / 15 天预售必开 / 实际成交率 33% 基线（详 [[project-business-model]]）

---

## §10 公网部署

`https://files.beacon.xin/mayagi-brand/products/<款号>/`（ECS `8.137.166.176`，详 [Skill(sku-deploy)] §5）.

---

## §11 工程债 + 持续阻塞

**任务跟踪**：`tasks.md`（下次开工首要）+ `STATUS.md`（⚡ 断点）.

**持续性阻塞**：
- **黑妹档口 cookie 失效频繁** → 阻塞批量扒图
- **D7779 detail_inner** 跑法未解决（fleece / shearling 误渲染）
- **API易 hardcoded key 改 env var**（13 处 `scripts/test_*.py`）

**工具债**（当前用 `scripts/<sku>_*.py` 实验脚本，跑通后封装到 tools/）：
- `tools/gen_models.py` ⭐ 待封装为参数化通用工具
- `tools/gen_hero.py` — 按 SKU JSON 跑 PDP
- `tools/post.py` — PIL 后期
- `tools/render_pdp.py` — Jinja2 + Playwright 分段
- `tools/upload_douyin.py` — Playwright web 自动化抖店
- `tools/derive_1x1.py` ⚠️ 默认 logo 错（应改 `logo-dark.png` for 暖米底）

---

## §12 改进备忘

> 跨子 skill 都适用的总结性教训. 每个子 skill 有自己的 §改进备忘.

- **2026-05-15** SKILL 重构 — 单 SKILL 2353 行 → 拆 5 个 sub-skill（入口 + fetch + generate + htmlpage + deploy）, 各自单一职责, subagent 只加载需要的
- **2026-05-15** 6 条核心铁律锁定 + Ref 选图 = #1 权重 + Model ref 有头/没头 配 face anchor 配对铁律
- **2026-05-15** Ref 比例 vs Output size 关系搞清楚 — Crop 改 ratio OK / Resize 拉伸禁止 / Padding 不影响

---

## §13 子 skill 速查

| Skill | 行数 | 内容 |
|---|---|---|
| **sku** (本文件) | ~180 | 入口 / 流程图 / 决策树 / 铁律速查 / SKU 清单 |
| **sku-fetch** | ~225 | go2 扒图 6 步 + 验证码 + GBK 解压 |
| **sku-generate** ⭐⭐⭐ | ~620 | **5 铁律 + Ref + API + anchor + PDP/Model 模板** |
| **sku-htmlpage** | ~296 | 13 段骨架 + 字体 v2.3 + 命名 v2.6 + 文案 + Spec |
| **sku-deploy** | ~324 | 派生 / Logo / segments / zip / ECS / 抖店 |
| **总** | **~1645** | 比原 SKILL 2353 行瘦 30% + 职责清晰 |