前言¶

在对话里问「北京今天会不会下雨」「深圳周末气温多少」，如果模型只靠训练数据或临时上网搜索，地点、时效和口径往往对不上。自己接天气 Open API 又要维护密钥、行政区编码和返回格式。下面介绍 SkillHub 上的 腾讯天气（@tencent-adm/tencent-weather）：把查询流程写进通用 SKILL.md，由 Agent 按文档先检查环境，再通过腾讯新闻 CLI 拉取实况与预报。

这是什么¶

腾讯天气 是面向「实况天气、天气预报」查询的 Agent Skill，发布方为腾讯天气，在 SkillHub 上坐标为 @tencent-adm/tencent-weather，当前版本 1.0.5，来源标注为 enterprise，分类 life-service，并带有 requires_api_key=true 标签（需配置 API Key 后才能调用底层能力）。

一句话：用户用自然语言问某地天气时，已安装该 Skill 的 Agent 会走 tencent-news-cli 的天气能力，覆盖中国市级和区县级行政区；数据与展示规则以 CLI 实际返回为准，Skill 要求结果末尾保留「来源：腾讯天气」。

核心功能¶

依据 Skill 包内 SKILL.md 与官方简介，已核实的能力包括：

1. 实况与预报：通过 CLI 的 weather 相关命令查询；截至文档中的说明，综合返回可按需包含实况、日升日落、未来天气、生活指数、部分城市的七日限号，以及当地有生效预警时的预警分段（是否出现取决于当次查询，不是固定结构）。
2. 行政区粒度：面向中国市级、区县级；地点参数应使用 Adcode（如北京 110000），用户只给地名时需先换算再查询。
3. 环境门禁：查询前用 cli-state 检查 CLI 是否安装、是否需要更新、API Key 是否已配置；未就绪时 Skill 要求给出可操作的安装与配置指引，而不是泛化报错。
4. 边界说明：专门只问预警/异常天气的场景，文档指向同系列的 tencent-weather-alert；订阅、定时提醒类需求当前 CLI 与本 Skill 不支持。
5. 失败策略：CLI 执行失败后不得改用 Web 搜索或其他数据源补查。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可执行完整安装或仅 CLI（以 SkillHub 安装文档 为准）：

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. 将 Skill 装到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。常见路径（同官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装腾讯天气：

skillhub install tencent-weather --namespace tencent-adm --dir ~/.cursor/skills

将 --dir 换成你当前环境对应目录即可。SkillHub 页面也支持把下面话术发给 Agent，让其按 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/tencent-weather。

3. 安装并配置 tencent-news-cli¶

Skill 依赖全局（或兼容路径下的）tencent-news-cli，与 Skill 目录内的 scripts/run-cli.sh / run-cli.ps1 配合调用。

macOS / Linux：

curl -fsSL https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.sh | sh

Windows PowerShell：

irm https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.ps1 | iex

安装后重新打开终端，用 tencent-news-cli help 确认可用。

API Key：在浏览器打开 https://news.qq.com/exchange?scene=appkey 按页面获取 Key，在本地终端设置（勿把真实 Key 发给 Agent 或写入公开仓库）：

tencent-news-cli apikey-set YOUR_KEY
tencent-news-cli apikey-get

Skill 内亦可通过包装脚本设置（YOUR_KEY 为裸值、不加引号）：

sh scripts/run-cli.sh apikey-set KEY
sh scripts/run-cli.sh apikey-get

Windows 对应 powershell scripts/run-cli.ps1 apikey-set KEY 等命令，详见 Skill 包内 references/env-setup-guide.md。

典型用法¶

环境就绪后，用户侧最常见的方式是自然语言提问，例如：「上海浦东新区今天天气怎么样」「用 Adcode 110000 查北京未来几天」。Agent 按 Skill 分阶段执行。

Phase 1：状态检查（在 Skill 目录下，macOS / Linux 示例）：

sh scripts/cli-state.sh

关注 JSON 中的 cliExists、update.needUpdate、apiKey.status（configured / missing / error）。未安装 CLI 或 Key 缺失时，先完成上一节的安装与 apikey-set，再进入查询。

Phase 2：天气查询（命令以当前 CLI 的 help weather 为准，不要硬记子命令）：

sh scripts/run-cli.sh help weather

根据帮助选择命令；文档说明截至 2026-08-07 的 CLI 以单一 weather 命令为主，常用参数包含 --adcode（不传时可能按 IP 定位默认地区）。示例（Adcode 需与地点一致）：

sh scripts/run-cli.sh weather --adcode 110000

若 CLI 已返回排版好的 Markdown 文本，Skill 要求原样输出；若为结构化字段，再整理成包含地点、现象、温度等可读结果，并保留 **来源：腾讯天气**。

适用场景与注意¶

适合谁

• 已在 Cursor、Claude Code、Codex 等支持 Skill 的客户端里工作，希望对话内稳定查国内市、区县天气的开发者或团队。
• 愿意使用腾讯新闻 CLI + API Key，并接受查询结果完全来自该链路（Skill 禁止失败时改用其他源）。

限制与注意

1. 必须配置 API Key：SkillHub 标签 requires_api_key=true；无 Key 或 Key 无效时，应先按文档完成获取与 apikey-set，不要把 401/403 误说成「无数据」。
2. 命令随 CLI 版本变化：每次查询前以 help weather 输出为准；文档中的参数说明仅供参考。
3. 预警专问：用户只问「有没有预警、最近异常天气」时，应使用 tencent-weather-alert，与本 Skill 的常规天气查询分工不同。
4. 无订阅推送：不要指望 Skill 实现定时提醒或主动推送。
5. 平台数据以 SkillHub 为准：截至抓取资料，该 Skill 评分 100000，下载 3503 次，安装 26 次；页面数据会更新，以 SkillHub 详情页 为准。

结尾¶

腾讯天气 Skill 把「环境检查 → CLI 查天气 → 规范输出」写进 Agent 可执行的说明，适合在中国行政区粒度下查实况与预报。安装 Skill 后，记得补齐 tencent-news-cli 与 API Key，再让 Agent 按 cli-state 与 help weather 走查询。

• SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencent-weather
• 官方入口：https://api.skillhub.cn/tencent-adm/tencent-weather