苹果工程师的超能力

最全面的 Apple 平台 AI 编码助手工程技能。 跨 Swift 6 并发、SwiftUI、Metal、RealityKit 和 VisionOS 的约 100KB 的生产测试模式 - 其他技能无法深入涵盖的领域。

为什么要使用这个技能

AI 助手现有的 Swift/iOS 技能往往提供表面级的最佳实践或狭隘地关注工具（模拟器自动化、构建脚本）。 没有深入探讨困难的部分：

• Swift 6 并发 — 参与者、Sendable、AsyncSequence、状态机、任务取消、反应模式。 不仅仅是“使用异步/等待”，而是完整的隔离模型。
• Metal GPU 编程 — 计算和渲染管道、缓冲区管理、环形缓冲区、线程组大小调整、着色器模式。 没有其他技能触及这一点。
• RealityKit 和 VisionOS — 实体组件系统架构、自定义系统、沉浸式空间、手部追踪、多窗口场景。 没有其他技能涵盖空间计算。
• 高级 Swift 模式 — 插值/动画基元、非空集合、枚举键控表、异步广播通道、组合桥接。 使生产代码变得健壮的模式。

这不是提示清单。 这是一份详细的参考资料，您的 AI 助手可以使用它来编写正确的、现代的 Swift，就像经验丰富的 Apple 工程师那样。

示例用例

“为我建立一个具有重试和取消功能的网络服务” 代理使用并发引用来生成 actor 隔离服务，其中包含 async throws、结构化 Task 取消和 AsyncThrowingStream 进度 — 而不是基于回调的包装器。

“创建处理视频帧的 Metal 计算着色器” 代理遵循 Metal 参考来设置 MTLComputePipelineState，使用环形缓冲区进行多帧流水线，正确调整线程组大小，并从 IOSurface 支持的纹理中读取。

“向我的 VisionOS 应用程序添加手势追踪交互” 代理参考 RealityKit/visionOS 指南，使用 HandTrackingProvider 设置 ARKitSession，从 HandSkeleton 读取关节位置，并将其连接到具有适当场景订阅的 RealityKit System。

“重构此 ViewModel 以使用 @Observable” 代理使用 SwiftUI 架构参考从 ObservableObject 和 @Published 迁移到 @Observable，更新视图绑定，并将 ViewModel 保留在 @MainActor 上。

“我需要一个像弹簧一样平滑的动画值跟踪器” 代理使用高级模式参考通过 Lerpable 协议实现 ExponentialDamper 协议，支持 Float、SIMD3 和四元数类型。

里面有什么

文件	封面
SKILL.md	核心原则、快速参考表、技能切入点
swift-concurrency.md	Swift 6 并发：参与者、Sendable、AsyncSequence、任务取消、同步、状态机、反应模式、泛型、持久性、网络、测试、诊断
swiftui-architecture.md	SwiftUI 应用程序架构：MVVM、ViewModel/View 指南、服务层模式、数据流、应用程序意图、文件组织
metal-graphics.md	Metal GPU 编程：管道、缓冲区、纹理、计算调度、环形缓冲区、着色器、帧节奏
realitykit-visionos.md	RealityKit ECS 和 VisionOS：实体、组件、系统、场景订阅、沉浸式空间、窗口、手部跟踪
advanced-swift-patterns.md	属性包装器、插值/动画、集合类型、组合桥接、高级异步抽象、@dynamicMemberLookup

安装

注意： 安装因平台而异。 选择与您的环境相匹配的一种。

克劳德代码（通过插件市场）

# Add the marketplace (one-time)
/plugin marketplace add piemonte/apple-engineer-superpowers

# Install the skill
/plugin install apple-engineer-superpowers@apple-engineer-superpowers

法典

# Clone the repository
git clone https://github.com/piemonte/apple-engineer-superpowers.git ~/.codex/apple-engineer-superpowers

# Create symlink
ln -s ~/.codex/apple-engineer-superpowers ~/.agents/skills/apple-engineer-superpowers

有关 Windows 说明和更多详细信息，请参阅 .codex/INSTALL.md。

光标（通过插件市场）

/plugin install piemonte/apple-engineer-superpowers

验证安装

询问你的人工智能助手：

“我应该为 Swift 中的共享有状态组件使用什么并发原语？”

它应该建议使用 actor — 参考技能的并发指南。

更新中

克劳德代码/光标：

/plugin update apple-engineer-superpowers

法典：

cd ~/.codex/apple-engineer-superpowers && git pull

核心原则

1. 无强制展开 (!) — 使用 guard let、if let、零合并 (??) 或可选链接
2. Actor优先并发 — 使用Actor作为有状态组件的默认值
3. 始终异步/等待 — 切勿在新代码中使用完成处理程序
4. 可发送的一切 — 所有共享类型必须符合 Sendable
5. Swift 6 严格并发 — 从一开始就启用 StrictConcurrency
6. 面向协议的设计——通过协议定义合约
7. LocalizedError for Errors — 符合 LocalizedError, Sendable 的特定于域的错误枚举

资源

• Superpowers — 该插件专为完整的开发工作流程技能系统而构建。 为您的 AI 编码代理添加头脑风暴、TDD、调试、代码审查和并行子代理编排。
• Swift Evolution — 此技能教授的并发模型背后的建议（SE-0306 参与者、SE-0302 可发送、SE-0414 基于区域的隔离等）。
• swift-async-algorithms — Apple 的开源 AsyncSequence 实用程序，可补充此处的并发模式。
• Metal Best Practices Guide — Apple 的 Metal 性能官方指南，与 Metal 参考完美搭配。
• Apple Sample Code — 官方示例项目，对于 RealityKit 和visionOS 特别有用。
• WWDC Sessions — 此技能提取的 Metal、RealityKit 和 VisionOS 内容的主要来源。

贡献

1. 分叉这个存储库 2.添加或完善相关.md文件中的参考内容
2. 确保引用的所有 API 均来自公共 Apple SDK 或开源 Swift
3. 打开一个拉取请求，并清楚地描述更改的内容

许可证

MIT 许可证 — 请参阅 LICENSE 文件了解详细信息。