核心用法
Garmin Skill 是连接 AI 与 Garmin Connect 数据的桥梁服务，由 Transition 提供技术支持。用户需先下载 Transition 应用并绑定 Garmin 账户，生成 API Key 后即可通过自然语言与 AI 教练交互。
主要功能模块：
1. AI 教练对话 (/api/v1/coach/chat) — 核心交互入口，支持训练量对比、VO2 Max 趋势分析、过度训练评估、功率数据比较等开放式提问
2. 训练负荷管理 (/api/v1/performance/pmc) — 获取 CTL（体能）、ATL（疲劳）、TSB（状态）三大关键指标，辅助判断训练恢复平衡
3. 运动表现统计 (/api/v1/performance/stats) — 提取 FTP、阈值配速、心率区间等派生指标
4. 日程管理 (/api/v1/workouts) — 查询训练计划，支持推送结构化训练至 Garmin 设备
5. 免费 WOD 生成 — 无需认证即可生成跑步、骑行、游泳、力量训练的随机结构化课表
显著优点
- 自然语言交互：无需学习复杂 API 或查询语法，直接用日常语言提问
- 深度数据整合：聚合 Garmin 原始数据，自动计算 PMC、训练负荷等专业指标
- 双向设备同步：不仅能读取数据，还能推送训练计划至手表
- 零门槛体验：WOD 端点无需认证，降低试用成本
- 实时状态评估：TSB 指标可直接用于疲劳预警，避免过度训练
潜在局限
- 第三方依赖：数据流转需经过 Transition 平台，存在单点故障风险
- 速率限制严格：免费版 AI 对话仅 3 次/天，深度使用需付费订阅
- 地区合规性：未明确说明 GDPR、HIPAA 等数据合规认证
- 数据时效性：依赖 Garmin Connect 同步频率，非实时流式数据
适合人群
- 严肃耐力运动爱好者（跑步、骑行、铁三）
- 需要数据驱动决策的自训运动员
- 教练 remote 监控学员训练状态
- 希望简化数据分析流程的量化运动新手
常规风险
- API Key 泄露：需妥善保管
TRANSITION_API_KEY，建议使用环境变量而非硬编码 - 训练建议责任边界：AI 生成的训练计划不具备医学认证，高强度训练前建议咨询专业教练
- 数据隐私：运动数据包含健康敏感信息，需确认 Transition 的数据处理条款
- 服务连续性：第三方服务存在停止运营风险，建议定期本地备份关键训练数据