前言¶
在 Cursor、Claude Code 等环境里,用户经常用自然语言问「某地今天多少度、要不要带伞」。若每次靠模型即兴编造,既不可靠,也难统一数据源和输出结构。社区里有人把查询流程写进 Skill,让 Agent 按固定步骤调 API、整理回复。
下面介绍 SkillHub 上的 天气测试(@user_f6829dd1/weather-t)。安装前建议先看商店简介与包内文档是否一致;本文核心能力以 v0.0.1 安装包内的 SKILL.md 为准(经 skillhub install 核对)。
这是什么¶
天气测试 是 SkillHub community 来源的技能,坐标 @user_f6829dd1/weather-t,当前版本 0.0.1,分类为 life-service,发布者为 user_f6829dd1。商店页面与 API 元数据中的简介为:
Trade Polymarket weather markets using NOAA forecasts with dynamic confidence modeling and quality filtering. Use when user wants to trade temperature markets with advanced safeguards.
同一坐标下载得到的 SKILL.md 则把该 Skill 定义为「天气数据助手」:解析地点与时间范围,用 Open-Meteo 系列接口查当前天气、预报与历史数据,并给出生活建议。标签 requires_api_key=false,与文档中「Open-Meteo 免费、无需 API Key」一致。
SkillHub 页面(截至核对时):评分 100000,下载 1400,安装计数 0。页面地址:https://www.skillhub.cn/skills/user_f6829dd1/weather-t。
核心功能¶
以下均来自 v0.0.1 包内 SKILL.md,不含商店简介里未在包内出现的 Polymarket / NOAA 交易流程。
- 位置解析:中文或英文地名、城市、邮编、经纬度。
- 时间范围:当前、今日、未来 N 天、过去某日。
- 要素:温度、体感温度、湿度、风速风向、降水、气压、紫外线、空气质量等。
- 生活建议:出行、穿衣、防晒、带伞等,按 WMO 天气代码表做现象说明。
- 数据源(Open-Meteo):
- 预报:https://api.open-meteo.com/v1/forecast(forecast_days默认 7 天,最多 16 天)
- 地理编码:https://geocoding-api.open-meteo.com/v1/search(name、language=zh)
- 空气质量:https://air-quality-api.open-meteo.com/v1/air-quality
- 历史:https://archive-api.open-meteo.com/v1/archive - 输出结构:地点与时间、当前状况、预报摘要、生活建议、极端天气提示(Skill 内对回复段落有约定)。
安装与启用¶
方式一:让 AI 按 SkillHub 指引安装¶
将下面提示词发给当前 Agent(与 SkillHub 页面一致):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_f6829dd1/weather-t`。
方式二:SkillHub CLI¶
先确认 CLI 是否可用(完整步骤见 SkillHub 安装文档):
command -v skillhub && skillhub --version
安装技能时 必须 使用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别:
skillhub install weather-t --namespace user_f6829dd1 --dir <你的 skills 目录>
常用路径示例(来自官方安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
安装完成后,按你所用客户端的要求刷新或重启,使 Skill 被加载。
典型用法¶
Skill 未提供独立脚本,用法体现在 SKILL.md 描述的对话模式里。启用后,可用自然语言触发,Agent 应按文档走「地理编码 → 请求 forecast / 空气质量 / 历史接口 → 格式化输出」。
文档中的示例意图包括:
- 当前天气:「北京今天天气怎么样?」
- 多日预报:「上海未来三天会下雨吗?」(对应
forecast_days=3,结合precipitation与weather_code) - 对比:「深圳和哈尔滨今天哪个更热?」(并行查询后对比温度与体感)
- 穿衣建议:「明天去杭州穿什么?」(基于次日温度区间给出穿衣提示)
- 空气质量:「成都今天空气怎么样?」(先取坐标,再调空气质量 API)
预报请求示例参数(Skill 内摘录,需先由地理编码得到 latitude、longitude):
https://api.open-meteo.com/v1/forecast?latitude=<lat>&longitude=<lon>¤t=temperature_2m,relative_humidity_2m,apparent_temperature,wind_speed_10m,wind_direction_10m,weather_code,precipitation,pressure_msl,uv_index&forecast_days=7
中国大陆用户默认摄氏度;文档说明可按需提供华氏度(℉ = ℃ × 9/5 + 32)。
适用场景与注意¶
适合谁
- 已在 Cursor / Claude Code / Codex 等环境使用 Skills,希望用 Open-Meteo 做可复现的天气问答,且不想自备 API Key 的开发者或个人用户。
限制与核对事项
- 简介与包内容不一致:商店/API 简介写的是 Polymarket 温度市场与 NOAA 预报交易;当前 0.0.1 包内实现为 Open-Meteo 通用天气查询。若你的目标是预测市场交易,应核对是否有更新版本或其它 Skill,勿仅凭简介假设能力。
- 数据与合规:依赖 Open-Meteo 公网接口,需网络可达;精度与覆盖范围以 Open-Meteo 服务为准,Skill 本身不做额外 SLA 承诺。
- 命名:包内 YAML
name为weather,与 SkillHub 展示名「天气测试」、slugweather-t不同,排查加载问题时以目录名与坐标为准。
结尾¶
天气测试(@user_f6829dd1/weather-t)在 SkillHub 上列为生活服务类社区 Skill;安装后按 SKILL.md 使用,可把 Open-Meteo 预报与空气质量查询嵌进 Agent 对话。使用前请对照商店简介与包内文档,确认版本是否满足你的场景。
官方页面:https://www.skillhub.cn/skills/user_f6829dd1/weather-t
API 元数据入口:https://api.skillhub.cn/user_f6829dd1/weather-t