健康数据助手 (免费版)

概述

本工具帮助个人用户通过自然语言与 Apple Health 数据进行交互。无需复杂配置,只需配合 Transition 同步服务即可在聊天中查询运动记录、心率趋势、活动圆环进度等核心健康数据,让 AI 教练为你解读数据背后的健康信号。

免费版聚焦个人用户的日常查询场景,适合运动爱好者、健身新手以及希望系统了解自身健康指标的人群。

核心能力

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
- 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
- 执行此能力时使用output_format参数,支持导出/保存/转换操作
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：个人用户与、Apple、健康数据对话查询、支持运动、活动圆环等基础问、面向个人用户的健、康数据查询助手、通过自然语言与、Health、数据交互、核心能力、教练问答、适用场景、个人健身追踪、日常健康自检、运动习惯养成、差异化、免费版聚焦核心查、询能力、适合单用户日常使、配置简单开箱即用、适用关键词、fitness、workout等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一: 日常运动自检

用户询问最近一周运动情况,助手汇总并给出建议。

<!-- Code block removed for WAF compatibility -->

场景二: 训练计划生成

无需认证即可获取当日推荐训练。

<!-- Code block removed for WAF compatibility -->

支持的 sport 参数: run(跑步)、bike(骑行)、swim(游泳)、strength(力量)。

场景三: 心率趋势回顾

查询最近一个月的静息心率变化。

<!-- Code block removed for WAF compatibility -->

不适用场景

以下场景健康数据助手免费版不适合处理：

• 实时流数据处理
• 小规模数据手动分析
• 非结构化文本情感分析

触发条件

需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求。

快速开始

依赖详情

在 iPhone 上下载 Transition 应用,授予 Apple Health 数据访问权限。

Step 2: 生成 API Key

打开应用,进入 Settings > API Keys,点击 Generate New Key 生成密钥。

Step 3: 配置环境变量

<!-- Code block removed for WAF compatibility -->

可将此行加入 ~/.bashrc 或 ~/.zshrc 持久化配置。

Step 4: 验证连通性

<!-- Code block removed for WAF compatibility -->

示例

基础配置文件

<!-- Code block removed for WAF compatibility -->

运动查询示例

<!-- Code block removed for WAF compatibility -->

优选实践

1. 善用自然语言教练

AI 教练掌握你的全部健康数据上下文,直接用自然语言提问比拼装 API 参数更高效。

<!-- Code block removed for WAF compatibility -->

2. 关注疲劳指标

在安排高强度训练前,先检查疲劳状态。

<!-- Code block removed for WAF compatibility -->

当 TSB 低于 -20 时,说明身体处于疲劳状态,建议安排恢复训练。

3. 日期格式统一

所有日期参数使用 YYYY-MM-DD 格式,避免歧义。查询区间最大跨度为 90 天。

已知限制

免费版每日读取接口 100 次、AI 教练 3 次。建议将常用查询结果缓存到本地。

<!-- Code block removed for WAF compatibility -->

常见问题

Q1: API Key 在哪里获取?

在 iPhone 的 Transition 应用中,Settings > API Keys > Generate New Key 生成。Key 只显示一次,请妥善保存。

常见问题

每日 0 点 UTC 重置。如需更多次数,可升级至 PRO 版本,每日 AI 教练额度提升至 100 次。

Q3: 必须是 iPhone 用户才能用吗?

是的,Apple Health 数据来源于 iOS 设备。Android 用户请考虑其他健康数据源。

Q4: 数据会保存多久?

Transition 会持续同步 Apple Health 数据,免费版保留最近 90 天完整数据,更早的数据仅保留聚合指标。

Q5: 支持哪些运动类型?

跑步、骑行、游泳、力量训练、瑜伽、徒步等 Apple Health 支持的全部运动类型。

依赖说明

运行环境

• Agent 平台: 支持 SKILL.md 规范的任意 AI Agent (Claude Code、Cursor、Codex、Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 网络: 需访问 api.transition.fun 域名
• 数据源: 需 iPhone 设备 + Transition 应用同步 Apple Health 数据

第三方依赖

API Key 配置

<!-- Code block removed for WAF compatibility -->

安全提示: 切勿将 API Key 提交到代码仓库,建议加入 .gitignore。

可用性分类

• 分类: MD+execute(Markdown 指令 + 命令行执行)
• 说明: 本 Skill 通过自然语言指令驱动 Agent 调用 Transition API,完成 Apple Health 数据查询与分析
• 免费版限制: AI 教练每日 3 次,读取接口每日 100 次,仅支持单用户使用

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比