前言¶
庭院、果园、养殖场等户外场景里,摄像头拍回来的往往是大量静态截图或短视频片段。要在这些素材里快速判断有没有人、车、非机动车或宠物进入关注区域,常见做法是单独接一套视觉平台或自己写检测脚本,再把结果整理成可读报告。对已经在 Cursor、Claude Code 等环境里用 Agent 处理运维与安全类任务的人来说,更省事的路径是把「户外看护分析」封装成 Skill,让模型在合适意图下自动走固定脚本和云端接口,而不是每次从零拼命令。
下面介绍 SkillHub 社区技能 Intelligent Outdoor Care Monitoring & Analysis Tool | 户外看护智能监测分析工具(坐标 @user_bb47e3e3/outdoor-monitoring-analysis,当前版本 1.0.8)能做什么、如何安装,以及在技能目录里如何调用自带脚本。
这是什么¶
该 Skill 由社区发布者 user_bb47e3e3 维护,在 SkillHub 上归类为 it-ops-security,来源为 community。一句话定位:在目标区域内检测人、机动车、非机动车、宠物等对象,支持批量图片分析,面向庭院、果园、养殖场等户外看护与安防监测场景。
技能包内采用通用 SKILL.md 说明触发条件与工作流;实际分析通过技能根目录下的 scripts/outdoor_monitoring.py 调用后端 AI 分析接口,并可将历史报告从云端分页查询。SkillHub 页面标注 requires_api_key=false(指安装该 Skill 本身不要求用户配置商店 API Key);技能说明中要求用户身份由脚本内部自动处理,不向用户索要或展示身份标识。
核心功能¶
以下能力均来自 SkillHub 简介与技能包 SKILL.md,安装后可在本地核对。
- 多目标检测与分类:识别区域内人员、机动车辆、非机动车辆、宠物等目标。
- 统计与安防向输出:支持数量统计、入侵判定、风险等级评估、异常闯入预警等结构化结果(以脚本返回的分析报告为准)。
- 多种输入:本地图片/视频路径或公网 URL;支持格式包括 jpg/jpeg/png/mp4/avi/mov,单文件最大 10MB,并声明支持批量图片分析。
- 历史报告查询:用户表达查看历史监测报告、报告清单等意图时,须通过云端接口拉取列表,技能规定使用
python -m scripts.outdoor_monitoring --list,不得以本地记忆代替。 - 场景码:技能概览中场景码为
OUTDOOR_MONITORING;参考文档references/api_doc.md中另列开放平台场景OPEN_OUTDOOR_MONITORING_ANALYSIS,与后端任务类型对应。
依赖方面,技能要求 Python 环境安装 requests>=2.28.0(见 SKILL.md 前置准备)。
安装与启用¶
安装 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
安装本技能¶
SkillHub 技能页给出的安装提示为:参照 SkillHub 安装文档,安装坐标 @user_bb47e3e3/outdoor-monitoring-analysis。
命令行安装时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 且 Agent 可能无法加载。搜索结果显示的安装命令为:
skillhub install outdoor-monitoring-analysis --namespace user_bb47e3e3 --dir <你的 Agent skills 目录>
常见 Agent 的 skills 路径(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装完成后,按各客户端要求重启或刷新 Agent,使新 Skill 被索引。
典型用法¶
技能约定:所有脚本命令须在技能根目录下执行(即包含 SKILL.md 与 scripts/ 的目录)。Agent 在用户上传户外监控图片/视频或明确要求户外看护、入侵检测时,应触发本技能并调用下列方式之一。
分析本地监控素材:
python -m scripts.outdoor_monitoring --input /path/to/yard.jpg
分析公网 URL(由 API 服务下载资源,无需先下到本地):
python -m scripts.outdoor_monitoring --url https://example.com/garden.mp4
查询云端历史报告列表(技能强制路径,禁止用本地 memory 拼凑清单):
python -m scripts.outdoor_monitoring --list
控制输出粒度或落盘:
python -m scripts.outdoor_monitoring --input capture.jpg --detail basic
python -m scripts.outdoor_monitoring --input capture.jpg --output result.json
可选参数还包括 --api-url(覆盖默认 API 服务地址)、--detail(basic/standard/json,默认 json)。接口路径在 references/api_doc.md 中有索引,例如启动分析、获取结果、分页历史报告等 REST 路径;基础地址由包内 smyx_common 配置统一管理。
技能演示页链接见 SKILL.md:技能使用介绍。
适用场景与注意¶
适合谁:需要在 Agent 对话里处理户外监控截图/短视频、做闯入目标筛查,或查询历史监测报告清单的运维、安防与现场管理人员;输入以庭院、果园、养殖场等开阔户外场景为主。
使用上需注意:
- 分析结果仅供安防参考,不能替代专业安保;技能说明中明确要求发现可疑闯入应及时报警。
- 禁止临时手写替代脚本,只能使用技能包内
scripts/outdoor_monitoring.py等既定入口。 - 历史报告必须走
--list与云端 API,不得从本地会话或长期记忆汇总。 - 网络 URL 需为 API 可访问的公网地址;单文件 10MB 与格式限制需在上传前自检。
- SkillHub 统计(以页面抓取为准):评分 100000,下载 798,安装 3;与第三方转载数据可能不一致,以 SkillHub 为准。
结尾¶
户外看护智能监测分析工具把户外多目标检测、批量图片分析与云端历史报告查询收敛到一套 Skill 工作流里,减少在 Agent 里重复拼装检测命令的成本。需要查看元数据或安装说明时,可打开 SkillHub 技能页与官方坐标页:
- https://www.skillhub.cn/skills/user_bb47e3e3/outdoor-monitoring-analysis
- https://api.skillhub.cn/user_bb47e3e3/outdoor-monitoring-analysis