Weather 使用指南

定位 (Positioning)

weather 是一个基于外部 CLI 的天气查询 workflow，通过 weather 命令获取当前天气、指定日期天气或 hourly forecast，并以 JSON stdio 形式返回结构化结果。

适用场景 (Use When)

• 用户要查询某个城市、坐标或地区的当前天气。
• 用户要看明天或指定日期的天气。
• 用户要查看小时级天气趋势，例如温度、风速、降雨与体感温度。

工具与接口 (Tools)

• 通过 exec_command 调用 weather CLI。
• 默认命令形态是 weather ... --format=raw，这样 stdout 会返回 JSON。

标准流程 (Workflow)

1. 先确认地点输入。
2. 如果用户已经给了经纬度，优先使用 --lat 和 --lon，因为这条路径最稳定，也避免额外 geocoding。
3. 如果用户给的是城市名或地区名，可以直接传 positional location，但要知道这依赖 geocoding，可能比坐标更慢。
4. 默认加上 --format=raw --timeout 10，必要时再补 --date、--hourly、--units 或 --source=open-meteo。
5. 解析 JSON 后，用人类可读方式总结关键天气信息，而不是原样转储整段 JSON。

参数约定 (Parameters)

• 当前天气：
  weather "<location>" --format=raw --timeout 10
• 坐标查询：
  weather --lat <lat> --lon <lon> --format=raw --timeout 10
• 指定日期：
  weather "<location>" --date tomorrow --format=raw --timeout 10
• 小时级预报：
  weather "<location>" --hourly --format=raw --timeout 10
• 单位：
  默认 metric；只有用户明确要求英制单位时再加 --units imperial

边界与风险 (Guardrails)

• 不要默认使用空 location 触发 auto-detect，这会把“当前机器位置”误当成“用户位置”。
• 优先走 open-meteo，因为它不需要 API key，且适合零配置部署。
• 如果地点字符串查询超时或不稳定，优先建议或改用经纬度。
• 输出时应提炼温度、体感、天气状况、风速、湿度与降雨线索，不要把整个 JSON 直接塞给用户。