前言¶
在 macOS 上用官方 WorkBuddy 做任務時，桌面側往往只有應用窗口本身，缺少一個能反映「當前在聊什麼、任務跑到哪一步」的常駐視覺反饋。社區 Petdex 生態裏已有大量動畫桌面寵物，但從零配置安裝、與 WorkBuddy 狀態橋接、切換與排錯，對不熟悉終端的用戶門檻不低。下面介紹 SkillHub 上的 JayT-workduddy-寵物（座標 @user_5cb10d7b/jayt-workbuddy-petdex）：由 Agent 按文檔調用捆綁腳本，在 不依賴 Codex、不修改 WorkBuddy.app 的前提下，完成 Petdex 寵物的瀏覽指引、安裝、運行、診斷與卸載，並把對話摘要、多任務列表和本地番茄鍾狀態展示在寵物側。
這是什麼¶
JayT-workduddy-寵物（包名 jayt-workbuddy-petdex，當前 SkillHub 版本 v1.0.6）是一條面向 macOS 官方 WorkBuddy 的 Agent Skill，分類爲 life-service，來源爲社區（發佈者 user_5cb10d7b，SkillHub 頁面標註作者爲張傑倫）。SkillHub 簡介爲：讓 WorkBuddy 獲得與 Codex 側相近的寵物體驗。
它解決的核心問題是：把 Petdex 社區寵物安裝到本機，並通過本地橋接讓寵物顯示 WorkBuddy 的任務與對話摘要，同時提供捆綁腳本管理生命週期；全程不要求 Codex，也不改寫 WorkBuddy 安裝包或皮膚。
核心功能¶
以下能力來自該 Skill 的 SKILL.md 與 SkillHub 公開說明，可按腳本名在技能包內復現。
- 選寵與安裝：引導用戶打開 Petdex 中文站，用詳情鏈接（如
https://petdex.dev/pets/boba）、頁面複製的安裝命令文本，或寵物 slug/名稱發起安裝；由./scripts/install-pet.sh解析輸入，只從允許的https://assets.petdex.dev/資源安裝到 WorkBuddy 專用本地庫，不執行 Petdex 返回的遠程 shell。 - 權限與激活：安裝前若任務未處於「允許完全訪問」，需按 Skill 內四步指引授權，用於在個人目錄保存寵物並啓動本地後臺組件；不通過重啓 WorkBuddy 替代該權限。
- 狀態聯動：任務氣泡可展示最近可見用戶指令（截斷至 60 字）、助手狀態摘要（96 字）、最多五個 WorkBuddy 任務標題與狀態，以及約八秒的完成提示；不收集完整回覆、歷史輪次或附件內容。
- 番茄鍾：自然語言或右鍵菜單可觸發本地番茄鍾；對應
./scripts/tomato-clock.sh（開始/暫停/恢復/取消/狀態及set持久配置）。WorkBuddy 退出時會暫停進行中的計時，下次啓動可繼續或取消。 - 日常管理：列出已裝寵物、切換、暫停/喚醒運行時、診斷、移除非當前寵物、卸載運行時（可選是否刪除已下載寵物包）等，均有對應
scripts/下腳本。 - 邊界：僅支持官方 macOS WorkBuddy；不安裝 Codex、不寫 Codex hooks；皮膚類需求應交給其他 Skin Skill。
SkillHub 元數據標明 requires_api_key=false，無需額外 API Key。
安裝與啓用¶
通過 SkillHub 安裝 Skill¶
SkillHub 頁面給出的安裝提示如下：讓 AI 根據官方安裝說明安裝本技能。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5cb10d7b/jayt-workbuddy-petdex`。
按 SkillHub 安裝文檔，需先確認本機是否有 skillhub CLI；安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落到 ./skills/ 可能無法被識別。
WorkBuddy 的 skills 目錄爲：
~/.workbuddy/skills/
示例（將技能裝進 WorkBuddy Agent）：
command -v skillhub && skillhub --version
skillhub install @user_5cb10d7b/jayt-workbuddy-petdex --dir ~/.workbuddy/skills/
若在 Cursor 等其它客戶端中使用同一 Skill，目錄不同，例如 Cursor 爲 ~/.cursor/skills/；安裝時把 --dir 換成對應路徑即可。Codex CLI 常見路徑爲 ~/.codex/skills/ 或項目下 .agents/skills/——以你當前客戶端文檔爲準。
Skill 安裝完成後，按客戶端要求刷新或重啓 Agent，使 SKILL.md 被加載。
安裝一隻 Petdex 寵物（Skill 啓用後）¶
用戶準備好 Petdex 鏈接或名稱後，Agent 應讀取技能內 references/petdex-package.md 與 references/security.md，再執行（引號內爲用戶原始輸入）：
./scripts/install-pet.sh "<the exact user input>"
成功連接後應緊接着運行診斷：
./scripts/doctor.sh
若報告寵物宿主未啓動或橋接未運行，在用戶完成「允許完全訪問」並回復繼續後，可依次執行 ./scripts/start-runtime.sh 與 ./scripts/doctor.sh。Skill 明確：不要用重啓 WorkBuddy 來激活或重連寵物。
典型用法¶
第一次選寵物（無鏈接時）¶
Skill 要求對用戶復現四步中文指引：打開 Petdex 中文寵物站 → 選一隻 → 複製詳情鏈接 → 回到對話粘貼並說「幫我安裝這隻寵物」。並說明：瀏覽與安裝 Petdex 官方收錄寵物不需要註冊賬號，也無需手動下載文件。
安裝後操作¶
- 拖動寵物到任意位置；單擊揮手並開關任務面板；右鍵可重置、跳躍、控制任務面板自動顯示或退出。
- 番茄鍾示例：
./scripts/tomato-clock.sh start 25 focus
./scripts/tomato-clock.sh start 5 short-break
./scripts/tomato-clock.sh pause
./scripts/tomato-clock.sh resume
./scripts/tomato-clock.sh status
管理已安裝寵物¶
./scripts/list-pets.sh
./scripts/switch-pet.sh "<pet id or name>"
./scripts/stop-pet.sh
./scripts/start-runtime.sh
./scripts/remove-pet.sh "<pet id or name>"
./scripts/uninstall-runtime.sh
./scripts/uninstall-runtime.sh --remove-pets
「換一隻」「先不要這個」應理解爲切換或暫停，而非直接刪除，除非用戶明確確認卸載。
適用場景與注意¶
適合誰：在 macOS 上使用官方 WorkBuddy，希望桌面有 Petdex 動畫寵物，並讓它反映當前對話與任務進度，同時需要本地番茄鐘的用戶；對話裏出現桌面寵物、Petdex、任務狀態寵物、番茄鍾、從 petdex.dev 安裝或切換寵物等意圖時，Agent 會按 Skill 觸發。
限制與注意：
- 僅 macOS + 官方 WorkBuddy；Linux/Windows 或修改過的客戶端不在支持範圍內。
- 安裝與下載依賴網絡；Skill 禁止 Agent 自行用 WebFetch、代理繞過等方式硬裝，應引用捆綁腳本的短錯誤信息讓用戶檢查網絡。
- 若本機已有其它 WorkBuddy 桌面寵物進程，需用戶同意後再暫停舊寵物，不能靜默結束無關進程。
- Petdex 寵物多爲社區投稿，公開或商用前需自行覈對版權與授權。
- SkillHub 統計（以預抓取資料爲準）：評分 100000，下載 3712 次；頁面展示版本 v1.0.6。實際體驗以你安裝的包內
SKILL.md與腳本爲準。
結尾¶
JayT-workduddy-寵物把 Petdex 選寵、安裝、診斷和 WorkBuddy 狀態展示收成一條可對話驅動的流程，適合不想碰 Codex 寵物鏈路、又希望在桌面上看到任務與番茄鍾狀態的 WorkBuddy 用戶。
- SkillHub 技能頁：https://www.skillhub.cn/skills/user_5cb10d7b/jayt-workbuddy-petdex
- 官方座標頁：https://api.skillhub.cn/user_5cb10d7b/jayt-workbuddy-petdex
- Petdex 中文站：https://petdex.dev/zh
