前言¶
田间管理里，水肥、病虫害和采收窗口往往取决于作物处在哪一生育期。人工巡田可以判断，但影像归档后批量回看、或把「当前阶段」写进下游系统时，仍需要一套稳定的识别与结构化输出。纯靠通用多模态模型对话，阶段命名不统一，历史报告也难以按同一接口查询。
下面介绍 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。
