axiom-health

HealthKit 和 WorkoutKit

任何涉及 HealthKit 或 WorkoutKit 的开发都必须使用此技能，包括授权、数据查询、后台传递、锻炼会话、计划锻炼、健康 API（State of Mind）、药物和健康记录。

快速参考

症状 / 任务	参考
HealthKit 框架模型、HKHealthStore、数据类型、样本数据与特征数据	请参阅 skills/fundamentals.md
功能配置、requestAuthorization、用途说明字符串、读取不对称性、隐私	请参阅 skills/authorization-and-privacy.md
HKSampleQuery、Swift 并发查询 API、HKStatisticsCollectionQuery、样本写入	请参阅 skills/queries.md
锚定查询、观察者查询、HKDeletedObject、background-delivery 权限	请参阅 skills/sync-and-background.md
HKWorkoutSession、HKLiveWorkoutBuilder、恢复、多设备、iOS/iPadOS/watchOS 锻炼追踪	请参阅 skills/workouts.md
锻炼区间（心率 / 功率强度区间）、实时与回顾性 OS27	请参阅 skills/workouts.md
WorkoutKit 自定义 / 计划锻炼、排期、游泳锻炼、预览	请参阅 skills/workoutkit.md
State of Mind、Medications API、症状记录、更年期状态、健康 API OS27	请参阅 skills/wellbeing-and-medications.md
健康记录（FHIR）、Mobility Health App、基于运动的健康功能	请参阅 skills/clinical-and-mobility.md

跨套件路由

这些主题与 HealthKit / WorkoutKit 有交集，但属于独立套件：

watchOS 展示

• 针对 Watch 的锻炼展示（Always On、Smart Stack）、复杂功能界面 → 请参阅 axiom-watchos
• Apple Watch 上的锻炼应用结构 → 请参阅 axiom-watchos（skills/platform-basics.md）

并发

• Swift 6 并发、actor、Sendable → 请参阅 axiom-concurrency
• 将 HealthKit 查询桥接到 Swift 并发 → skills/queries.md 是标准示例

SwiftUI

• 健康数据图表渲染 → 请参阅 axiom-swiftui
• 健康数据的 @Observable 视图模型 → 请参阅 axiom-swiftui

数据与同步

• 通用跨平台同步模式（CloudKit、GRDB）→ 请参阅 axiom-data
• 将 HealthKit 锚定 / 观察者查询用作通用同步机制 → skills/sync-and-background.md

安全与隐私

• 钥匙串存储、加密、数据保护权限 → 请参阅 axiom-security

冲突解决

axiom-health 与 axiom-watchos：对于 Apple Watch 上的锻炼应用：

1. 使用 axiom-health 处理 HKWorkoutSession 生命周期、HKLiveWorkoutBuilder、恢复 API、多设备镜像——这些属于 HealthKit 概念，而非 Watch 概念
2. 使用 axiom-watchos 处理 Watch 专属展示：Always On 显示屏、Smart Stack 排列、watchOS 后台模式协调
3. 两者都适用 于原生 Watch 锻炼应用——先使用 axiom-health 处理会话生命周期，再使用 axiom-watchos 处理展示

axiom-health 与 axiom-concurrency：对于 HealthKit 查询模式：

1. 使用 axiom-health 确定应选择哪种查询类型，以及了解 HealthKit 特有的注意事项
2. 使用 axiom-concurrency 处理适用于查询回调的一般 Swift 6 actor 隔离规则

axiom-health 与 axiom-data：对于变更跟踪数据同步：

1. 使用 axiom-health 处理 HKAnchoredObjectQuery、HKObserverQuery、HKDeletedObject
2. 使用 axiom-data 处理跨设备的应用级数据同步（CloudKit、GRDB、SwiftData）

决策树

digraph health {
    start [label="HealthKit / workout task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/fundamentals.md" [label="framework basics, data types"];
    what -> "skills/authorization-and-privacy.md" [label="permissions, purpose strings, privacy"];
    what -> "skills/queries.md" [label="reading data, rollups, writes"];
    what -> "skills/sync-and-background.md" [label="change tracking, background delivery"];
    what -> "skills/workouts.md" [label="HKWorkoutSession, live workouts"];
    what -> "skills/workoutkit.md" [label="planned/custom workouts"];
    what -> "skills/wellbeing-and-medications.md" [label="State of Mind, Medications"];
    what -> "skills/clinical-and-mobility.md" [label="Health Records, Mobility"];
    what -> "axiom-watchos" [label="watch-specific presentation"];
    what -> "axiom-concurrency" [label="general actor isolation rules"];
    what -> "axiom-swiftui" [label="Charts, data visualization"];
}

资源

WWDC：2019-218、2020-10182、2020-10184、2020-10664、2021-10009、2021-10287、2022-10005、2023-10016、2023-10023、2024-10084、2024-10109、2025-321、2025-322

文档：/healthkit、/healthkit/about-the-healthkit-framework、/healthkit/authorizing-access-to-health-data、/healthkit/protecting-user-privacy、/healthkit/reading-data-from-healthkit、/healthkit/running-queries-with-swift-concurrency、/healthkit/executing-anchored-object-queries、/healthkit/executing-observer-queries、/healthkit/hkworkoutsession、/healthkit/hklivewobuilder、/workoutkit、/healthkit/accessing-health-records

技能：axiom-watchos、axiom-concurrency、axiom-swiftui、axiom-data、axiom-security