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