核心功能: 本技能提供中文交互等能力。

运动健康数据（免费版）

使用AI与运动健康数据对话的免费版。支持获取每日训练方案（无需认证）和查询训练记录。通过健康数据同步服务获取运动手环/手表同步的健康数据.

输入参数

配置说明

1. 下载健康数据同步服务应用，授予健康数据访问权限
2. 进入 Settings > API Keys，点击 Generate New Key
3. 设置环境变量：

export HEALTH_API_KEY="${API_KEY:?请设置环境变量}"

认证端点需在请求头中携带 X-API-Key。GET /api/v1/wod 端点无需认证.

依赖与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

如需调用外部API，请参考环境配置章节设置对应密钥

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力清单

1. 每日训练生成

通过 GET /api/v1/wod?sport=run&duration=45 获取随机结构化训练方案，无需认证。参数 sport 支持 run（跑步）、bike（骑行）、swim（游泳）、strength（力量），默认 run。参数 duration 指定训练时长（10-300分钟），默认45。适用于快速获取训练建议.

2. 获取训练记录

通过 GET /api/v1/workouts?start=2026-02-09&end=2026-02-15 获取指定日期范围内的训练记录。必填参数 start 和 end（YYYY-MM-DD格式），最大查询范围90天。返回训练列表，包含训练类型、时长、距离、心率等详细数据。免费版配额100次/天。适用于训练历史回溯.

3. 运动员档案

通过 GET /api/v1/profile 获取运动员档案信息。返回用户的基本信息、运动偏好、历史训练摘要等数据。适用于用户画像构建和基础数据获取。- 验证返回数据的完整性和格式正确性

启动指引

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

升级提示

以下为完整版（apple-health-skill）独有功能，免费版不可用：

• AI教练对话：POST /api/v1/coach/chat 自然语言提问健康数据，完整版配额100次/天
• 性能管理图表（PMC）：GET /api/v1/performance/pmc 获取CTL/ATL/TSB训练负荷数据
• 性能统计：GET /api/v1/performance/stats 获取FTP、阈值配速、心率区间等指标
• 聊天历史：GET /api/v1/coach/history 回顾AI教练对话记录

升级至完整版以获取全部能力.

使用指南

1. 使用 GET /api/v1/wod 获取训练方案（无需认证），指定 sport 和 duration 参数
2. 配置环境变量 HEALTH_API_KEY，通过 GET /api/v1/workouts 查询训练记录（YYYY-MM-DD格式，最大90天）
3. 通过 GET /api/v1/profile 获取运动员档案信息
4. 如需AI教练对话、性能管理图表或性能统计功能，升级至完整版

实际示例

示例1：获取训练方案（无需认证）

# 获取45分钟跑步训练方案
curl "https://health-api.example.com/api/v1/wod?sport=run&duration=45"
# 响应包含结构化训练计划：热身、主训练、放松等阶段
# ...
# 获取30分钟力量训练方案
example.com/api/v1/wod?sport=strength&duration=30"

示例2：查询训练记录

# 获取最近一周的训练记录
curl -H "X-API-Key: $HEALTH_API_KEY" \
  "https://health-api.example.com/api/v1/workouts?start=2026-02-09&end=2026-02-15"
# 响应包含训练类型、时长、距离、心率等数据
# ...
# 获取运动员档案
curl -H "X-API-Key: $HEALTH_API_KEY" \
example.com/api/v1/profile"

异常处理架构

问题汇编

Q1: WOD端点需要认证吗？

不需要。GET /api/v1/wod 是唯一无需认证的端点。参数 sport 支持 run/bike/swim/strength（默认 run），duration 范围10-300分钟（默认45）。适用于快速获取训练方案，无需配置API Key.

Q2: 如何获取API Key？

在健康数据同步服务应用中，进入 Settings > API Keys，点击 Generate New Key 生成密钥。将生成的密钥设置到环境变量 HEALTH_API_KEY 中。认证端点（workouts、profile）需在请求头中携带 X-API-Key: $HEALTH_API_KEY.

Q3: 免费版可以查询训练记录吗？

可以。GET /api/v1/workouts 支持查询训练记录，免费版配额100次/天。参数 start 和 end 使用YYYY-MM-DD格式，最大查询范围90天。返回训练类型、时长、距离、心率等详细数据.

Q4: 免费版可以使用AI教练吗？

不可以。POST /api/v1/coach/chat AI教练对话是完整版独有功能。免费版仅支持训练方案生成、训练记录查询和运动员档案获取。如需AI教练对话，请升级至完整版.

Q5: 免费版可以查看性能管理图表吗？

不可以。GET /api/v1/performance/pmc（CTL/ATL/TSB训练负荷数据）和 GET /api/v1/performance/stats（FTP、心率区间等）是完整版独有功能。如需性能分析和训练负荷监控，请升级至完整版.

Q6: 日期格式有什么要求？

所有日期参数使用YYYY-MM-DD格式（如 2026-02-09）。GET /api/v1/workouts 端点的 start 和 end 参数之间的最大查询范围为90天，超过会返回400错误。需要查询更长时间范围时，分段多次查询.

使用约束

• 不支持AI教练对话（POST /api/v1/coach/chat），完整版可用
• 不支持性能管理图表（GET /api/v1/performance/pmc），完整版可用
• 不支持性能统计（GET /api/v1/performance/stats），完整版可用
• 不支持聊天历史（GET /api/v1/coach/history），完整版可用
• 训练记录查询最大范围90天，超长范围需分段查询
• 免费版读取配额100次/天，需等待次日重置

输出规范

{
  "success": true,
  "data": {
    "result": "运动健康数据基础版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "apple-health-skill"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

<!-- quality-enhanced -->

应用场景

使用场景

• 个人开发者日常Security任务处理
• 团队协作中的自动化流程
• 批量数据处理与格式转换

触发条件

触发条件: 当用户需要处理Security相关任务时自动激活

限制说明

不适用: 超大文件处理(>100MB)或高并发场景(>100QPS)，建议使用专业版或企业方案

创新亮点

效率提升量化分析

差异化对比

核心痛点解决

诊断与修复

安全注意

1. 确保API Key安全，避免泄露。
2. 用户授权访问健康数据时，确保用户隐私得到保护。
3. 数据传输过程中使用HTTPS协议，确保数据安全。
4. 定期检查系统日志，及时发现并处理异常情况。
5. 确保系统更新，及时修复已知漏洞。

安全风险防范

功能特征

• 自动化执行: 基础运动健康数据查询，获取训练方案和训练记录。使用AI与运动健康数据对话的免费版。支持获取每日训练方案（无需认证）和查询
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

问题答疑

Q1: 运动健康数据基础版支持哪些输入格式？

A1: 基础运动健康数据查询，获取训练方案和训练记录。使用AI与运动健康数据对话的免费版。支持获取每日训练方案（无需认证）和查询训练记录. 适用于基础训练数据查看场景。。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。