pet-forge

pet-forge skill —— 触发条件 + 调用流程

给 AI coding agent 看的 skill 接入文档。当用户说"我想做桌宠"时，agent 应该按本文件的指引响应。

---

触发条件

当用户消息中出现以下信号时，激活 pet-forge skill：

强信号（必触发）

• "我想做（自己的 / 一个）桌宠"
• "做个 SVG 桌宠 / APNG 桌宠"
• "帮我做一个 idle 动画"
• "怎么做桌宠"
• "桌宠 [角色名]，[风格]"

弱信号（询问后再决定）

• "我喜欢某个现有桌宠案例"（可能想要 fork 而不是做新的）
• "想做个动画"（可能不是桌宠，可能是其他动画）
• "做个角色"（可能是设计需求，不是动画）

弱信号触发时反问："你是想做一个会循环动 + 接桌宠运行时的角色吗？还是只是单帧动画/设计图？"

反触发（不要触发）

• 用户已经在做某个具体产品项目，而不是想用 pet-forge 新建角色
• 用户只是在问某个现有桌宠是什么，而不是动手做

---

第一轮响应模板

skill 触发后，Claude 第一句话不要写代码，先确认 4 件事：

1. 角色是什么："你想做的角色是什么？（例：橘猫 / 机器人 / 蘑菇 / 你已有的设定...）"
2. 角色拓扑："它是只有头、头+身体，还是一团主体？有没有手脚、耳朵、尾巴、触角、道具、眼睛、嘴巴？是站地、悬浮还是贴边？"
3. 审美方向："想要什么风格？（例：苹果精致风 / 像素风 / 蹦跳多巴胺 / 禅宗极简 / 你给参考图）"
4. 路线倾向："你想要 SVG 还是 APNG？两者特性差异大：[列两路线对比表]，没想好的话先选 SVG（不付费、可热改）"

---

路线选择决策树

用户回答"想要..."
   │
   ├─ "循环完美 / 不付费 / 可热改" → 推荐 SVG 路线
   ├─ "快出成品 / 不在乎钱 / 风格化强" → 推荐 APNG 路线
   ├─ "不会写代码" → 推荐 APNG 路线（prompt 工程门槛低于前端动画）
   ├─ "想要精致圆润矢量感" → SVG 路线 + apple-precise preset
   ├─ "想要像素感" → SVG 路线 + pixel-art preset
   └─ "都想试试" → 先 SVG（启动门槛低），跑通再考虑 APNG

---

SVG 路线工作流（skill 引导）

第 0 步：角色拓扑盘点

先不要默认角色一定有完整头、身体、手脚和嘴巴。问清：

• 主体形态：只有头、头+身体、一团主体、道具/物件，还是其他轮廓；
• 脸部结构：有没有眼睛、嘴巴、腮红、表情符号；
• 附属结构：有没有手、脚、耳朵、尾巴、触角、翅膀、道具；
• 支撑关系：站地、悬浮、贴边、挂载，还是靠道具支撑；
• 目标动作：转头、抬低头、眼睛跟随、表情、走路、挥手、弹跳、漂浮。

根据拓扑决定后续读哪些文档：

• 有脸部方向需求 → routes/svg/conventions/head-motion-axis.md
• 有主体 / 身体转向需求 → routes/svg/conventions/body-motion-axis.md
• 有手脚、尾巴、触角、道具等附属结构 → routes/svg/conventions/limb-rig-points.md
• 有嘴巴或多表情系统 → routes/svg/conventions/expression-mouth-system.md
• 没有手脚、尾巴、触角或道具时，不要强行套附属结构 rig；退化为主体轮廓、重心 / 悬浮基准和呼吸即可
• 没有嘴巴时，不要强行套 mouth rig；用眼睛、眉毛、腮红、表情符号或整体形变表达情绪

第 1 步：确定角色基础造型

询问用户：

• "你的角色基础造型在哪？" 三选项：
  • A: 已有 PNG → 直接用
  • B: 想 AI 生 → 推荐 ChatGPT / Claude 网页 / Midjourney 自己生（skill 不调 API）
  • C: 自己画 → Figma / Procreate / 等等

关键：保证用户拿到一张透明背景 PNG。如果不是透明，引导用户用 rembg 处理：

py -3.13 -m pip install "rembg[cpu,cli]"
py -3.13 -m rembg i input.png input-clean.png