前言¶
给 WorkBuddy 做一个桌面宠物，常见做法是手写一整套文件：pet.json 声明宠物元数据，SKILL.md 写技能说明，pet-widget.js 实现渲染与交互，index.js 做入口，preview.html 做预览，Windows 上还要手动编译批处理脚本。帧尺寸要自己量，显示比例要自己算，多个宠物放在一起还容易互相覆盖。
下面介绍的 宠物WorkBuddy（坐标 @user_11794934/pet-scaffold）把这个流程压成一次输入：给它帧图目录、petId 和 petName，它直接生成整套 WorkBuddy 桌面宠物技能文件，并自动处理帧尺寸检测、显示比例计算和多宠共存。
这是什么¶
宠物WorkBuddy 是一个桌面宠物技能一键生成器 Skill，属于 community 来源，发布者为 user_11794934，分类 dev-programming，当前版本 1.0.5。它解决的问题是：开发者手上已经有帧图素材，但不想手写和拼接宠物技能的各个文件。
它的来源是吕布/关羽宠物技能框架，属于从既有框架抽取而成。资料中同时提到配套素材库可下载 Live2D、3D、桌宠素材，可直接使用。
核心功能¶
- 输入帧图目录：目录需包含 idle、click、walk 三个子文件夹，帧图为 PNG 格式。
- 输入标识与名称：petId 用于标识宠物，petName 用于展示。
- 生成完整技能：输出 pet.json、SKILL.md、pet-widget.js、index.js、start-pet.bat、preview.html 六个文件。
- 自动检测帧尺寸：从帧图本身读取宽高，不需要手工填写。
- 计算显示比例：根据帧尺寸自动算出显示比例，避免拉伸或错位。
- 多宠共存：多个宠物技能可以同时存在，互不覆盖。
安装与启用¶
官方资料中没有给出可直接核实的安装命令，因此这里不写具体命令。按 SkillHub 上该技能的元数据，标签为 requires_api_key=false，即使用该技能不需要 API key。
- 先确认环境：按技能页说明在对应的 Agent Skill 运行环境中启用该 Skill（如 Cursor、Codex CLI、Claude Code 等）。资料未分别说明各环境的差异，此处不臆造差异。
- 再准备素材目录：按 idle/click/walk 三个子文件夹整理 PNG 帧图。
- 然后调用技能：把帧图目录路径、petId、petName 提供给技能，让它生成六个文件。
生成产物示例：
pet-scaffold/
├── pet.json # 宠物元数据
├── SKILL.md # 技能说明
├── pet-widget.js # 宠物渲染与交互
├── index.js # 入口
├── start-pet.bat # Windows 启动脚本
└── preview.html # 预览页
典型用法¶
下面是基于官方资料描述的输入方式，参数名以技能说明为准：
- 准备帧图目录，例如
pets/my-cat/，内部分为idle/、click/、walk/，放入对应的 PNG 帧。 - 指定
petId，例如my-cat。 - 指定
petName，例如我的猫。 - 将目录路径、petId、petName 交给技能，等待六个文件生成完成。
- 用 start-pet.bat 启动宠物，或打开 preview.html 先在页面中预览效果。
适用场景与注意¶
适合谁：已经备好帧图素材、想快速得到可用 WorkBuddy 桌宠技能的开发者；想从吕布/关羽框架之外获得一套更通用生成流程的人；需要在 Windows 上一键启动桌宠的人。
限制与坑：
- 帧图必须按 idle、click、walk 三态组织，缺任何一个子文件夹会影响对应状态的表现。
- 帧图格式为 PNG，其他格式不在资料描述范围内。
- 多宠共存的前提是 petId 不重复，重复 petId 可能导致宠物之间互相覆盖。
- start-pet.bat 是 Windows 批处理脚本，非 Windows 环境需要自行替换启动方式。
- 官方资料未给出详细的错误处理行为，生成失败时建议先检查目录结构与帧图格式。
结尾¶
宠物WorkBuddy 的价值在于把桌宠技能的搭建从手工拼文件变成一次输入，帧尺寸和显示比例交给技能自动处理，多宠共存也由技能统一保证。如果你手上的素材已经按 idle/click/walk 整理好，可以先用它生成一套骨架，再按自己的需求改渲染细节。
官方地址：https://api.skillhub.cn/user_11794934/pet-scaffold ，SkillHub 页面：https://www.skillhub.cn/skills/user_11794934/pet-scaffold
