pp-weather-goat

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Weather Goat — Printing Press CLI

Prerequisites: Install the CLI

前置条件：安装CLI

This skill drives the

weather-goat-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install weather-goat --cli-only

Verify:
```
weather-goat-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

本Skill基于

weather-goat-pp-cli

二进制文件运行。在调用本Skill的任何命令前，必须确认CLI已安装。如果未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install weather-goat --cli-only

验证安装：
```
weather-goat-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等），可改用直接Go安装方式（要求Go 1.23+版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-cli@latest

如果执行

--version

时提示“command not found”，说明安装程序未将二进制文件添加到

$PATH

中。请在验证成功前不要执行Skill相关命令。

When to Use This CLI

何时使用本CLI

Reach for this when a user wants a weather lookup, storm or alert check, air-quality read, activity recommendation (bike, hike, walk, commute, drive) based on current conditions, or a "is today normal for this time of year" comparison. Particularly valuable as a morning-briefing source with

weather-goat-pp-cli

(no args → current + today's forecast + active alerts for your configured home location).

Don't reach for this when the user needs hyperlocal or commercial-grade meteorology (use a paid provider like Tomorrow.io or ECMWF), or for international severe-weather alerts (NWS is US-only).

当用户需要查询天气、风暴或预警信息、空气质量读数、基于当前天气的活动建议（骑行、徒步、步行、通勤、驾车），或者需要对比“今日天气是否符合当前季节常态”时，可使用本工具。尤其适合作为晨间简报工具，直接执行

weather-goat-pp-cli

（无参数）即可获取配置的家庭所在地的当前天气+今日预报+活跃预警信息。

以下情况不建议使用本工具：用户需要超本地化或商业级气象数据（请使用Tomorrow.io或ECMWF等付费服务商），或需要美国以外地区的恶劣天气预警（NWS仅覆盖美国）。

Unique Capabilities

独特功能

Activity verdicts — the differentiator

活动判定——核心差异化功能

go walk|bike|hike|commute|drive [location]
— GO / CAUTION / STOP verdict for a specific activity, with reasoning.
Turns "look at the weather" into "what should I do." Each activity has its own thresholds.
- walk — preparation advice (umbrella? jacket? sunscreen? layers?)
- bike — wind, rain, AQI, ice thresholds tuned for cycling
- hike — lightning, hypothermia risk, altitude UV
- commute — compares AM departure vs PM return weather (time-aware)
- drive — visibility, ice, wind gusts, NWS warnings

go walk|bike|hike|commute|drive [location]
——针对特定活动给出GO/CAUTION/STOP判定，并附上理由。
将“查看天气”转化为“我该怎么做”。每项活动都有专属阈值。
- walk ——提供准备建议（是否需要雨伞？外套？防晒霜？分层穿搭？）
- bike ——针对骑行场景优化的风速、降雨、AQI、结冰阈值
- hike ——雷电、低体温风险、高海拔紫外线情况
- commute ——对比早高峰出发与晚高峰返程的天气（时间感知型）
- drive ——能见度、结冰、阵风、NWS预警情况

Severe weather intelligence

恶劣天气智能监测

alerts [location]
— Active NWS warnings: tornado, storm, flood, heat. Structured output with severity and area polygons.
watch [location]
— Poll NWS every 60 seconds during active severe weather. Prints new/updated alerts as they arrive. For running during a storm.

alerts [location]
——获取活跃的NWS预警：龙卷风、风暴、洪水、高温。输出包含严重程度和影响区域多边形的结构化数据。
watch [location]
——在恶劣天气活跃期间，每60秒轮询NWS。当有新预警或预警更新时自动打印信息。适合在风暴期间持续运行。

Context and comparison

情境与对比分析

normal [location]
— Is today normal for this time of year? Compares today's high/low/precip against historical average for the same date.
compare <location1> <location2> [...]
— Side-by-side forecast for 2+ locations. Useful for travel planning or "which city is the weather better this weekend."
morning-brief
(or just
```
weather-goat-pp-cli
```
with no args, if
```
config set-location
```
was run) — Current conditions + today's forecast + active NWS alerts in one call. The daily-kickoff command.

normal [location]
——今日天气是否符合当前季节常态？将今日的最高/最低气温、降水量与历史同期平均值对比。
compare <location1> <location2> [...]
——同时展示2个及以上地点的预报。适用于旅行规划或对比“哪个城市本周末天气更好”。
morning-brief
（或在执行
```
config set-location
```
后直接运行无参数的
```
weather-goat-pp-cli
```
）——一次调用即可获取当前天气+今日预报+活跃NWS预警。作为每日启动命令使用。

Air, UV, and pollen

空气、紫外线与花粉监测

breathe [location]
— AQI + pollen + UV with an exercise recommendation.
air-quality [location]
— Detailed AQI with PM2.5, ozone, etc.
weather_codes
— Reference for Open-Meteo weather code mappings (internal but useful when working with
```
--json
```
output).

breathe [location]
——获取AQI+花粉+紫外线数据，并给出运动建议。
air-quality [location]
——获取包含PM2.5、臭氧等指标的详细AQI数据。
weather_codes
——Open-Meteo天气代码映射参考（内部工具，但在处理
```
--json
```
输出时很有用）。

Command Reference

命令参考

Core:

weather-goat-pp-cli

— Morning brief (requires

config set-location

first, or pass

[location]

)

```
weather-goat-pp-cli forecast [location]
```
— Multi-day forecast
```
weather-goat-pp-cli alerts [location]
```
— Active NWS severe weather
```
weather-goat-pp-cli history [location]
```
— Historical weather

Activity:

weather-goat-pp-cli go <activity> [location]

—

walk

bike

hike

commute

drive

Air / environment:

```
weather-goat-pp-cli breathe [location]
```
— AQI + pollen + UV brief

weather-goat-pp-cli air-quality [location]

— Detailed AQI

Context:

```
weather-goat-pp-cli normal [location]
```
— Today vs historical average

weather-goat-pp-cli compare <loc1> <loc2>

— Side-by-side

```
weather-goat-pp-cli watch [location]
```
— Live NWS monitoring loop

Config + utility:

weather-goat-pp-cli config set-location <place>

— Set home location

```
weather-goat-pp-cli geocoding <name>
```
— Resolve place names to coordinates
```
weather-goat-pp-cli doctor
```
— Verify connectivity

核心命令：

```
weather-goat-pp-cli
```
——晨间简报（需先执行
```
config set-location
```
，或传入
```
[location]
```
参数）
```
weather-goat-pp-cli forecast [location]
```
——多日天气预报
```
weather-goat-pp-cli alerts [location]
```
——活跃NWS恶劣天气预警
```
weather-goat-pp-cli history [location]
```
——历史天气数据

活动相关命令：

weather-goat-pp-cli go <activity> [location]

——支持

walk

、

bike

、

hike

、

commute

、

drive

活动类型

空气/环境相关命令：

```
weather-goat-pp-cli breathe [location]
```
——AQI+花粉+紫外线简报

weather-goat-pp-cli air-quality [location]

——详细AQI数据

情境分析命令：

```
weather-goat-pp-cli normal [location]
```
——今日与历史平均值对比

weather-goat-pp-cli compare <loc1> <loc2>

——多地点并排对比

```
weather-goat-pp-cli watch [location]
```
——NWS实时监测循环

配置与工具命令：

weather-goat-pp-cli config set-location <place>

——设置家庭所在地

```
weather-goat-pp-cli geocoding <name>
```
——将地点名称解析为坐标
```
weather-goat-pp-cli doctor
```
——验证网络连接

Recipes

使用示例

"Should I bike to work today?"

“我今天适合骑车上班吗？”

bash

weather-goat-pp-cli go bike --agent

Returns a structured GO/CAUTION/STOP verdict with reasoning — wind speed, precipitation, AQI, temperature, ice risk — weighted for cycling specifically.

bash

weather-goat-pp-cli go bike --agent

返回结构化的GO/CAUTION/STOP判定及理由——针对骑行场景加权计算风速、降水、AQI、气温、结冰风险等因素。

Morning briefing after setting home location

设置家庭所在地后的晨间简报

bash

weather-goat-pp-cli config set-location "Seattle, WA"
weather-goat-pp-cli --agent  # morning brief — no args

Once location is saved, the no-arg invocation returns current conditions + today's forecast + active NWS alerts. Run from a shell startup script or cron at 7am.

bash

weather-goat-pp-cli config set-location "Seattle, WA"
weather-goat-pp-cli --agent  # 晨间简报——无参数

设置地点后，无参数调用即可返回当前天气+今日预报+活跃NWS预警。可在Shell启动脚本或Cron中设置为早上7点自动运行。

Travel decision — which city is better this weekend?

旅行决策——哪个城市本周末天气更好？

bash

weather-goat-pp-cli compare "Portland, OR" "San Francisco, CA" --days 3 --agent

Side-by-side 3-day forecast for both. One glance picks the trip destination.

bash

weather-goat-pp-cli compare "Portland, OR" "San Francisco, CA" --days 3 --agent

展示两个城市的3天并排预报，一眼即可选定旅行目的地。

Watch for severe weather during a warning

预警期间监测恶劣天气

bash

weather-goat-pp-cli watch --agent &  # background poll every 60s

Runs indefinitely; prints JSON events to stdout when alerts change. Pipe into a logging tool or Slack webhook for alerting.

bash

weather-goat-pp-cli watch --agent &  # 后台每60秒轮询

持续运行；当预警变化时向stdout输出JSON事件。可将输出管道到日志工具或Slack webhook实现告警。

Is today unusually hot?

“今天是不是异常炎热？”

bash

weather-goat-pp-cli normal --agent

Returns today's high/low/precip alongside the 30-year historical average for the same calendar date. Easy "is this a heat wave" check.

bash

weather-goat-pp-cli normal --agent

返回今日最高/最低气温、降水量，以及对应日历日期的30年历史平均值。轻松判断是否为热浪天气。

Auth Setup

认证设置

None required. Open-Meteo is free and unlimited; NWS is free and US-public-data. The

auth

command exists for consistency but is a no-op.

Optional config:

```
WEATHER_GOAT_CONFIG
```
— override config file path

Home location persisted to

~/.config/weather-goat-pp-cli/config.toml

via

config set-location

无需认证。Open-Meteo免费且无使用限制；NWS为美国公共数据，免费使用。

auth

命令仅为保持一致性而存在，实际无操作。

可选配置：

```
WEATHER_GOAT_CONFIG
```
——覆盖配置文件路径

家庭所在地通过

config set-location

持久化到

~/.config/weather-goat-pp-cli/config.toml

Agent Mode

Agent模式

Add

--agent

to any command. Expands to

--json --compact --no-input --no-color --yes

. Use

--days N

for forecast range on relevant commands,

--no-cache

to bypass the 15-minute GET cache.

在任何命令后添加

--agent

参数。该参数等价于

--json --compact --no-input --no-color --yes

。在相关命令中使用

--days N

指定预报范围，使用

--no-cache

绕过15分钟GET缓存。

Filtering output

输出过滤

--select

accepts dotted paths to descend into nested responses; arrays traverse element-wise:

bash

weather-goat-pp-cli <command> --agent --select id,name
weather-goat-pp-cli <command> --agent --select items.id,items.owner.name

Use this to narrow huge payloads to the fields you actually need — critical for deeply nested API responses.

--select

接受点路径以遍历嵌套响应；数组将逐个元素遍历：

bash

weather-goat-pp-cli <command> --agent --select id,name
weather-goat-pp-cli <command> --agent --select items.id,items.owner.name

使用该参数可将庞大的响应缩小到实际需要的字段——对于深度嵌套的API响应至关重要。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error
3	Location not found (geocoding failed)
5	API error (Open-Meteo or NWS issue)
7	Rate limited (very rare; Open-Meteo is unlimited)

代码	含义
0	成功
2	使用错误
3	地点未找到（地理编码失败）
5	API错误（Open-Meteo或NWS故障）
7	速率限制（非常罕见；Open-Meteo无限制）

Installation

安装方式

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-cli@latest
weather-goat-pp-cli config set-location "Your City, ST"
weather-goat-pp-cli doctor

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-cli@latest
weather-goat-pp-cli config set-location "Your City, ST"
weather-goat-pp-cli doctor

MCP Server

MCP服务器

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-mcp@latest
claude mcp add weather-goat-pp-mcp -- weather-goat-pp-mcp

bash

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-pp-mcp@latest
claude mcp add weather-goat-pp-mcp -- weather-goat-pp-mcp

Argument Parsing

参数解析规则

Given

$ARGUMENTS

Empty,
help
, or
--help
→ run
```
weather-goat-pp-cli --help
```
install
→ CLI; install mcp
→ MCP
Activity queries ("should I bike/walk/hike...") →
```
go <activity> [location] --agent
```
Severe weather ("any tornado warnings", "storms coming") →
```
alerts [location] --agent
```
Comparison ("better weather in X or Y") →
```
compare <loc1> <loc2> --agent
```
Anything else →
```
forecast [location]
```
(or morning brief if no location passed and home is configured)

针对

$ARGUMENTS

：

为空、
help
或
--help
→ 执行
```
weather-goat-pp-cli --help
```
install
→ 安装CLI；install mcp
→ 安装MCP
活动查询（“我适合骑车/步行/徒步吗...”） → 执行
```
go <activity> [location] --agent
```
恶劣天气查询（“有龙卷风预警吗”“风暴要来吗”） → 执行
```
alerts [location] --agent
```
对比查询（“X和Y哪个地方天气更好”） → 执行
```
compare <loc1> <loc2> --agent
```
其他情况 → 执行
```
forecast [location]
```
（如果未传入地点且已配置家庭所在地，则执行晨间简报）

Agent Workflow Features

Agent工作流功能

This CLI exposes three shared agent-workflow capabilities patched in from cli-printing-press PR #218.

本CLI提供三个从cli-printing-press PR #218移植的通用Agent工作流功能。

Named profiles

命名配置文件

Persist a set of flags under a name and reuse them across invocations.

bash

undefined

将一组标志持久化为名称，并在多次调用中复用。

bash

undefined

Save the current non-default flags as a named profile

将当前非默认标志保存为命名配置文件

weather-goat-pp-cli profile save <name>

Use a profile — overlays its values onto any flag you don't set explicitly

使用配置文件——其值将覆盖未显式设置的标志

weather-goat-pp-cli --profile <name> <command>

List / inspect / remove

列出/查看/删除

weather-goat-pp-cli profile list weather-goat-pp-cli profile show <name> weather-goat-pp-cli profile delete <name> --yes


Flag precedence: explicit flag > env var > profile > default.

weather-goat-pp-cli profile list weather-goat-pp-cli profile show <name> weather-goat-pp-cli profile delete <name> --yes


标志优先级：显式标志 > 环境变量 > 配置文件 > 默认值。

--deliver

Route command output to a sink other than stdout. Useful when an agent needs to hand a result to a file, a webhook, or another process without plumbing.

bash

weather-goat-pp-cli <command> --deliver file:/path/to/out.json
weather-goat-pp-cli <command> --deliver webhook:https://hooks.example/in

File sinks write atomically (tmp + rename). Webhook sinks POST

application/json

(or

application/x-ndjson

when

--compact

is set). Unknown schemes produce a structured refusal listing the supported set.

将命令输出路由到stdout以外的目标。当Agent需要将结果传递到文件、webhook或其他进程时非常有用，无需额外管道配置。

bash

weather-goat-pp-cli <command> --deliver file:/path/to/out.json
weather-goat-pp-cli <command> --deliver webhook:https://hooks.example/in

文件目标采用原子写入（先写入临时文件再重命名）。Webhook目标以

application/json

格式POST（当设置

--compact

时为

application/x-ndjson

格式）。未知协议会返回结构化拒绝信息，并列出支持的协议类型。

feedback

Record in-band feedback about this CLI from the agent side of the loop. Local-only by default; safe to call without configuration.

bash

weather-goat-pp-cli feedback "what surprised you or tripped you up"
weather-goat-pp-cli feedback list         # show local entries
weather-goat-pp-cli feedback clear --yes  # wipe

Entries append to

~/.weather-goat-pp-cli/feedback.jsonl

as JSON lines. When

WEATHER_GOAT_FEEDBACK_ENDPOINT

is set and either

--send

is passed or

WEATHER_GOAT_FEEDBACK_AUTO_SEND=true

, the entry is also POSTed upstream (non-blocking — local write always succeeds).

从Agent侧记录关于本CLI的即时反馈。默认仅本地存储；无需配置即可安全调用。

bash

weather-goat-pp-cli feedback "what surprised you or tripped you up"
weather-goat-pp-cli feedback list         # 显示本地记录
weather-goat-pp-cli feedback clear --yes  # 清空记录

记录以JSON行格式追加到

~/.weather-goat-pp-cli/feedback.jsonl

。当设置

WEATHER_GOAT_FEEDBACK_ENDPOINT

且传入

--send

参数或设置

WEATHER_GOAT_FEEDBACK_AUTO_SEND=true

时，记录还会被POST到上游服务器（非阻塞——本地写入始终成功）。