Apple Health Skill

该 Skill 提供 Transition 平台接口的调用说明：无需认证的每日随机训练生成，以及需 X-API-Key 的 AI 教练问答、训练记录、体能管理图表、体能统计、运动员档案与聊天历史查询，并附速率限制和代理使用建议。

nftechie

热度 98.63

最近更新 2026-05-11 15:57:18

分类：生活依赖：第三方 API / 代码执行应用场景：健康 / 推荐 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add apple-health-skill

Metadata

name: apple-health-skill
description: Talk to your Apple Health data — ask questions about your workouts, heart rate, activity rings, and fitness trends using AI.
homepage: https://www.transition.fun

Apple Health Skill

Chat with your Apple Health data using AI. Ask about your workouts, heart rate trends, activity rings, VO2 Max, and more. Powered by Transition, which syncs with Apple Health to give AI agents access to your fitness data.

Setup

Download Transition and grant Apple Health access
Go to Settings > API Keys and tap Generate New Key
Set the environment variable:

export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

No Auth Required

Workout of the Day

Generate a random structured workout — no account needed.

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

Parameters:

sport — run, bike, swim, or strength (default: run)
duration — minutes, 10-300 (default: 45)

Authenticated Endpoints

Base URL: https://api.transition.fun Auth: Pass X-API-Key header on every request.

AI Coach Chat

Ask questions about your Apple Health data. The AI coach has full context on your workouts and health metrics.

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "How has my resting heart rate changed over the last month?"}' \
  "https://api.transition.fun/api/v1/coach/chat"

Example questions:

"How many workouts did I do this week?"
"What's my VO2 Max trend?"
"How has my sleep been trending this week?"
"Compare my running pace this month vs last month"
"Should I take a rest day based on my recent training?"

Get Workouts

Retrieve scheduled workouts for a date range.

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

Parameters:

start — Start date (YYYY-MM-DD, required)
end — End date (YYYY-MM-DD, required)
Maximum range between start and end is 90 days.

Performance Management Chart (PMC)

Get CTL (fitness), ATL (fatigue), and TSB (form) calculated from your Apple Health workouts.

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/pmc"

Performance Stats

Get FTP, threshold paces, heart rate zones, and other metrics derived from your Apple Health data.

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/stats"

Athlete Profile

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/profile"

Chat History

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/coach/history"

Rate Limits

Tier	Read Endpoints	AI Endpoints
Free	100/day	3/day
Paid	10,000/day	100/day

Tips for Agents

Use coach chat as the primary interface. It has full context on the user's Apple Health workouts, heart rate, and performance — just ask natural questions.
Check fatigue before recommending hard workouts. Call GET /api/v1/performance/pmc and look at TSB. If TSB is below -20, the athlete is fatigued.
Use the free WOD endpoint for quick workouts. No auth needed — great for users who just want a workout suggestion.
Date format is always YYYY-MM-DD for all date parameters.