Swift Apple 开发

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install swift-dev
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 swift-dev。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Swift Apple Development 是一项技术参考技能，供开发原生 iOS 和 macOS 应用的 AI 编码代理使用。它涵盖 Swift 6 并发、SwiftUI、SwiftData、Swift Testing、项目生成、设备部署和分发，并针对常见的编译器、运行时和工具链问题提供重点指导。
该技能不会一次性加载所有参考资料，而是在需要时将任务引导至特定平台的指南。Openclaw Skills 用户可以将其中的工作流程用于应用架构、CallKit 和 App Intents 等系统集成，以及 TestFlight、App Store 和 macOS 公证等发布流程。

应用场景

使用 XcodeGen 项目和用于复用逻辑的本地 Swift Package 开始开发 iOS 应用。
使用 Swift 创建原生 macOS 应用、命令行工具或小型代理。
诊断 Swift 6 actor 隔离、Sendable、代理桥接或并发构建错误。
添加 SwiftUI 状态管理、SwiftData 持久化、Keychain 存储或 Foundation Models 功能。
使用 Swift Testing 编写单元测试和应用测试，然后在本地或 iOS 模拟器中运行。
在实体 iPhone 上安装应用、配置签名，或准备 TestFlight 或 App Store 发布。
通过 Mac App Store 发布 Mac 应用，或使用 Developer ID 签名和公证发布。

工作原理

确定目标平台和任务，然后使用 Platform 表格选择相关参考指南。
选择合适的项目基础：应用目标使用 XcodeGen，便携逻辑和测试使用本地 Swift Package。
根据该技能针对 SwiftUI、SwiftData、并发、系统 API 和应用架构的平台指南实现功能。
使用 swift test 快速验证逻辑；必要时重新生成 XcodeGen 项目，然后使用 xcodebuild 构建。
如果功能需要 iOS 运行时、签名或特定硬件行为，则运行模拟器或设备工作流程。
按照相关分发指南配置签名，并通过 TestFlight、应用商店或 macOS 公证发布。

配置指南

这项技能由说明和参考文档组成；所提供的 SKILL.md 未定义单独的安装命令。在 Openclaw Skills 环境中添加或加载该技能，然后查阅相关任务指南。开发需要 Mac。文档所述工具链以 Swift 6.4 和 Xcode 27.0 为目标；Xcode 27 要求使用 Apple silicon，并运行 macOS 26.6 或更高版本。模拟器测试还需要安装 iOS 模拟器运行时。
开发新的 iOS 应用时，使用 XcodeGen 生成 Xcode 项目，并将应用逻辑保存在本地 Swift Package 中。仅处理逻辑时，可直接运行软件包测试：
swift test --package-path Core
生成项目并执行不签名的编译检查：
xcodegen generate
xcodebuild -project App.xcodeproj -scheme App
-destination 'generic/platform=iOS' CODE_SIGNING_ALLOWED=NO build 运行模拟器测试时，如有需要请安装运行时，并选择可用的模拟器：
xcodebuild -downloadPlatform iOS
xcrun simctl list runtimes
xcodebuild -project App.xcodeproj -scheme App
-destination 'platform=iOS Simulator,name=iPhone 17' test 进行实体设备部署和签名时，请参阅 ios-devices-and-signing.md；发布时，请使用 ios-distribution.md 或 macos-distribution.md。如果忽略生成的 Xcode 项目文件，请将 Package.resolved 保留在版本控制中；添加文件后请重新生成项目，除非使用 XcodeGen 的 syncedFolder 源类型。

数据架构

该技能由平台无关的核心部分和一个面向任务、用于引导至特定 Markdown 参考文档的路由器组成。它不规定应用数据格式；数据结构取决于所构建的应用。
Area Guidance and artifacts
Project setup project.yml 可生成 .xcodeproj；本地 Package.swift 可存放可复用逻辑和测试。
Dependencies 在版本控制中保留 Package.resolved，以便干净检出时使用固定的依赖版本。
App state SwiftUI 示例使用 @Observable 控制器、环境注入，以及用于非 UI 字段的 @ObservationIgnored。
Persistence SwiftData 示例定义 @Model 类型、关系、谓词、查询和模型容器；迁移和 CloudKit 详情见 swiftdata-store.md。
Tests Swift Testing 示例位于软件包测试目标或应用测试目标中；iOS 应用测试需要模拟器运行时。
Platform references iOS、macOS 和共享指南涵盖 UI、签名、分发、并发、Keychain、音频和系统集成。
元数据将该技能标识为 swift-dev，版本为 0.1.0，支持的操作系统为 macOS，主题包括 Swift、SwiftUI、iOS、macOS 和 Xcode。

高级特性

Swift 6 语言模式指南，涵盖 actor 隔离、
Sendable
、
@concurrent
、类型化 throws，以及代理回调的安全桥接。
涵盖 CallKit、AVFoundation 音频会话、LiveKit 代理行为，以及锁定设备时的音频注意事项。
App Intents、App Shortcuts、Siri、控制中心控制项和操作按钮集成。
Foundation Models 指南，涵盖设备端生成和 Private Cloud Compute，包括可用性和部署目标注意事项。
SwiftData 内容涵盖关系、谓词、迁移、后台上下文和 CloudKit 配置。
针对 XcodeGen、SwiftPM、模拟器运行时、设备签名、TestFlight、App Store 分发和公证的构建与发布问题排查。
Xcode 27 和 iOS 27/macOS 27 兼容性说明，涵盖构建系统变更、Liquid Glass、导出方式和较新的平台 API。

name: swift-dev description: Native iOS and macOS apps in Swift 6 - SwiftUI, SwiftData, concurrency, Swift Testing, XcodeGen projects, CallKit and audio sessions, App Intents and the Action Button, devices, TestFlight, notarization. Use for any iPhone or Mac app work.