前言¶
在對話裏問「北京今天會不會下雨」「深圳週末氣溫多少」，如果模型只靠訓練數據或臨時上網搜索，地點、時效和口徑往往對不上。自己接天氣 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 與官方簡介，已覈實的能力包括：
- 實況與預報：通過 CLI 的
weather相關命令查詢；截至文檔中的說明，綜合返回可按需包含實況、日升日落、未來天氣、生活指數、部分城市的七日限號，以及當地有生效預警時的預警分段（是否出現取決於當次查詢，不是固定結構）。 - 行政區粒度：面向中國市級、區縣級；地點參數應使用 Adcode（如北京
110000），用戶只給地名時需先換算再查詢。 - 環境門禁：查詢前用
cli-state檢查 CLI 是否安裝、是否需要更新、API Key 是否已配置；未就緒時 Skill 要求給出可操作的安裝與配置指引，而不是泛化報錯。 - 邊界說明：專門只問預警/異常天氣的場景，文檔指向同系列的
tencent-weather-alert；訂閱、定時提醒類需求當前 CLI 與本 Skill 不支持。 - 失敗策略：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 禁止失敗時改用其他源）。
限制與注意
- 必須配置 API Key：SkillHub 標籤
requires_api_key=true；無 Key 或 Key 無效時，應先按文檔完成獲取與apikey-set，不要把 401/403 誤說成「無數據」。 - 命令隨 CLI 版本變化：每次查詢前以
help weather輸出爲準；文檔中的參數說明僅供參考。 - 預警專問：用戶只問「有沒有預警、最近異常天氣」時，應使用
tencent-weather-alert，與本 Skill 的常規天氣查詢分工不同。 - 無訂閱推送：不要指望 Skill 實現定時提醒或主動推送。
- 平臺數據以 SkillHub 爲準：截至抓取資料，該 Skill 評分 100000，下載 3503 次，安裝 26 次；頁面數據會更新，以 SkillHub 詳情頁 爲準。
結尾¶
騰訊天氣 Skill 把「環境檢查 → CLI 查天氣 → 規範輸出」寫進 Agent 可執行的說明，適合在中國行政區粒度下查實況與預報。安裝 Skill 後，記得補齊 tencent-news-cli 與 API Key，再讓 Agent 按 cli-state 與 help weather 走查詢。
