用途
axiom-watchos 是一个 watchOS 开发技能，声明必须用于任何 watchOS 专项开发工作，涵盖应用结构、独立应用、Watch Connectivity、复杂功能与 Smart Stack 小组件、控件、watch 上的实时活动、后台任务以及 ClockKit 迁移。
主要能力
该技能以“路由器”方式组织，按症状或任务指向具体参考文档：
- 应用结构、独立应用、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 缺失或不可用 → skills/watch-device-diag.md
- 后台任务、新鲜度调度、TN3135 网络限制 → skills/background-and-networking.md
- BGTaskScheduler 迁移、OS27 中已弃用的 WK 后台调度 → skills/background-and-networking.md
- watch OS27 上的 Foundation Models / Private Cloud Compute → skills/platform-basics.md
- WatchKit→SwiftUI 迁移、ClockKit→WidgetKit 迁移 → skills/modernization.md
使用方式
该技能以决策树形式引导：从“watchOS 开发任务”出发，按领域分流到上述参考文档，或转交其他技能套件。
跨套件路由：SwiftUI 通用模式（视图状态、数据流、@Observable、NavigationStack、布局、动画）转 axiom-swiftui；通用 HIG、Liquid Glass、SF Symbols、排版转 axiom-design；通用 VoiceOver、动态字体、WCAG 转 axiom-accessibility，watchOS 专项无障碍（Digital Crown 上的 VoiceOver 转子、AssistiveTouch、Double Tap）见 axiom-accessibility 的 skills/watchos-a11y.md；HealthKit、HKWorkoutSession、HKLiveWorkoutBuilder、WorkoutKit 转 axiom-health；iOS 侧小组件与 App Intents 转 axiom-integration；Swift 6 并发、actor、Sendable 转 axiom-concurrency；Foundation Models 深度内容转 axiom-ai；Vision 框架（watchOS 27 新增）转 axiom-vision；NowPlaying / MusicUnderstanding（watchOS 27 新增）转 axiom-media。
非 Claude Code 环境：当路由器提到“启动某 auditor agent”时，改为阅读该套件中对应 auditor 的文件并内联执行相同流程，仅需文件搜索与读取。需要 Bash 的 agent（构建、测试、模拟器、崩溃符号化）仅限 Claude Code，无内联等价方案。
冲突解决
- axiom-watchos 与 axiom-swiftui：watchOS SwiftUI 应用用 axiom-watchos 处理 watch 专项模式（可一瞥即读 UI、受限导航、Digital Crown 焦点、Smart Stack 放置），用 axiom-swiftui 处理跨平台 SwiftUI（状态管理、布局原语、动画）；两者可同时适用。
- axiom-watchos 与 axiom-integration：watch 复杂功能、Smart Stack 放置、watch 侧实时活动呈现、RelevanceKit 用 axiom-watchos；iOS/iPadOS 小组件、核心 ActivityKit API、App Intents 用 axiom-integration。
- watch-device-diag 与 watch-connectivity：Mac/Xcode→Watch 链路（CoreDevice）的安装、启动、LLDB 附加、Watch 缺失或不可用用 watch-device-diag；iPhone 应用↔watchOS 应用链路（WCSession）的传输 API 选择、投递语义、后台任务完成用 watch-connectivity。不确定时先查 watch-device-diag：不附加调试器运行应用，若行为正常则问题在隧道，改 WCSession 无济于事。isReachable == false 不是传输失败，而是普通生命周期转换中的预期值，应路由到 watch-connectivity。
- axiom-watchos 与 axiom-health：Apple Watch 上的体能训练，watch 专项呈现（常亮显示、Smart Stack 放置、后台模式协调）用 axiom-watchos；HKWorkoutSession 生命周期、HKLiveWorkoutBuilder、恢复、多设备镜像用 axiom-health。
适用场景
任何 watchOS 专项开发任务，包括应用结构、独立应用、Watch Connectivity、复杂功能与 Smart Stack 小组件、控件、watch 上的实时活动、后台任务、ClockKit 迁移、watch 设备诊断、watch 上的 Foundation Models / PCC，以及 WatchKit/ClockKit 现代化迁移。
限制
需要 Bash 的 agent（构建、测试、模拟器、崩溃符号化）仅限 Claude Code，无内联等价方案。其他套件主题（SwiftUI、设计、无障碍、健康、集成、并发、AI、视觉、媒体）需转交对应技能。
资源
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。