关于 swiftui-core
swiftui-core 是用于构建 Apple 各平台 SwiftUI 界面的编码技能，涵盖视图组合、导航、SwiftData 和状态管理，也提供无障碍与平台适配指引及实现审查流程。
主要功能
- 01组合式视图与修饰器
- 02NavigationStack 和 NavigationSplitView 模式
- 03SwiftData 持久化
- 04使用 @State、@Observable 和 @Environment 管理状态
- 05无障碍与平台适配指引
- 06预览与设计参考资料
适用场景
- 01构建 SwiftUI 视图和组件
- 02添加导航与持久化
- 03管理视图的本地及共享状态
- 04检查无障碍支持和自适应布局
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/swiftui-core确认已加载。
详细介绍
参考资料深入介绍视图和修饰符、导航、SwiftData、状态管理、跨平台 Liquid Glass 和 App Intents，还包含 Apple Human Interface Guidelines（HIG）规则及其来源 URL：辅助功能（Dynamic Type 至 AX5、VoiceOver、对比度、触控目标、减少动态效果/透明度）、从右到左布局、模态界面/工作表/警告/引导流程、系统界面（小组件、实时活动、通知、App 快捷指令/Siri/片段），以及 iPhone Duo。
如果存在 design-ios 交接文档，视觉规范以该文档为准；此技能负责实现并验证这些规范。最佳实践：当视图主体包含多种职责或无法一眼读懂时，提取子视图；使用 ViewBuilder 和修饰符进行组合；始终包含 #Preview；使用系统颜色（自定义颜色需要提供浅色、深色和增强对比度变体）；为每个仅包含图标的控件添加标签；根据尺寸类别调整布局。
SwiftUI Core
所有 Apple 平台通用的 SwiftUI 基础知识。
Agent 工作流（强制）
任何实现开始前，必须并行启动 3 个 Agent，每个 Agent 调用一次，并指定 name：
- fuse-ai-pilot:explore-codebase - 分析现有 SwiftUI 模式
- fuse-ai-pilot:research-expert - 通过 Context7/Exa 核实最新 SwiftUI 文档
- mcp__apple-docs__search_apple_docs - 检查 SwiftUI 视图模式
实现完成后，运行 fuse-ai-pilot:sniper 进行验证。
概览
适用场景
- 构建 SwiftUI 视图和组件
- 实现导航（NavigationStack、SplitView）
- 使用 SwiftData 持久化数据
- 管理状态（@State、@Observable）
- 创建自定义视图修饰符和布局
SwiftUI Core 的优势
| 功能 | 优势 |
|---|---|
| 声明式 UI | 代码更少，自动更新 |
| 跨平台 | iOS/macOS/watchOS/visionOS 共用同一份代码 |
| @Observable | 简单的响应式状态 |
| SwiftData | 以最少的代码实现现代化持久化 |
核心概念
视图和修饰符
可组合的 UI 构建模块。达到 30 行以上时提取子视图。
导航
基于堆栈的导航使用 NavigationStack，多列布局使用 NavigationSplitView。
SwiftData
使用 @Model 实现现代化持久化。可在大多数使用场景中取代 Core Data。
状态管理
本地状态使用 @State，共享状态使用 @Observable，注入依赖使用 @Environment。
参考指南
| 需求 | 参考资料 |
|---|---|
| 视图、修饰符、布局 | views-modifiers.md |
| NavigationStack、深度链接 | navigation.md |
| SwiftData、@Query、CloudKit | data-swiftdata.md |
| @State、@Observable、Environment | state-management.md |
| 所有平台上的 Liquid Glass | liquid-glass.md |
| Siri、Shortcuts、App Intents | app-intents.md |
HIG 规则（任何 UI 任务都需加载）
| 需求 | 参考资料 |
|---|---|
| Dynamic Type AX5、VoiceOver、对比度、触控目标、减少动态效果 | hig-accessibility.md |
| 阿拉伯语/希伯来语镜像布局、数字格式 | hig-rtl.md |
| 工作表、警告、模态界面、引导流程、启动、权限 | hig-modality.md |
| 小组件、实时活动、通知、App 快捷指令、Siri、片段 | hig-system-surfaces.md |
| iPhone Duo（可折叠设备）、保留区域、垂直工具栏 | hig-iphone-duo.md |
最佳实践
- 小型视图 - 达到 30 行以上时提取为独立视图
- 组合 - 使用 ViewBuilder 和修饰符
- 预览驱动 - 始终包含 #Preview
- 系统颜色 - 自定义颜色需提供浅色、深色和增强对比度变体（HIG 颜色指南）
- 无障碍功能 - 为仅图标控件添加标签，确保布局在 AX5 下正常显示，在 iOS 上将触控目标设为 >= 44 pt（hig-accessibility.md）
- 平台适配 - 使用尺寸类别，不要固定宽度或检查设备类型（HIG 布局指南）