Weather Broadcast Skill

This skill fetches real-time weather data and generates weather broadcast reports using the free wttr.in API (no API key required).

Trigger Scenarios

Use this skill when users say things like:

• "今天北京天气怎么样？"
• "帮我播报一下上海的天气"
• "未来三天广州天气预报"
• "生成一份早间/晚间天气播报"
• "深圳现在什么天气"
• "明天会下雨吗"（需指定城市）

Workflow

Step 1: Identify the City

Extract the target city from the user's message.

• If the city is in Chinese, convert it to English/pinyin for the API query (refer to references/weather_api.md for common city name mappings).
• If no city is specified, ask the user: "请问您要查询哪个城市的天气？"

Step 2: Determine Output Format

Choose the output format based on user intent:

Determine forecast days:

• Default: --days 3
• If user mentions "今天" only: --days 1
• If user mentions "一周" / "7天": --days 7

Step 3: Run the Fetch Script

Execute the weather fetcher script:

python "C:\Users\zghui\.workbuddy\skills\weather-broadcast\scripts\fetch_weather.py" <CityName> --days <1|3|7> --format <brief|detailed|broadcast>

Examples:

# Brief current weather
python "..." Beijing --days 1 --format brief

# 3-day detailed forecast
python "..." Shanghai --days 3 --format detailed

# Full broadcast report (default)
python "..." Guangzhou --days 3 --format broadcast

Step 4: Present the Result

• Display the script output directly in the response.
• If the weather data indicates extreme conditions (heavy rain, storm, typhoon, extreme heat/cold), add a brief safety reminder.
• Optionally offer: "需要查询其他城市或更详细的天气信息吗？"

Error Handling

• Network timeout / connection error: Inform the user that wttr.in may be temporarily unavailable. Suggest checking network or retrying. Do NOT silently fail.
• Unknown city: The API may return data for a similar city; verify the result makes sense for the requested city.
• Script not found: The script is at C:\Users\zghui\.workbuddy\skills\weather-broadcast\scripts\fetch_weather.py. Verify the path if errors occur.

Reference Files

• references/weather_api.md: API documentation, city name mappings, field descriptions, and fallback data sources.
• scripts/fetch_weather.py: Weather data fetcher script (Python 3, no external dependencies).

Tips

• The wttr.in API is free and requires no authentication — use it directly.
• For Chinese cities, use English transliteration (e.g., "Chengdu" not "成都") in the API call.
• The broadcast format (--format broadcast) produces the most visually appealing output for display.
• Weather data is retrieved in real-time; there is no caching.