前言¶
生态观测、庭院观鸟或野外相机回传素材时，常见需求是：从画面里判断出现了哪些鸟种。若只靠通用多模态模型随口猜种名，往往缺少针对鸟类的分类体系，也难以对接后续统计或训练流程。下面介绍 SkillHub 上的 Bird Recognition Tool | 鸟类识别工具，把「目标区域内的鸟类识别」封装成可被 Coding Agent 加载的 Skill，便于在对话里直接处理本地或项目内的图片、视频。
这是什么¶
Bird Recognition Tool | 鸟类识别工具 是社区发布者 user_bb47e3e3 在 SkillHub 上架的专业类 Skill（坐标 @user_bb47e3e3/bird-recognition-analysis，当前版本 1.0.8，来源 community）。官方简介说明：它用于识别目标区域图片/视频中的鸟类种类，支持不低于 500 种常见鸟类识别，并支持定制化模型训练，适用于生态观测、庭院观鸟等场景。页面标签标明 requires_api_key=false，即按 SkillHub 展示信息，不强制额外 API Key。
Skill 详情与安装入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_bb47e3e3/bird-recognition-analysis
- 官方地址（资料中的 API 入口）：https://api.skillhub.cn/user_bb47e3e3/bird-recognition-analysis
核心功能¶
以下能力均来自 SkillHub 已公开的简介与元数据，未在页面上展开的实现细节以安装后 Skill 包内的 SKILL.md 为准。
- 图片与视频中的鸟类识别：对目标区域内的鸟类进行种类识别，输入形态为图片或视频（具体调用方式见 Skill 文档）。
- 物种覆盖规模：支持不低于 500 种常见鸟类识别。
- 定制化模型训练：简介中说明支持定制化模型训练，适合有标注数据、希望收窄识别域的场景。
- 场景定位：生态观测、庭院观鸟等需要快速从影像得到鸟种信息的场合。
SkillHub 侧统计（以抓取资料为准）：分类 professional，评分 100000，下载 681 次。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按官方安装文档执行。
方式一：SkillHub CLI¶
先确认是否已安装 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。官方文档给出的常见路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex CLI | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令示例（将 <skills 目录> 换成上表对应路径）：
skillhub install @user_bb47e3e3/bird-recognition-analysis --dir <skills 目录>
也可先搜索再安装：
skillhub search bird-recognition
skillhub install @user_bb47e3e3/bird-recognition-analysis --dir <skills 目录>
方式二：让 AI 按官方文档安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bb47e3e3/bird-recognition-analysis`。
在 Cursor、Claude Code 或 Codex CLI 等支持 Skills 的客户端中，将上述内容发给 Agent，并确认安装目录指向该客户端的 skills 路径。安装完成后，按各客户端说明刷新或重启，使新 Skill 被索引。
更完整的优先源策略与目录说明见：https://skillhub.cn/install/skillhub.md
典型用法¶
公开页面未附带独立的命令行 Demo；该 Skill 遵循通用 SKILL.md 格式，安装成功后 Agent 会读取包内说明来决定如何调用脚本或分析流程。可复现的使用路径如下：
- 按上一节将
@user_bb47e3e3/bird-recognition-analysis安装到当前环境的 skills 目录。 - 在对话中说明任务，并提供待识别的图片或视频路径（或项目内可访问的媒体文件），并指明需要关注的目标区域（若画面较大、只需识别局部）。
- 请 Agent 依据已加载的 Bird Recognition Tool Skill 执行识别；若需定制化模型训练，在对话中说明训练意图与数据情况，并按
SKILL.md中的步骤配合 Agent 操作。
未安装前无法核对包内具体子命令或配置项，因此本文不列举未在 SkillHub 页面出现的参数名或接口路径。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里处理观鸟照片、红外相机片段、庭院监控录像，并希望得到鸟种层面结果的用户。
- 有生态或科普类项目，希望把识别能力挂在 Coding Agent 上，减少手写推理提示词的成本的团队。
使用注意
- 识别种类数量与「常见鸟类」范围以 Skill 简介为准；罕见种、模糊小目标或严重遮挡画面，效果取决于模型与 Skill 内实现，需以实际试跑为准。
- 定制化模型训练涉及数据与训练流程，安装后务必阅读
SKILL.md，不要假设与通用识别共用同一套一键命令。 - CLI 安装目录错误是常见坑：务必使用
--dir指向当前客户端的 skills 路径。 - 元数据标明无需 API Key，若后续版本变更要求密钥，以 SkillHub 页面与
SKILL.md更新为准。
结尾¶
Bird Recognition Tool 把鸟类影像识别与可选的定制训练能力打包为 SkillHub 上的 @user_bb47e3e3/bird-recognition-analysis，适合在 Cursor、Claude Code、Codex CLI 等环境中通过自然语言驱动观鸟与生态类分析。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_bb47e3e3/bird-recognition-analysis ；资料中的官方 API 入口：https://api.skillhub.cn/user_bb47e3e3/bird-recognition-analysis 。
