适用于 Claude Code、Codex 等的 Swift 代理技能

这是一套为 Swift 和 Apple 平台开发精心整理的开源 AI 代理技能合集。您可以将这些技能与 Claude Code、Codex、Cursor、Windsurf 等 AI 编码工具结合使用，以编写更优秀的 SwiftUI、Swift 并发、SwiftData 等代码。

本仓库包含了由社区维护的各类主题代理技能链接，并按框架和领域进行了分类。

了解如何在 Xcode、Claude Code、Codex 等工具中安装和使用代理技能。

⚠️ 重要安全提示 ⚠️

在安装第三方代理技能之前，请务必仔细阅读其内容，并确认您信任该作者。 此处列出并不意味着我们对其背书；您需要自行判断。

此处列出的技能均为开源，因此请花时间仔细阅读并确认它们对您有益后再使用。您也可以基于这些技能创建自己的技能，但请确保遵守相应的许可证协议。

目录

代理技能

• SwiftUI 技能
• SwiftData 技能
• Swift 并发技能
• Swift 测试技能
• Swift 语言技能
• 无障碍技能
• App Store 技能
• 架构技能
• Core Data 技能
• 性能技能
• 安全技能
• 工具技能
• 用户界面技能

其他有用资料

• AGENTS.md 文件
• 更多阅读链接
• 贡献指南

代理技能

SwiftUI 技能

• SwiftUI 专业版 由 Paul Hudson 提供
• SwiftUI UI 模式 由 Thomas Ricouard 提供
• SwiftUI 设计原则 由 Arjit Jaiswal 提供
• SwiftUI 视图重构 由 Thomas Ricouard 提供

SwiftData 技能

• SwiftData 专业版 由 Paul Hudson 提供
• SwiftData 专家版 由 Kudrin Dmitry 提供

Swift 并发技能

• Swift 并发专业版 由 Paul Hudson 提供
• Swift 并发专家版 由 Thomas Ricouard 提供
• Swift 并发专家版 由 Antoine van der Lee 提供

Swift 测试技能

• Swift 测试专业版 由 Paul Hudson 提供
• Swift 测试代理技能 由 Eduardo Bocato 提供
• Swift 测试专家版 由 Antoine van der Lee 提供

Swift 语言技能

• Swift API 设计指南代理技能 由 Erik Sebastián de Erice 提供

无障碍技能

• iOS 无障碍代理技能 由 Daniel Devesa 提供
• Swift 无障碍技能 由 Pasquale Vittoriosi 提供
• Apple 无障碍技能 由 Roberto Gómez Muñoz 提供

App Store 技能

• App Store Connect CLI 由 Rudrank Riyam 提供
• App Store 更改日志 由 Thomas Ricouard 提供
• App Store ASO 优化 由 Tim Broddin 提供

架构技能

• Swift 架构技能 由 Lasha Efremidze 提供

Core Data 技能

• Core Data 专家版 由 Antoine van der Lee 提供

性能技能

• SwiftUI 性能审计 由 Thomas Ricouard 提供

安全技能

• Swift 安全专家版 由 Ivan Magda 提供

工具技能

• iOS 模拟器技能 由 Conor Luddy 提供
• Figma 转 SwiftUI 技能 由 Ermolaev Maxim 提供

用户界面技能

• 界面文案写作技能 由 Andrew Gleave 提供

AGENTS.md 文件

如果您更倾向于使用 AGENTS.md / CLAUDE.md 文件而非代理技能，那么以下内容适合您：

• SwiftAgents 由 Paul Hudson 提供

更多阅读链接

• Artem Novichkov 维护了一个包含 Xcode 26 系统提示 的仓库，或许对您有所帮助。
• 还有 这份 iOS AI 技能的替代列表，也值得您参考评估。
• 学习如何 构建您自己的技能

贡献

这是一个面向 iOS 开发者的技能资源库，但这并不意味着它可以成为存放半成品、未经验证内容的垃圾场。

如果您想在此处贡献链接，请确保：

• 该内容由人类编写，而非 AI。技能的核心价值在于为开发者提供他们尚未掌握的知识；如果使用 AI 生成内容，则完全违背了这一初衷。
• 该资源库未抄袭其他作者的作品。虽然本不该多说这一点，但请尊重他人及其劳动成果——请创作属于自己的内容，而不是简单复制他人的作品。
• 该资源库采用与 App Store 开发兼容的许可证，例如 MIT 许可证、Apache 2.0 许可证、BSD（2 条款和 3 条款）、ISC 许可证以及 Unlicense。GPLv2、GPLv3 和 LGPL 则不兼容。
• 您添加到此 README 文件中的文字长度应与其他条目大致相当，以避免占据过多篇幅。
• 请在您的名字旁边附上指向您 GitHub 个人主页的链接，以便他人核实并确认对您的信任。

此外，您同意遵守行为准则。

注意： 如果您拥有大量技能，请仅选择其中最核心的几项进行添加，以免给人留下刷屏的印象。

许可证

本仓库由 Paul Hudson 创建，他在 Hacking with Swift 上免费分享 Swift 教程。该仓库本身采用 MIT 许可证 开放，允许商业使用、修改、分发及私人使用；然而，其中的链接和摘要内容归属于各自的原作者。

我并不拥有大多数被链接资源库中的内容，这些资源库各自拥有独立的许可证，您应根据需要自行阅读。在此列出并不意味着我对其表示认可。

 

Hacking with Swift 项目

Swift-Agent-Skills 快速上手指南

Swift-Agent-Skills 是一个专为 Swift 和 Apple 平台开发打造的开源 AI 智能体技能集合。它旨在帮助开发者在使用 Claude Code、Codex、Cursor、Windsurf 等 AI 编程工具时，生成更高质量的 SwiftUI、Swift 并发、SwiftData 等代码。

环境准备

在开始之前，请确保满足以下条件：

• 操作系统：macOS（推荐用于 iOS/macOS 开发）。
• AI 编程工具：已安装并配置好以下任一支持自定义技能（Skills）或系统提示词的工具：
  • Claude Code
  • Cursor
  • Windsurf
  • GitHub Copilot (需支持自定义指令)
  • Xcode (配合相关插件或外部 AI 助手)
• 网络环境：由于技能库托管在 GitHub 上，建议确保网络畅通，或使用国内加速方案访问 github.com。
• 基础知识：熟悉 Swift 语言及基本的 iOS/macOS 开发流程。

⚠️ 安全提示：本仓库仅收录社区维护的技能链接，不代表官方背书。在安装或使用任何第三方技能前，请务必仔细阅读其源代码，确认作者可信且无恶意逻辑。

安装步骤

Swift-Agent-Skills 本身不是一个需要通过包管理器安装的库，而是一个技能链接索引。安装过程实际上是将其中的特定技能配置到你的 AI 工具中。

方法一：直接引用远程仓库（推荐用于支持 URL 导入的工具）

部分工具（如新版 Claude Code 或 Cursor 配置）允许直接指向远程仓库作为上下文来源。

1. 打开你的 AI 编程工具配置文件（例如 .cursorrules, CLAUDE.md, 或工具内的 "Custom Instructions" 设置）。
2. 添加以下仓库地址作为参考源，或直接克隆整个仓库到本地以便查阅：

git clone https://github.com/twostraws/Swift-Agent-Skills.git

3. 进入你感兴趣的具体技能子目录（例如 SwiftUI-Pro），按照该子目录 README 中的指示进行配置。通常是将特定的 Prompt 内容复制到你的 AI 工具的系统提示词区域。

方法二：手动复制技能内容（通用方法）

这是最灵活的方式，适用于所有 AI 工具：

1. 浏览本项目的 Table of Contents，找到你需要的技能类别（如 SwiftUI Skills 或 Swift Concurrency Skills）。
2. 点击对应的 GitHub 链接（例如 SwiftUI Pro by Paul Hudson）。
3. 在该技能的仓库中，找到核心指令文件（通常是 skill.md, prompt.txt 或直接写在 README 中的指令块）。
4. 复制全部内容。
5. 粘贴到你使用的 AI 工具的“系统提示词 (System Prompt)"、“自定义规则 (Custom Rules)"或“代理技能 (Agent Skills)"配置框中。

示例：为 Cursor 添加 SwiftUI Pro 技能

1. 访问 SwiftUI-Agent-Skill。
2. 复制其提供的 Prompt 内容。
3. 在 Cursor 中打开 Settings -> AI -> Rules for AI。
4. 将内容粘贴进去并保存。

基本使用

配置完成后，无需输入特殊命令即可生效。AI 工具会在生成代码时自动应用这些最佳实践。

使用示例

假设你已安装了 SwiftUI Pro 技能，现在需要创建一个列表视图。

用户输入：

创建一个显示用户列表的 SwiftUI 视图，包含头像、姓名和最后登录时间，数据源使用 SwiftData。

AI 输出（预期效果）： AI 将不再生成基础的 List 代码，而是会依据技能库中的规范：

• 自动使用 @Query 宏从 SwiftData 获取数据。
• 采用现代化的 SwiftUI 布局（如 VStack, HStack 的最佳实践）。
• 正确处理异步图像加载和空状态界面。
• 遵循 Swift API 设计指南命名变量和函数。

生成的代码片段示例（示意）：

import SwiftUI
import SwiftData

struct UserListView: View {
    @Query(sort: \User.lastName) private var users: [User]

    var body: some View {
        List(users) { user in
            HStack {
                AsyncImage(url: user.avatarURL) { image in
                    image.resizable().aspectRatio(contentMode: .fill)
                } placeholder: {
                    ProgressView()
                }
                .frame(width: 40, height: 40)
                .clipShape(Circle())

                VStack(alignment: .leading) {
                    Text(user.fullName)
                        .font(.headline)
                    Text(user.lastLogin, style: .relative)
                        .font(.caption)
                        .foregroundStyle(.secondary)
                }
            }
        }
        .navigationTitle("Users")
    }
}

验证技能是否生效

你可以尝试询问 AI 关于特定领域的问题来测试技能是否加载成功：

• "如何使用最新的 Swift Testing 框架编写一个异步测试用例？"（测试 Swift Testing Skills）
• "如何优化这个 SwiftUI 视图的性能以避免掉帧？"（测试 Performance Skills）

如果 AI 的回答引用了具体的最佳实践、最新的 API 用法或提供了结构化的重构建议，说明技能已成功生效。