佳明健康分析

技能简介

通过自然语言与佳明（Garmin）健康数据对话，支持20余项身体指标查询，包括睡眠阶段、身体电量、心率变异性、最大摄氧量、训练准备度、体脂成分、血氧饱和度等。可下载FIT/GPX文件进行路线分析，查询任意时刻的海拔与配速，并生成交互式健康仪表盘。

业务背景

面向运动健身人群，将专业健康数据转化为可对话的业务洞察。业务人员无需学习复杂的数据工具，通过自然语言即可掌握睡眠恢复、训练负荷、身体状态等核心指标，快速判断当日是否适合高强度训练或需要调整作息，让健康决策像聊天一样简单。

落地案例：健身教练想了解学员本周恢复情况，直接提问"过去7天平均HRV和身体电量趋势"，系统自动调取佳明数据生成对比图表，发现该学员连续三天睡眠不足导致训练准备度下降，及时调整了课程强度。户外爱好者下载滑雪活动的FIT文件后，查询"最大下坡速度"和"海拔变化曲线"，复盘路线难点为下次出行做准备。

能做什么

• 用日常语言提问：”昨晚睡得怎么样？”、”滑雪最快速度是多少？”、”下午3点心率多少？”
• 获取睡眠、身体电量、HRV、静息心率、压力水平等多维度数据
• 按活动类型统计运动量与消耗热量
• 生成30/60/90天趋势图表与综合仪表盘
• 导出原始FIT/GPX文件供深度分析

使用说明

第一步：安装依赖

pip3 install garminconnect fitparse gpxpy

第二步：配置账号（三选一）

• 方式A：在~/.clawdbot/clawdbot.json中设置GARMIN_EMAIL和GARMIN_PASSWORD
• 方式B：复制config.example.json为config.json并填写账号密码
• 方式C：命令行直接传入参数

第三步：登录授权

python3 scripts/garmin_auth.py login

会话令牌自动保存至~/.clawdbot/garmin-tokens.json并自动刷新。

第四步：查询数据

# 睡眠数据（默认7天）
python3 scripts/garmin_data.py sleep --days 14

# 身体电量（30天恢复趋势）
python3 scripts/garmin_data.py body_battery --days 30

# HRV与静息心率
python3 scripts/garmin_data.py hrv --days 30

# 活动汇总
python3 scripts/garmin_data.py activities --days 30

# 综合摘要
python3 scripts/garmin_data.py summary --days 7

第五步：生成图表

# 单项图表
python3 scripts/garmin_chart.py sleep --days 30
python3 scripts/garmin_chart.py body_battery --days 30

# 完整仪表盘
python3 scripts/garmin_chart.py dashboard --days 90 --output ~/Desktop/garmin-health.html

图表自动在浏览器打开，采用Chart.js实现渐变设计与交互提示。

输入与输出

见下方输入与输出表格。

风险提示

• 需存储佳明账号密码，建议使用专用配置文件并确保文件权限安全
• 首次登录需网络连接佳明服务器，国内用户可能受网络环境影响
• 健康数据仅供参考，不作为医疗诊断依据
• FIT/GPX文件较大时解析可能占用较多内存

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/eversonl/garmin-health-analysis/SKILL.md
来源类型：GitHub仓库