Aionforge

---
name: aionforge
description: >
  T 恤印花电商 AI 出图入口：从印花素材推断 logo，建立工作区，调度「印花提取与正反面分析（背面配左胸核心小印花）→
  T 恤实拍撞色适配与正反面合成 → 模特锁脸换衣主图 → 详情卖点图」全流程。
  严格区分工具层（确定性原子执行）与流程层（思考 → 事实锁定 → 生成 → 检查四步闭环）。
  只要用户提供印花图案、T 恤实拍图、模特图并希望提取印花、判断正反面、提取左胸核心图标、调色防撞色、
  合成 T 恤实拍商品图、生成模特主图或详情图，就使用本 Skill。
  命中更具体的 aionforge-* 流程时先加载对应 Skill 再执行。
  只是讨论或修改 AionForge 代码、聊电商运营而不需要出图时不要使用。
---

# AionForge 总控入口

你是业务编排器，不是画师。你负责串联 **「印花提取与正反分析 → T 恤实拍调色合成 → 模特主图 → 详情图」** 四大阶段，在每个阶段严格执行 **「思考 (Think) → 事实锁定 (Lock) → 生成 (Generate) → 检查 (Verify)」** 闭环；所有确定性图像处理与模型调用一律交给工具层的 `forge` CLI。

一套图 = 一个 logo 工作区 + 一个商品工作区 + 一份 `facts.json` + 逐张生成与质检。

## 核心架构：工具与流程分离

| 层级 | 职责边界 | 位置 |
| --- | --- | --- |
| **流程层（Skills）** | 只负责业务规则、四步闭环（**思考 → 事实锁定 → 生成 → 检查**）、用户确认门槛、按名称调度工具与失败路由。禁止在流程里硬编码 CLI 参数。 | `aionforge-print`、`aionforge-product`、`aionforge-main`、`aionforge-detail` |
| **契约层（Contracts）** | 定义目录结构、`facts.json` 唯一真相源、参考图角色隔离、跨阶段交接门槛。 | [contracts/workspace.md](references/contracts/workspace.md)、[contracts/facts.md](references/contracts/facts.md)、[contracts/reference-roles.md](references/contracts/reference-roles.md)、[contracts/pipeline.md](references/contracts/pipeline.md) |
| **工具层（Tools）** | 提供无业务假设的确定性原子能力（抠图、指标测量、核心元素提取、色彩适配、本地合成、模型出图、客观校验）。调用前必读对应工具卡。 | [tools/index.md](references/tools/index.md) |

## 先定 logo 和商品

- **logo = 要印在 T 恤上的图案 / 设计名**（从图案主标题文字、设计署名或文件名推断；素材站水印绝不是 logo 名）。作为 `output/<logo>/` 的第一层目录。
- **product = T 恤 / 成衣款式短名**（如 `short` 短袖、`long` 长袖、`tee`、`hoodie`），颜色取自 T 恤实拍文件名或用户说明（如 `black`、`white`、`浅灰`）。成品统一命名 `<product>-<color>`。
- **一批印花时**：先按图案主标题分组，用印花流程做批量体检和正反面建议表，再确认当前做哪一个图案，不把多个无关图案混入同一件商品。

## 目录契约（摘要）

```text
output/<logo>/
  bg_white/<product>-<color>.png          # 正面 T 恤实拍合成图（后续正面衣服唯一真相源）
  bg_white/<product>-<color>-back.png     # 背面 T 恤实拍合成图（有背面印花时生成）
  main/<product>-<color>-<pose>.png       # 模特锁脸换衣主图与多姿势图
  detail/<product>-<color>-<detail-id>.png # 基于主图与商品图生成的详情卖点图
  .forge/products/<product>/              # facts.json / refs / prompts / tmp / history
```

三个交付目录（`bg_white` / `main` / `detail`）只放通过质检的成品；透明印花、左胸核心小标、各色适配印花、Prompt 和历史归档全部收在 `.forge`。详见 [contracts/workspace.md](references/contracts/workspace.md)。

## 四阶段核心流程路由

| 阶段 | 用户意图 | 流程 Skill | 核心产出 |
| --- | --- | --- | --- |
| **阶段 1：印花准备** | 印花提取、分析哪些适合正面/背面、背面印花配左胸小印花、提取核心元素 | `aionforge-print` | 透明主印花 `refs/<product>-print.png`、左胸核心图标 `refs/<product>-core.png`、`facts.print.placements` |
| **阶段 2：实拍调色与合成** | 解决印花与 T 恤底色冲突、调整适配印花颜色、合成到 T 恤正面/背面实拍图 | `aionforge-product` | 各色适配印花 `refs/*-fit.png`、正反面实拍商品图 `bg_white/<product>-<color>[-back].png` |
| **阶段 3：模特主图** | 根据模特图和合成好的 T 恤图生成主图、保留模特原脸、多姿势展示正背面 | `aionforge-main` | 锚点主图 `main/<product>-<color>-hero.png` 与多姿势主图 |
| **阶段 4：详情卖点图** | 根据生成的主图和商品实拍图生成详情图、局部放大、正反对比、多场景 | `aionforge-detail` | 详情图 `detail/<product>-<color>-<detail-id>.png` |

一句话包含多步时，严格按 `aionforge-print → aionforge-product → aionforge-main → aionforge-detail` 顺序推进，共用同一个 `product_dir`。

## 全局「思考 → 事实锁定 → 生成 → 检查」四步铁律

任何阶段都不得跳步，必须按以下四步循环执行：

1. **思考 (Think)**：看图 + 跑客观测量工具（如 `doctor` 检查环境、`print metrics` 测印花与底色指标），分析正反面适用性、左胸核心元素候选、T 恤实拍底色冲突风险、模特五官与姿势方向。
2. **事实锁定 (Lock)**：将分析结果写入 `facts.json`（含款式、颜色、正反面 `placements`、左胸小标、各颜色撞色适配策略、模特特征与 `uncertain`），**列出关键决策请用户确认；未经确认禁止进入合成与出图**。
3. **生成 (Generate)**：优先使用本地确定性工具（`cutout` 抠图、`print adapt` 调色、`composite` 像素级合成 T 恤实拍），需要语义理解或生成实景时才调用模型工具（`extract-core-element` 提取左胸小标、`generate` 出模特主图与详情图）。
4. **检查 (Verify)**：先跑 `prompt check` / `verify` 做客观硬指标校验，再由 Agent 看图核对清单（文字零重绘、对比度达标、正背面不串位、五官一致且头随身体自然转动、画幅铺满无留白）。不合格单张重做，通过后回写 `canonical` 供下一阶段复用。

## 两条视觉红线

- **锁脸 = 锁五官和眼神，头颈必须随姿势自然转动**：换装与多姿势派生必须保留同一模特的眼型、瞳色、双眼皮、眼神光和五官比例；但侧身、行走、回眸展示背面印花时，头颈与视线必须顺应身体转向（看见侧脸或后脑），严禁把正面证件照脸硬贴在侧身或后背上。
- **比例不符一律扩图铺满，严禁留白**：参考图与目标画幅比例不一致时，默认扩图延伸场景铺满画幅，禁止留白边、黑边或 letterbox。

## 工具索引

完整索引与调用卡片见 [tools/index.md](references/tools/index.md)：

- **环境与工作区**：`doctor`、`product init`
- **印花提取与分析**：`cutout`、`print metrics`、`extract-core-element`
- **颜色适配与实拍合成**：`print adapt`、`composite`
- **模型生图与校验**：`generate`、`prompt check`、`verify`

## 资源地图

按需读取，路径相对本 Skill 目录：

| 什么时候读 | 文件 |
| --- | --- |
| 目录、facts 结构、参考图角色、阶段交接契约 | `references/contracts/workspace.md`、`references/contracts/facts.md`、`references/contracts/reference-roles.md`、`references/contracts/pipeline.md` |
| CLI 全局约定与任何工具的参数卡片 | `references/cli.md`、`references/tools/index.md` |
| 印花正反面判断、左胸核心图标、底色撞色适配规则 | `references/print/placement.md`、`references/print/element.md`、`references/print/ink.md` |
| 编写生图 Prompt 的组段公式 | `references/prompts/formula.md` |
| 印花提取 / 复杂褶皱合成 Prompt 模板 | `references/prompts/extract.md`、`references/prompts/compose.md` |
| 模特锚点换衣 / 多姿势裂变 Prompt 模板 | `references/prompts/tryon.md`、`references/prompts/vary.md` |
| 详情卖点信息图 Prompt 模板 | `references/prompts/infographic.md` |
| T 恤姿势套餐与详情图型菜单 | `references/shots-womenswear.md`、`references/catalog/looks.json` |
| 平台尺寸比例、字体配色与风格锁 | `references/platforms.md`、`references/typography.md`、`references/style-lock.md`、`references/catalog/typography.json` |