前言¶
田間管理裏，水肥、病蟲害和採收窗口往往取決於作物處在哪一生育期。人工巡田可以判斷，但影像歸檔後批量回看、或把「當前階段」寫進下游系統時，仍需要一套穩定的識別與結構化輸出。純靠通用多模態模型對話，階段命名不統一，歷史報告也難以按同一接口查詢。
下面介紹 SkillHub 上的 Plant Growth Stage Recognition Skill | 植物生長階段識別技能（座標 @user_bb47e3e3/plant-growth-stage-recognition-analysis）。它把計算機視覺與深度學習分析封裝成 Agent Skill，支持圖片與視頻輸入，並輸出結構化報告；歷史清單通過腳本走雲端 API，而不是從本地記憶拼湊。
這是什麼¶
一句話定位：基於計算機視覺與深度學習，識別植物從發芽到結果全生命週期關鍵生長階段，爲精準農業決策提供結構化數據。
- 出品與維護：社區來源（
community），發佈者user_bb47e3e3，SkillHub 分類爲professional。 - 當前版本：SkillHub 頁面標註 v1.0.6（2026-10-22 查閱）。
- 平臺數據：評分 100000，下載 695 次，安裝 2 次；標籤
requires_api_key=false，安裝 Skill 本身不強制配置 API Key。 - 官方入口：SkillHub 技能頁、API 座標頁。
技能內場景碼爲 PLANT_GROWTH_STAGE_RECOGNITION。演示說明見技能文檔中的鏈接：技能使用介紹。
核心功能¶
以下能力均來自技能 SKILL.md 與 SkillHub 簡介，未額外擴展。
- 輸入形態：支持圖片、視頻、本地文件路徑、網絡 URL。
- 識別範圍：覆蓋發芽、幼苗、營養生長、開花、結果等關鍵階段；結合植株形態、葉面積相關特徵與生殖器官發育等信息做階段判斷。
- 能力模塊：植株檢測、生長階段分類、關鍵發育特徵分析、結構化數據輸出。
- 輸出：結構化分析報告、識別/監測結果、建議與報告鏈接；詳細程度可通過
--detail選擇basic/standard/json（默認json）。 - 歷史報告：用戶表達查看歷史識別報告等意圖時，須調用雲端接口列出報告，禁止僅從 Agent 本地記憶彙總。強制命令爲在技能根目錄執行：
python -m scripts.plant_growth_stage_recognition_analysis --list
- 觸發方式（Agent）：默認在用戶上傳植物影像並需要判斷生長階段時觸發；亦支持「生長階段識別」「生育期識別」「開花結果」等明確意圖，或歷史報告相關關鍵詞。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝說明 執行完整安裝或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本技能到當前 Agent 的 skills 目錄¶
安裝時必須使用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。常見路徑（摘自官方安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令示例（將 --dir 換成你的環境路徑）：
skillhub install @user_bb47e3e3/plant-growth-stage-recognition-analysis --dir ~/.cursor/skills/
也可將下面提示詞交給已接入 Skill 安裝的 AI，讓其按官方流程操作：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_bb47e3e3/plant-growth-stage-recognition-analysis`。
3、腳本依賴¶
技能包內分析腳本依賴：
requests>=2.28.0
用戶身份由腳本在內部自動關聯，技能要求不得向用戶索要或展示內部身份標識。
典型用法¶
在 Agent 對話中使用¶
- 確認技能已安裝到當前客戶端 skills 目錄並已被 Agent 加載。
- 上傳清晰的植物圖片或視頻，或提供可訪問的公網 URL，並說明需要判斷生長階段或查詢歷史報告。
- Agent 應在技能根目錄調用模塊
scripts.plant_growth_stage_recognition_analysis完成分析或--list查詢。
標準流程要點：準備輸入 → 系統自動身份關聯 → 在技能根目錄執行分析腳本 → 閱讀結構化結果與報告鏈接。
命令行示例（須在技能根目錄執行）¶
識別本地文件：
python -m scripts.plant_growth_stage_recognition_analysis --input /path/to/plant.mp4
識別網絡資源（由 API 服務下載，無需先手動落盤）：
python -m scripts.plant_growth_stage_recognition_analysis --url https://example.com/crop.mp4
查詢歷史報告列表：
python -m scripts.plant_growth_stage_recognition_analysis --list
精簡輸出或寫入文件：
python -m scripts.plant_growth_stage_recognition_analysis --input crop.jpg --detail basic
python -m scripts.plant_growth_stage_recognition_analysis --input crop.jpg --output result.json
常用參數：--input（本地路徑）、--url（網絡地址）、--list（歷史清單，可配合日期過濾）、--api-url（可選覆蓋默認 API）、--detail、--output。接口字段與錯誤碼見包內 references/api_doc.md。
適用場景與注意¶
適合誰
- 需要在對話或自動化流程裏，把作物影像轉爲統一結構的生育期判斷結果。
- 精準農業、農技服務、影像巡檢產品中，希望 Agent 按固定腳本調用雲端分析，而不是臨時拼腳本。
- 需要按雲端接口拉取歷史識別報告清單的團隊。
拍攝與格式
- 植株主體儘量完整，光線充足，避免嚴重模糊、過曝或色差；田間羣株拍攝時儘量突出單株特徵。
- 支持
jpg/jpeg/png，單文件最大 20MB。
限制與合規
- 分析結果僅供農業生產參考，具體農事決策需結合實地與專業指導。
- 影像與關聯標識經 HTTPS 發送至雲端 API；技能文檔聲明分析完成後雲端不持久化原始視頻數據。上傳前請確認數據出境與隱私政策符合本單位要求。
- 禁止臨時編寫替代腳本，須使用技能包內
scripts/plant_growth_stage_recognition_analysis.py等既定入口。 - 歷史報告列表必須從雲端 API 獲取，並以 Markdown 表格等形式展示，不得用本地 memory 或長期記憶冒充清單。
結尾¶
Plant Growth Stage Recognition Skill 把「植株檢測 → 階段分類 → 結構化報告 → 雲端歷史查詢」收斂到一套 SKILL.md 約定與 Python 模塊調用，適合掛在 Cursor、Claude Code、Codex 等支持 Skill 的客戶端上，減少生育期判斷口徑漂移。
安裝與座標：@user_bb47e3e3/plant-growth-stage-recognition-analysis，SkillHub 頁面：https://www.skillhub.cn/skills/user_bb47e3e3/plant-growth-stage-recognition-analysis。
