前言¶
做智能宠物管家、家庭监控联动或宠物档案类产品时，常见需求不只是「画面里有没有猫狗」，还要回答品种是什么、同帧里多只宠物分别是谁。纯靠通用多模态模型口头描述，往往缺少结构化报告、历史清单和可复现的调用路径。下面介绍 SkillHub 社区技能 Pet Breed & Individual Identification Skill（宠物品种个体识别技能）：把识别流程写进 Agent Skill，通过官方脚本对接云端分析接口，输出品种、个体区分与报告链接。
这是什么¶
Pet Breed & Individual Identification Skill 是面向 Agent 的 SKILL.md 技能包，坐标为 @user_bb47e3e3/pet-breed-individual-recognition-analysis，由社区发布者 user_bb47e3e3 维护，在 SkillHub 分类为 life-service，当前版本 1.0.9，来源为 community。
官方简介：精准识别猫狗宠物品种，支持多宠家庭区分不同独立个体，可作为智能宠物管家场景下的识别助手。SkillHub 页面标注 requires_api_key=false（安装侧无需单独配置 API Key）；实际分析由技能包内脚本调用云端 API 完成，用户身份在脚本内部自动关联，无需在对话中填写用户名或手机号。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_bb47e3e3/pet-breed-individual-recognition-analysis
- 资料接口地址（页面同源）：https://api.skillhub.cn/user_bb47e3e3/pet-breed-individual-recognition-analysis
截至资料抓取时，SkillHub 显示评分 100000，下载 687 次，安装计数 0（以商店页面统计为准）。
核心功能¶
结合 SkillHub 简介与技能包 SKILL.md 说明，已核实能力包括：
- 输入：本地图片/视频路径，或公网图片/视频 URL；支持
jpg/jpeg/png/mp4/avi/mov，单文件最大 10MB。 - 检测与品种：识别画面中的猫、狗等常见宠物，进行品种判定（文档称覆盖主流与稀有品种库，并基于 DCNN 相关能力描述）。
- 个体区分：面向多宠家庭，在同一画面中区分不同个体，输出宠物数量、每只的品种与个体区分结果、置信度等结构化信息。
- 历史报告：通过
--list从云端分页查询历史「宠物品种个体识别」分析报告，禁止用本地 memory 或人工汇总冒充清单。 - Agent 触发：用户上传宠物图/视频并提出品种或个体识别需求时默认适用；提及历史报告类关键词时应走
--list查询云端数据。
分析结果仅供宠物爱好参考；文档注明纯种鉴定应以专业机构为准。技能演示页：https://lifeemergence.com/sample.html
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方安装文档执行（完整安装或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装说明全文：https://skillhub.cn/install/skillhub.md
2、安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能无法被识别。
Cursor 常用目录为 ~/.cursor/skills/：
skillhub install pet-breed-individual-recognition-analysis \
--namespace user_bb47e3e3 \
--dir ~/.cursor/skills/
等价坐标写法：@user_bb47e3e3/pet-breed-individual-recognition-analysis。
也可将下面提示词交给 AI，让其按官方安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_bb47e3e3/pet-breed-individual-recognition-analysis。
Claude Code、Codex 等客户端目录不同（例如 ~/.claude/skills/、~/.codex/skills/ 或项目下 .agents/skills/），只需把 --dir 换成对应路径，安装命令结构相同。详见 SkillHub 安装文档第四节。
3、脚本依赖¶
技能包 scripts 目录依赖：
requests>=2.28.0
在技能根目录（含 SKILL.md 与 scripts/ 的目录）下执行后续命令。
典型用法¶
以下示例来自技能包 SKILL.md，需在技能根目录执行模块 scripts.pet_breed_individual_recognition_analysis。
识别本地图片：
python -m scripts.pet_breed_individual_recognition_analysis --input /path/to/pets.jpg
识别网络图片（由 API 侧拉取，无需先下载到本地）：
python -m scripts.pet_breed_individual_recognition_analysis --url https://example.com/dogs.jpg
查询云端历史报告清单：
python -m scripts.pet_breed_individual_recognition_analysis --list
常用可选参数：--detail 取 basic / standard / json（默认 json）；--output 写入结果文件；--api-url 覆盖默认 API 地址。更细的接口路径见包内 references/api_doc.md（如 OPEN_PET_BREED_INDIVIDUAL_RECOGNITION_ANALYSIS 场景码及分页、导出报告等端点）。
标准流程可概括为：准备清晰、宠物完整出镜的素材 → 在技能根目录运行上述命令 → 阅读返回中的宠物数量、品种、个体区分与报告链接；查历史时统一 --list 并以 Markdown 表格展示报告名称、宠物数量、分析时间与查看链接。
适用场景与注意¶
适合：多宠家庭的监控回看、宠物活动记录、智能管家对话里「这是什么品种」「这几只分别是谁」；需要可查询的历史识别报告列表的产品原型。
注意：
- 画质与构图会影响效果：光线充足、关键特征少遮挡，多宠同框时适当拉开间距。
- 历史报告只能通过
--list读云端；不要从本地会话记忆拼凑列表。 - 脚本仅限技能包自带实现，文档禁止临时手写替代脚本。
- 上传媒体会经 HTTPS 发往云端分析；技能声明分析完成后云端不持久化原始视频，具体以运营方政策与
SKILL.md隐私章节为准。 references/api_doc.md中仍写有 API Key 鉴权方式，与 SkillHub「无需 API Key」标签并存时，以你当前安装包内scripts/config.py默认配置为准。
结尾¶
Pet Breed & Individual Identification Skill 把猫狗品种识别与多宠个体区分封装成可安装的 Agent 技能，用固定脚本对接云端分析并支持历史报告查询，适合智能宠物管家类需求。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_bb47e3e3/pet-breed-individual-recognition-analysis
