axiom-watchos

watchOS 開発

アプリ構成、独立したアプリ、Watch Connectivity、コンプリケーションとSmart Stackウィジェット、コントロール、watch上のライブアクティビティ、バックグラウンドタスク、ClockKitからの移行など、watchOSに固有の開発には必ずこのスキルを使用してください。

Axiomエージェントを起動できませんか？ このルーターからエージェントに案内された場合は、その手順をその場で実行してください。MCP経由では、axiom_get_agentからエージェントを取得できます。それ以外の場合は、以下のファイルを読み取ってください。必要なのはファイルの検索と読み取りだけです。

別のスイートにあります：axiom-build/skills/modernization-helper.md。

その他のエージェントも、MCP経由ではaxiom_get_agentから取得できます。axiom_xclog_*、axiom_xcsym_*、axiom_xcprof_*ツールを使って、そのエージェントのxclog、xcsym、xcprofの手順を実行してください。それ以外の場合は、Axiomのスキルからskills/<agent>.mdを検索してください。見つからない場合は、このスイートのスキルを使い、PATH上にあるAxiomツールを使って自分で作業してください。

クイックリファレンス

症状／タスク	参照先
アプリ構成、独立したアプリ、watchOS 26の提出要件	skills/platform-basics.mdを参照してください
watchOSのHIG、一目で把握できるUX、ナビゲーションモデル	skills/design-for-watchos.mdを参照してください
Smart Stackウィジェット、コンプリケーション、ClockKitからWidgetKitへの移行、RelevanceKit	skills/smart-stack-and-complications.mdを参照してください
watchの各画面のコントロール、watch上のライブアクティビティ	skills/controls-and-live-activities.mdを参照してください
Watch Connectivity（WCSession）、ペアリング済みデバイス間のデータ転送、ファミリー共有設定	skills/watch-connectivity.mdを参照してください
XcodeでWatchにインストール、起動、アタッチできない場合、またはDevice Hub／devicectlでWatchが見つからない、もしくはunavailableと表示される場合	skills/watch-device-diag.mdを参照してください
バックグラウンドタスク、最新状態のスケジューリング、TN3135のネットワーク制限	skills/background-and-networking.mdを参照してください
BGTaskSchedulerへの移行、非推奨となったWKのバックグラウンドスケジューリングOS27	skills/background-and-networking.mdを参照してください
watch上のFoundation Models／Private Cloud Compute OS27	skills/platform-basics.mdを参照してください
WatchKitからSwiftUIへの移行、ClockKitからWidgetKitへの移行	skills/modernization.mdを参照してください

スイート間の案内

これらのトピックはwatchOS開発に関係しますが、別のスイートにあります。

SwiftUI（iOS／watchOS／macOS共通）

• ビューの状態、データフロー、@Observable → axiom-swiftuiを参照してください
• ナビゲーションの基本（NavigationStack） → axiom-swiftuiを参照してください
• レイアウト、アニメーション → axiom-swiftuiを参照してください

デザイン

• 一般的なHIG、Liquid Glass、SF Symbols、タイポグラフィ → axiom-designを参照してください

アクセシビリティ

• VoiceOver、Dynamic Type、WCAGの一般事項 → axiom-accessibilityを参照してください
• watchOS固有（Digital CrownのVoiceOverローター、AssistiveTouch、ダブルタップ） → axiom-accessibility（skills/watchos-a11y.md）を参照してください

ヘルスケアとワークアウト

• HealthKit、HKWorkoutSession、HKLiveWorkoutBuilder、WorkoutKit → axiom-healthを参照してください
• ワークアウトの復旧、複数デバイスの連携 → axiom-health（skills/workouts.md）を参照してください

iOS側のウィジェットとApp Intents

• iOS／iPadOSのウィジェット、構成インテント、App Intents → axiom-integrationを参照してください
• iPhone上のライブアクティビティ（開始処理とActivityKit） → axiom-integrationを参照してください

並行処理

• Swift 6の並行処理、アクター、Sendable → axiom-concurrencyを参照してください

watchに新しく追加されたフレームワーク（27リリース）

• Foundation Modelsの詳細（セッション、@Generable、ツール、PCC） → axiom-aiを参照してください。watch固有の範囲はskills/platform-basics.mdを参照してください
• Visionフレームワーク（watchOS 27で新登場） → axiom-visionを参照してください
• NowPlaying／MusicUnderstanding（watchOS 27で新登場） → axiom-mediaを参照してください

競合の解決

axiom-watchos と axiom-swiftui：watchOS の SwiftUI アプリを構築する場合：

1. watch 固有のパターンには axiom-watchos を使用します：ひと目で把握できる UI、制約のあるナビゲーション、Digital Crown のフォーカス、Smart Stack への配置
2. クロスプラットフォームの SwiftUI には axiom-swiftui を使用します：状態管理、レイアウトのプリミティブ、アニメーション
3. 両方が該当する場合があります：コンプリケーションを備えた watchOS の NavigationStack では、コンプリケーションの表示領域に axiom-watchos を、NavigationStack の基本には axiom-swiftui を使用します

axiom-watchos と axiom-integration：ウィジェットと Live Activities の場合：

1. watch のコンプリケーション、Smart Stack への配置、watch 側での Live Activity の表示、RelevanceKit には axiom-watchos を使用します
2. iOS／iPadOS のウィジェット、ActivityKit のコア API、App Intents には axiom-integration を使用します

watch-device-diag と watch-connectivity：独立した 2 つの接続は、同じように見える障害を起こします。コードを書く前に、どちらかを判断してください：

1. Mac／Xcode → Watch のリンク（CoreDevice）には watch-device-diag を使用します：インストール、起動、LLDB のアタッチ、Watch が見つからない、または unavailable の場合
2. iPhone アプリ ↔ watchOS アプリのリンク（WCSession）には watch-connectivity を使用します：転送 API の選択、配信セマンティクス、バックグラウンドタスクの完了
3. 判断に迷ったら、watch-device-diag から始めてください。 デバッガーをアタッチせずにアプリを実行し、正しく動作するなら、問題はトンネルにあり、WCSession を変更しても解決しません。壊れたデバッガートンネルを補うために WCSession を再設計することは、watchOS 開発で最もコストのかかる失敗です
4. isReachable == false はトランスポート障害ではありません — 通常のライフサイクル遷移では想定される値であり、ここではなく watch-connectivity の対象です

axiom-watchos と axiom-health：Apple Watch でワークアウトを行う場合：

1. watch 固有の表示には axiom-watchos を使用します：常時表示ディスプレイ、Smart Stack への配置、バックグラウンドモードの調整
2. HKWorkoutSession のライフサイクル、HKLiveWorkoutBuilder、リカバリー、複数デバイス間のミラーリングには axiom-health を使用します

判断ツリー

digraph watchos {
    start [label="watchOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/platform-basics.md" [label="app structure, independent apps, submission"];
    what -> "skills/design-for-watchos.md" [label="watch HIG, glanceable UX"];
    what -> "skills/smart-stack-and-complications.md" [label="complications, Smart Stack, RelevanceKit"];
    what -> "skills/controls-and-live-activities.md" [label="controls, watch Live Activities"];
    what -> "skills/watch-connectivity.md" [label="WCSession, paired-device transfer"];
    what -> "skills/watch-device-diag.md" [label="Xcode can't reach the Watch"];
    what -> "skills/background-and-networking.md" [label="background tasks, BGTaskScheduler, networking limits"];
    what -> "skills/platform-basics.md" [label="Foundation Models / PCC on watch"];
    what -> "skills/modernization.md" [label="WatchKit/ClockKit migration"];
    what -> "axiom-health" [label="workouts, HealthKit, WorkoutKit"];
    what -> "axiom-swiftui" [label="general SwiftUI patterns"];
    what -> "axiom-accessibility" [label="VoiceOver rotor, AssistiveTouch"];
    what -> "axiom-integration" [label="iOS-side widgets, App Intents"];
}

リソース

WWDC：2021-10003、2022-10133、2023-10138、2023-10029、2023-10309、2024-10098、2024-10157、2024-10205、2025-334

ドキュメント：/watchos-apps/building_a_watchos_app、/watchos-apps/creating-independent-watchos-apps、/watchconnectivity、/widgetkit/creating-accessory-widgets-and-watch-complications、/widgetkit/converting-a-clockkit-app、/relevancekit、/technotes/tn3135-low-level-networking-on-watchos、/technotes/tn3157-updating-your-watchos-project-for-swiftui-and-widgetkit

スキル：axiom-swiftui、axiom-design、axiom-accessibility、axiom-health、axiom-integration、axiom-concurrency、axiom-ai、axiom-vision、axiom-media