mcpField
W
weather-hint-tw

weather-hint-tw

github.com/lancetw其他546 次安装8 周前更新
代码仓库

关于 weather-hint-tw

weather-hint-tw 是用于查询单个或多个城市天气的技能,并将天气数据整理为 RPG 风格卡片和对话。它还提供台湾用语、语气及穿搭参考指南。

主要功能

  1. 01查询一个或多个城市天气
  2. 02支持环境变量和位置参数
  3. 03输出 JSON 天气数据
  4. 04生成 RPG 风格天气卡片
  5. 05提供对话与穿搭指南

适用场景

  1. 01查看台北、高雄等多地天气
  2. 02按天气数据生成聊天式提醒
  3. 03根据天气给出穿搭建议

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lancetw/skills --skill weather-hint-tw

安装后在 Claude Code 中输入/weather-hint-tw确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
examples.md
references/
data-fields.md
outfit-guide.md
prompt-guide.md
scripts/
fetch_weather.py

详细介绍

来自项目 README

天氣提醒

查詢天氣

uv run "$(dirname -- "${BASH_SOURCE[0]:-$0}")/scripts/fetch_weather.py"

如果上面的相對路徑不行,用 skill 安裝路徑:

uv run <skill-directory>/scripts/fetch_weather.py

腳本先輸出 RPG 風格的讀取進度條(折疊預覽只會看到「⏳ 正在讀取天氣資料...」),最後一行才是 JSON。

支援 WEATHER_CITY 環境變數或傳參數覆蓋位置(如 uv run ... Tokyo)。 支援多城市查詢(如 uv run ... 台北 高雄 或 WEATHER_CITY="台北,高雄")。 純 Python(只用標準庫),零暫存檔,並行 API 呼叫,輸出一行 JSON。

怎麼回應

  1. 跑腳本取得 JSON
  2. 讀 references/prompt-guide.md(語氣、時段、台灣用語)
  3. 用 display 欄位組卡片(格式見下方「狀態面板」)
  4. 根據 data + prompt-guide 寫對話框
  5. 穿搭:參考 references/outfit-guide.md,自然融入聊天
  6. 多天預報:只在連假/天氣劇變時帶出(不要每次都報)
  7. 卡片 + 對話框一起輸出

輸出格式(RPG 風格)

狀態面板

從 display 欄位逐行組合,每行用 ▎ 開頭。放進 code block(triple backticks) 確保換行。

格式(用 code block 包起來):

```
▎ {display.地點}
▎ ──────────────────
▎ {display.溫度}
▎ {display.天氣}
▎ {display.今日}
▎ {display.明日}
▎ {display.提醒}
▎ {display.降雨預報}
```
  • 提醒 和 降雨預報 不一定存在,有才輸出
  • 多城市時,每張卡片放在同一個 code block 裡,中間空一行
對話框

聊天文字用 ▶ 開頭,自然分段:

▶ 週日晚上了,吃飽沒?

  外面涼涼的,散步不錯。
  空氣霧霧的,口罩帶著吧。
  明天週一天氣差不多,安心收假。

規則:

  • 第一句用 ▶ 開頭(像 RPG 對話指標)
  • 如果從 CLAUDE.md、AGENTS.md 或對話上下文知道使用者的名字,在第一句自然地帶入
  • 後續段落縮排兩格,不加 ▶
  • 3-5 句,每 1-2 句換一行

如果腳本失敗(網路斷、API 掛、timeout):不要假裝有資料。直接跟使用者說「抱歉,天氣資料暫時抓不到,等一下再試試。」

參考文件

文件內容何時讀
references/prompt-guide.md語氣、時段關心、台灣用語、數字規則每次都讀
references/data-fields.mdJSON 欄位說明、活用時機不確定欄位意思時讀
references/outfit-guide.md穿搭建議對照表需要穿搭建議時讀
assets/examples.md12 種情境範例想看範例時讀

评论

支持 Markdown