前言¶
給 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
