---
name: hatch-pet-gemini
description: 完整复刻 OpenAI hatch-pet 的 9x5 精灵图集生成方案，包含自动化处理工具。
---

# Hatch-Pet Gemini Skill

## 启动规则（必须首先执行）

**使用本技能前，必须先询问用户希望使用哪种视觉风格。**
若用户未指定，默认使用 `ghibli` 风格。
将选定风格对应的「提示词关键词」替换所有生成提示词中的 `{STYLE}` 占位符。

---

## 风格库

| 名称 | 触发词 | 提示词关键词 |
|------|--------|-------------|
| **ghibli**（默认） | 吉卜力 / ghibli / 动漫 | Studio Ghibli animation style, soft expressive eyes, gentle watercolor-like shading, fluid poses, warm color palette, clean detailed linework, painterly but not photorealistic |
| **pixel** | 像素 / pixel / 复古 | Codex Digital Pet Style, pixel-ish, chibi, thick dark 1-2px outlines, limited palette, flat cel shading, visible stepped pixel edges |
| **cartoon** | 卡通 / cartoon | Bold outlines, flat bright colors, western cartoon style, exaggerated expressions, rubber-hose limbs |

---

## 目标
生成符合 Hatch-Pet 标准的 1728x1040 像素（9列 x 5行）动画图集，并自动完成抠图、对齐和拼合。

## 自动化工具 (Local Tools)
- **Prepare**: `npx tsx scripts/prepare.ts <pet_name>`
- **Process**: `npx tsx scripts/process.ts <pet_name> <row_name> <image_path>`
- **Assemble**: `npx tsx scripts/assemble.ts <pet_name>`

## 技术规格
- **单帧**: 192x208px | **图集**: 1728x1248px (9x6)
- **网格标准**: **必须**是 3x3 网格（9帧），使用 **细实线深绿色 (#006600)** 分隔。
- **构图标准**: 角色必须在每个格子内居中，并留出 **宽阔的绿色边距 (Wide Margin)**，严禁触碰或跨越网格线。
- **背景**: 必须使用纯绿色 `#00FF00`。禁止阴影、草地、地板纹理或光效外溢。

## 动画行定义

| 行名 | 动作描述 | loop |
|------|----------|------|
| `hatching` | 从蛋中孵化诞生 | 否 |
| `jumping` | 跳跃起落 | 否 |
| `running-left` | 向左奔跑 | 是 |
| `attacking` | 发动攻击 | 否 |
| `swift-to-people` | 变换成人形 | 否 |
| `sleeping` | 逐渐休眠 | 是 |

---

## 执行工作流 (Step-by-Step)

### 1. 询问风格
询问用户希望使用哪种风格（ghibli / pixel / cartoon），未指定则使用 `ghibli`。

### 2. 准备阶段
```
npx tsx scripts/prepare.ts MyPet
```

### 3. 生成参考图 ← 外观锚点，必须先完成
生成单帧正面角色图，用于锁定后续所有行的外观、比例和风格。

**Prompt**:
> "Generate a single sprite of a [description] pet, front-facing pose, full body, centered. {STYLE}. #00FF00 background. No shadows. Wide margin."

```
npx tsx scripts/process.ts MyPet reference path/to/reference.png
```

### 4. 循环生成动画行
每次生成必须附带参考图作为图像输入。

**标准动作 (hatching, jumping, running-left)**:
> "Using this reference, generate a 3x3 grid of 9 sequential frames showing this pet [ACTION]. {STYLE}. Separate frames with thin solid DARK GREEN grid lines (#006600). IMPORTANT: Character must be centered and stay away from lines with a wide margin. #00FF00 background. No shadows."

**攻击动作 (attacking)**:
> "Using this reference, generate a 3x3 grid of 9 sequential frames showing this pet performing a swift attack: wind-up (Frames 1-3), strike (Frames 4-6), and recovery (Frames 7-9). {STYLE}. Separate frames with thin solid DARK GREEN grid lines (#006600). IMPORTANT: Character must be centered and stay away from lines with a wide margin. #00FF00 background. No shadows."

**幻化动作 (swift-to-people)**:
> "Using this reference, generate a 3x3 grid of 9 sequential frames showing two stages: 1. Transformation (Frames 1-4): pet turns into magic light and becomes a {STYLE} human. 2. Walking (Frames 5-9): the human walking to the left. {STYLE}. Separate frames with DARK GREEN grid lines (#006600). #00FF00 background. No shadows."

**睡眠动作 (sleeping)**:
> "Using this reference, generate a 3x3 grid of 9 sequential frames showing: Frame 1: standing; Frames 2-5: gradually kneeling and curling up; Frames 6-9: fully curled up and sleeping peacefully. {STYLE}. Separate frames with DARK GREEN grid lines (#006600). #00FF00 background. No shadows."

每次生成后运行：
```
npx tsx scripts/process.ts MyPet <row_name> path/to/grid.png
```

### 5. 拼合阶段
```
npx tsx scripts/assemble.ts MyPet
```
最终产物：
- `pet_runs/MyPet/output/spritesheet.webp` — 1728x1040 透明背景图集
- `pet_runs/MyPet/output/pet.json` — 含动画定义的元数据

---

## 核心 Prompt 约束
- 参考图：单帧，正面，全身居中。
- 动画行：**必须**是 3x3 网格（9帧），**禁止**使用水平长条格式。
- **每格内角色必须完整，不得超出格子边界**。
- **必须**使用 `#00FF00` 绿色背景，禁止使用白色背景。
- **禁止**动态模糊、半透明特效、速度线、阴影、地板。
- **每一行生成时必须携带参考图**，确保外观一致性。