前言¶
用户在对话里问「北京今天多少度」「明天会不会下雨」时,模型若没有可靠的外部数据,只能泛泛而谈。自己接天气 API 又要处理密钥、城市名解析和返回格式。SkillHub 上的「天气预报」把这类查询收敛成一条技能:用中英文城市名拉取当前天气和未来 3 天预报,并在简介中说明可在询问气温、降雨、空气质量等场景下使用;标签标明 requires_api_key=false,无需单独配置 API Key。
这是什么¶
「天气预报」是社区来源(community)的生活服务类 Skill,坐标为 @user_20ab24cd/weather-2026,当前版本 1.0.0,由 SkillHub 用户 user_20ab24cd 发布。官方入口:
- Skill 资源:
https://api.skillhub.cn/user_20ab24cd/weather-2026 - SkillHub 页面:
https://www.skillhub.cn/skills/user_20ab24cd/weather-2026
它面向「用户在自然语言里问天气」这一类需求,而不是替代专业气象业务系统。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据中的简介,未单独展开实现细节:
- 当前天气:按城市查询实时气象信息。
- 未来 3 天预报:在同一技能内提供短期预报。
- 城市名:支持中文与英文城市名。
- 触发范围:简介写明在用户询问天气、气温、下雨、空气质量等气象相关问题时使用此技能。
- 依赖:标签
requires_api_key=false,安装侧不要求自备第三方天气 API 密钥(具体数据源以技能包内说明为准)。
安装与启用¶
SkillHub 给出的安装指引是:先按官方安装文档配置 CLI,再安装本技能坐标。
1. 安装 SkillHub CLI(若尚未安装)¶
下面介绍文档 https://skillhub.cn/install/skillhub.md 中的检查与安装方式。先确认是否已有 skillhub:
command -v skillhub && skillhub --version
若未安装,可使用文档中的完整安装命令(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
2. 安装「天气预报」到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录;装到默认 ./skills/ 而 Agent 不认该路径时,技能不会生效。文档中列出的常见路径包括:
| 环境 | skills 目录(摘自安装文档) |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在 Cursor 下,可先创建目录再安装(坐标与 SkillHub 页面一致):
mkdir -p ~/.cursor/skills/
skillhub install user_20ab24cd/weather-2026 --dir ~/.cursor/skills/
SkillHub 页面亦提示:可将「请根据 https://skillhub.cn/install/skillhub.md,安装 @user_20ab24cd/weather-2026」发给 AI,由 Agent 按同一文档完成安装。
经过上面的步骤,重启或重新加载 Agent 后,技能应出现在 skills 列表中;若仍不触发,优先核对 --dir 是否与当前客户端一致。
典型用法¶
公开资料未附带固定 HTTP 示例或样例 JSON,用法以对话触发为主:在已启用该 Skill 的 Agent 中,用自然语言点名城市并说明关注点即可。下列表述与官方简介中的场景一致,便于自测是否路由到本技能:
- 「上海现在天气怎么样?」
- 「Tokyo temperature today and next three days」
- 「广州明天会下雨吗?」
- 「深圳空气质量怎么样?」(简介将空气质量列为适用询问类型)
预期行为是返回该城市的当前天气及未来 3 天预报;若城市名歧义较大,可在提问中写全称或补国家/省份以降低误匹配风险。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code、Codex 等支持 Skill 的客户端里,用对话查天气、气温、短期降雨或简介中提到的空气质量类问题。
- 希望避免自建天气 API 集成,且接受社区 Skill 的更新节奏与数据口径。
注意
- 预报长度为 3 天,更长周期不在简介承诺范围内。
- 分类为
life-service,精度与免责条款应服从技能实际数据源;不宜直接用于航空、防汛等强合规场景。 - 元数据显示来源为 community,使用前可在 SkillHub 页面查看版本 1.0.0 与说明是否有更新。
- 评分、下载量等商店指标会变动;撰写时 SkillHub 元数据为评分 100000、下载 766(与用户线索中的数字不一致时,以页面实时显示为准)。
结尾¶
「天气预报」把城市实况与三日预报封装成 @user_20ab24cd/weather-2026,中英文城市名均可,且无需 API Key 标签所暗示的额外密钥配置。安装时对照 https://skillhub.cn/install/skillhub.md,将技能装进当前 Agent 的 skills 目录即可。详情与安装提示词见 SkillHub:https://www.skillhub.cn/skills/user_20ab24cd/weather-2026,资源地址:https://api.skillhub.cn/user_20ab24cd/weather-2026。