前言¶
生態觀測、庭院觀鳥或野外相機回傳素材時，常見需求是：從畫面裏判斷出現了哪些鳥種。若只靠通用多模態模型隨口猜種名，往往缺少針對鳥類的分類體系，也難以對接後續統計或訓練流程。下面介紹 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 。
