axiom-health について
axiom-healthは、AppleプラットフォームでHealthKitとWorkoutKitを扱う開発スキルです。権限、クエリ、同期、ワークアウト、ウェルビーイング、健康記録のガイダンスを整理し、関連トピックを連携するスキルへ案内します。
主な機能
- 01HealthKitの権限とプライバシーのガイダンス
- 02健康データのクエリと同期パターン
- 03ワークアウトセッションとWorkoutKitのガイド
- 04State of Mind、服薬、健康記録
- 05スキル間のタスク案内
活用シーン
- 01健康データの読み書きの実装
- 02バックグラウンドでの健康データ更新処理
- 03Apple Watchのワークアウト体験の開発
- 04健康記録や服薬機能の追加
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ charleswiltgen/ axiom --skill axiom-healthインストール後、Claude Code で/axiom-healthを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
skills/authorization-and-privacy.mdclinical-and-mobility.mdfundamentals.mdqueries.mdsync-and-background.mdwellbeing-and-medications.mdworkoutkit.mdworkouts.md詳細
HealthKit と WorkoutKit
認可、データクエリ、バックグラウンド配信、ワークアウトセッション、計画済みワークアウト、ウェルビーイング API(State of Mind)、Medications、Health Records を含む、HealthKit または WorkoutKit に関する開発では、必ずこのスキルを使用してください。
クイックリファレンス
| 症状/タスク | リファレンス |
|---|---|
HealthKit フレームワークのモデル、HKHealthStore、データ型、サンプルデータと特性データの違い | skills/fundamentals.md を参照 |
ケイパビリティの設定、requestAuthorization、使用目的の説明文、読み取りの非対称性、プライバシー | skills/authorization-and-privacy.md を参照 |
HKSampleQuery、Swift Concurrency のクエリ 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 を参照 |
| Health Records(FHIR)、Mobility Health App、モーションベースのヘルスケア | skills/clinical-and-mobility.md を参照 |
スイート間の参照先
以下のトピックは HealthKit/WorkoutKit と関連しますが、別のスイートに属します。
watchOS の表示
- Apple Watch 専用のワークアウト表示(Always On、Smart Stack)、コンプリケーションの表示領域 → axiom-watchos を参照
- Apple Watch 上のワークアウトアプリの構成 → axiom-watchos(
skills/platform-basics.md)を参照
並行処理
- Swift 6 の並行処理、アクター、Sendable → axiom-concurrency を参照
- Swift Concurrency と連携する HealthKit クエリ →
skills/queries.mdが標準的な例です
SwiftUI
- ヘルスケアデータのチャート描画 → axiom-swiftui を参照
- ヘルスケアデータ用の
@Observableビューモデル → axiom-swiftui を参照
データと同期
- クロスプラットフォームの一般的な同期パターン(CloudKit、GRDB) → axiom-data を参照
- 汎用的な同期手段としての HealthKit アンカークエリ/オブザーバークエリ →
skills/sync-and-background.md
セキュリティとプライバシー
- Keychain ストレージ、暗号化、データ保護エンタイトルメント → axiom-security を参照
競合の解決
axiom-health と axiom-watchos:Apple Watch 向けのワークアウトアプリの場合:
HKWorkoutSessionのライフサイクル、HKLiveWorkoutBuilder、リカバリー API、マルチデバイスのミラーリングには axiom-health を使用してください。これらは HealthKit の概念であり、watch の概念ではありません。- watch 固有の表示(Always On ディスプレイ、Smart Stack への配置、watchOS のバックグラウンドモードとの連携)には axiom-watchos を使用してください。
- watch ネイティブのワークアウトアプリでは 両方を使用してください。まず axiom-health でセッションのライフサイクルを扱い、その後 axiom-watchos で表示を扱います。
axiom-health と axiom-concurrency:HealthKit のクエリパターンの場合:
- 使用するクエリの種類と HealthKit 固有の注意点には axiom-health を使用してください。
- クエリのコールバックに適用される一般的な Swift 6 のアクター分離ルールには axiom-concurrency を使用してください。
axiom-health と axiom-data:変更を追跡するデータ同期の場合:
HKAnchoredObjectQuery、HKObserverQuery、HKDeletedObjectには axiom-health を使用してください。- デバイス間のアプリケーションレベルのデータ同期(CloudKit、GRDB、SwiftData)には axiom-data を使用してください。
判断ツリー
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