天气测试:在 Agent 中按 SKILL.md 规范做天气查询

前言

在 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 交易流程。

  1. 位置解析:中文或英文地名、城市、邮编、经纬度。
  2. 时间范围:当前、今日、未来 N 天、过去某日。
  3. 要素:温度、体感温度、湿度、风速风向、降水、气压、紫外线、空气质量等。
  4. 生活建议:出行、穿衣、防晒、带伞等,按 WMO 天气代码表做现象说明。
  5. 数据源(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
  6. 输出结构:地点与时间、当前状况、预报摘要、生活建议、极端天气提示(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 / 空气质量 / 历史接口 → 格式化输出」。

文档中的示例意图包括:

  1. 当前天气:「北京今天天气怎么样?」
  2. 多日预报:「上海未来三天会下雨吗?」(对应 forecast_days=3,结合 precipitation 与 weather_code)
  3. 对比:「深圳和哈尔滨今天哪个更热?」(并行查询后对比温度与体感)
  4. 穿衣建议:「明天去杭州穿什么?」(基于次日温度区间给出穿衣提示)
  5. 空气质量:「成都今天空气怎么样?」(先取坐标,再调空气质量 API)

预报请求示例参数(Skill 内摘录,需先由地理编码得到 latitude、longitude):

https://api.open-meteo.com/v1/forecast?latitude=<lat>&longitude=<lon>&current=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 的开发者或个人用户。

限制与核对事项

  1. 简介与包内容不一致:商店/API 简介写的是 Polymarket 温度市场与 NOAA 预报交易;当前 0.0.1 包内实现为 Open-Meteo 通用天气查询。若你的目标是预测市场交易,应核对是否有更新版本或其它 Skill,勿仅凭简介假设能力。
  2. 数据与合规:依赖 Open-Meteo 公网接口,需网络可达;精度与覆盖范围以 Open-Meteo 服务为准,Skill 本身不做额外 SLA 承诺。
  3. 命名:包内 YAML name 为 weather,与 SkillHub 展示名「天气测试」、slug weather-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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜