Garmin Trail-Running Roadmap & Training Plan#

本技能旨在为越野跑者提供一站式的“数据分析 -> 策略制定 -> 计划同步”服务。它能够深度解析佳明手表的运动表现数据，并结合比赛赛道信息生成科学的路书和赛前训练安排。

使用场景#

• 准备参加新的越野比赛，需要根据赛道 GPX 制作分段路书。
• 比赛前 2-3 周，需要根据近期身体状态调整减量训练课表。
• 希望将复杂的训练计划一键同步到 macOS/iOS 系统日历中。
• 需要将枯燥的训练数据转化为通俗易懂的小红书文案进行分享。

核心能力#

1. 佳明数据深度解析与自动化获取#

• 自动化连接：内置 scripts/garmin_auth.py 脚本，支持 佳明中国 (Garmin China) 和全球账号。

• 配置指引：

  • 在技能根目录创建 config.json 或设置环境变量 GARMIN_EMAIL, GARMIN_PASSWORD, GARMIN_IS_CN=True。
  • 运行 python3 scripts/garmin_auth.py login --cn 进行首次授权登录。

• 数据提取：使用 scripts/garmin_query.py 自动获取特定日期的越野跑活动 ID 及详细指标。

• 心率区间对齐：支持 6 区间制（Zone 0-5）深度分析（参考 references/roadmap_standard.md）。

• 爬升数据校准：自动平滑 GPX 抖动，校准真实累计爬升。

2. 智能化路书制作 (v4.0 架构)#

• 分坡度策略：摒弃单一配速目标，改为“心率 + 功率”双控。
• 时间银行逻辑：量化下坡回收能力的战术应用。
• Z3 预算分配：科学计算比赛全程节奏区的使用比例。

3. 动态训练计划同步#

• 提供 scripts/sync_gen.py 脚本，可根据比赛日期自动生成日历同步脚本。
• 自动设置全天事件，包含详细的训练内容、备注和强度建议。

工作流程#

1. 环境准备：

   • 确保已获取比赛 GPX 文件。
   • 获取用户最近一次代表性训练的 Garmin 数据（距离、爬升、心率分布）。

2. 分析阶段：

   • 读取 references/roadmap_standard.md 确认心率定义和量化标准。
   • 对比 GPX 数据与实测表现，识别用户的强项（如：下坡提速）与限制（如：陡坡心率漂移）。

3. 输出阶段：

   • 生成路书 HTML。
   • 运行 scripts/sync_gen.py 生成日历同步代码并执行。
   • （可选）提炼社交媒体分享文案。

关键文档#

• references/roadmap_standard.md: 佳明 6 区间定义及路书制作量化标准。

开发者备注#

• 执行日历同步时需通过 osascript 调用 macOS 日历，确保权限已开启。
• 处理 GPX 时优先进行 5-10 点的平滑移动平均处理以消除海拔噪点。