用途：通过 Garmin Connect 查询健康指标、睡眠数据、活动和训练状态，适合在健康回顾或每日/每周复盘中引用数据。支持即时查询，也可定期生成 Markdown 文件。
前置条件：需配置 Python 虚拟环境（如未完成先运行 setup.sh），并配置 Garmin Connect 凭据。
首次设置：运行 ~/.claude/skills/garmin/scripts/setup.sh。若认证失败（令牌过期、速率限制），重新登录：~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_login.py。支持交互式 MFA，或通过参数传入（garmin_login.py 123456）；非交互式运行时会把 MFA 代码路径写入 /tmp/garmin_mfa.txt。
即时查询：
- 今日生命体征：garmin_health.py today，返回静息心率、HRV、Body Battery、压力、步数、卡路里。
- 指定日期：garmin_health.py 2026-02-22 或 yesterday。
- 每周汇总：garmin_health.py week，返回 7 天生命体征表格及平均值。
- 睡眠：garmin_sleep.py（昨晚）或 garmin_sleep.py 2026-02-22，返回睡眠分数、时长、深睡/浅睡/REM/清醒分解。
- 近期活动：garmin_activities.py 7 或 30，返回活动列表及心率、卡路里、训练效果。
- 训练状态：garmin_activities.py training，返回 VO2 max、训练负荷、训练准备度、训练状态。
定期导入：
- 每日快照：garmin_snapshot.py --output-dir /path/to/health/garmin，可附加日期或 yesterday，输出 <output-dir>/YYYY-MM-DD.md。
- 每周汇总：garmin_rollup.py --output-dir /path/to/health/garmin/weekly，可附加 last 或 2026-W08，输出 <output-dir>/YYYY-WXX.md。
工作流：每日回顾可运行快照记录当日数据并标注异常；每周回顾可运行汇总、与以往周对比、交叉参考其他健康数据并添加备注。快速健康检查可直接提问，如“我的 body battery 是多少？”“我睡得怎么样？”“显示我的训练状态”，Claude 会运行相应查询并返回格式化结果。
错误处理：认证过期会自动刷新；凭据错误会提示重新运行 setup.sh；某日无数据时显示“No data”而非失败；Garmin 服务不可用为 30 秒超时并给出错误；首次登录需 MFA 交互提示。
测试认证：~/.claude/skills/garmin/.venv/bin/python ~/.claude/skills/garmin/scripts/garmin_client.py。
限制：资料未说明支持的平台范围、数据延迟、速率限制细节及除上述命令外的功能，暂未提供。