前言¶
在 Agent 裏問一句「明天北京會不會下雨」,常見做法是再接一層天氣 HTTP API:註冊賬號、申請 Key、把密鑰寫進環境變量,還要處理配額和接口變更。對只想在對話裏拿到實況和短期預報的場景,這套流程偏重。
下面介紹 SkillHub 社區技能「天氣」(@user_c73fb2fe/weather-plus-plus)。官方簡介寫明:獲取當前天氣與預報,且 不需要 API Key(標籤 requires_api_key=false)。適合把天氣查詢交給 Agent,而不是自己維護第三方密鑰。
這是什麼¶
「天氣」是 SkillHub 上由發佈者 user_c73fb2fe 維護的社區來源(community)技能,分類爲 life-service,當前版本 1.0.1。
座標(安裝標識):
@user_c73fb2fe/weather-plus-plus
它解決的是:在支持 Skills 的 AI 客戶端裏,用統一技能說明引導 Agent 完成天氣查詢,避免爲每次對話單獨配置開放平臺的 API Key。
SkillHub 頁面:https://www.skillhub.cn/skills/user_c73fb2fe/weather-plus-plus
API 條目:https://api.skillhub.cn/user_c73fb2fe/weather-plus-plus
核心功能¶
依據官方簡介與頁面描述,已覈實能力如下:
- 當前天氣:查詢指定地點的實況信息。
- 天氣預報:在實況之外提供預報類結果(具體粒度以技能包內
SKILL.md爲準;公開頁面未展開字段列表)。 - 免 API Key:標籤標明
requires_api_key=false,安裝後無需在環境變量中配置天氣服務商密鑰。
未在公開資料中出現的接口名、腳本路徑或返回字段,本文不展開。
安裝與啓用¶
SkillHub 提供兩種常見安裝方式:把提示詞發給 AI,或使用 skillhub CLI。先做環境準備,再安裝到當前 Agent 實際讀取的 skills 目錄。
方式一:通過 AI 安裝(官方頁面推薦)¶
將下面提示詞發給正在使用的 Agent(文案來自 SkillHub 技能頁):
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_c73fb2fe/weather-plus-plus`。
Agent 會按 SkillHub 安裝說明 檢查 CLI、選擇目錄並完成安裝。
方式二:使用 skillhub CLI¶
1、確認是否已安裝 CLI:
command -v skillhub && skillhub --version
2、若未安裝,可按官方文檔執行完整安裝(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
3、安裝本技能時,必須用 --dir 指向當前客戶端的 skills 目錄;裝到默認 ./skills/ 可能不會被識別。官方文檔給出的常用路徑示例:
| 客戶端 | skills 目錄(示例) |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令形態(與官方第三節一致,將技能名替換爲本技能座標中的 slug):
skillhub install user_c73fb2fe/weather-plus-plus --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你當前環境對應的路徑。安裝後若客戶端要求重啓或重新加載技能,按其產品說明操作。
典型用法¶
公開頁面未提供獨立腳本示例;用法遵循通用 Agent Skill 模式:安裝並啓用後,在對話中說明地點與需求(例如當前天氣、未來幾天預報),由 Agent 按技能包內的 SKILL.md 調用約定能力。
可復現的起步方式:
- 確認技能已出現在當前 Agent 的 skills 列表中。
- 在對話中寫清地點(城市名或更具體的位置描述)以及要「實況」還是「預報」。
- 若結果不符合預期,檢查是否裝錯目錄、客戶端是否已加載最新技能。
具體命令行工具名、HTTP 端點或輸出格式,以安裝後本地的 SKILL.md 爲準;本文不臆造。
適用場景與注意¶
適合:
- 個人或小團隊在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏做日常天氣問答。
- 希望減少「先申請 Key 再寫配置」的步驟,且接受由社區技能封裝查詢邏輯。
注意:
- 來源爲 community,行爲與數據質量取決於技能實現與上游服務;生產或合規敏感場景請自行評估。
- SkillHub 統計(抓取資料):評分 100000,下載約 1500,安裝計數爲 0——僅反映平臺展示,不代表你的環境下的可用性。
- 免 API Key 不等於無限制:仍可能受上游服務速率、地域解析精度等約束;頁面未說明的限制,需在本地試用中確認。
- 版本以 1.0.1 爲準;升級可走
skillhub的更新流程(參見 安裝文檔)。
結尾¶
「天氣」把「當前天氣 + 預報」和「無需 API Key」寫進同一條技能定位,適合作爲 life-service 類能力裝進 Agent。需要安裝或覈對元數據時,以 SkillHub 官方頁爲準:
https://www.skillhub.cn/skills/user_c73fb2fe/weather-plus-plus