Swift Concurrency Agent Skill

为任何支持 Agent Skills 开放格式 的 AI 编程工具提供专家级指导，涵盖安全并发、性能优化以及 Swift 6+ 迁移等内容。

本技能基于全面的 Swift Concurrency 课程 提炼而成，为 AI Agent 提供了简洁且可执行的参考指南。

适用人群

• 正在迁移至 Swift 6 / 严格并发模式，需要安全默认值和快速分类诊断的团队。
• 正在调试数据竞争（Data Races）、隔离错误或不稳定的异步测试的开发者。
• 任何希望应用高性能并发模式（Actors, Tasks, Sendable, Async Streams）的开发者。

另请参阅我的其他技能：

• SwiftUI Expert
• Core Data Expert
• Swift Testing Expert

如何使用此技能

选项 A：使用 skills.sh（推荐）

通过单条命令安装此技能：

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

更多信息，请访问 skills.sh 平台页面。

安装后，即可在 AI Agent 中使用，例如：

Use the swift concurrency skill and analyze the current project for Swift Concurrency improvements

选项 B：Claude Code 插件

个人使用

若要在 Claude Code 中个人使用此技能：

1. 添加市场：

   /plugin marketplace add AvdLee/Swift-Concurrency-Agent-Skill
   

2. 安装技能：

   /plugin install swift-concurrency@swift-concurrency-agent-skill
   

项目配置

若要自动为仓库中的所有贡献者提供此技能，请配置项目的 .claude/settings.json：

{
  "enabledPlugins": {
    "swift-concurrency@swift-concurrency-agent-skill": true
  },
  "extraKnownMarketplaces": {
    "swift-concurrency-agent-skill": {
      "source": {
        "source": "github",
        "repo": "AvdLee/Swift-Concurrency-Agent-Skill"
      }
    }
  }
}

当团队成员打开该项目时，Claude Code 将提示他们安装此技能。

选项 C：使用 pi 包管理器

通过 pi 安装：

pi install https://github.com/AvdLee/Swift-Concurrency-Agent-Skill

该技能将自动在 pi 会话中可用。

选项 D：手动安装

1. Clone 此仓库。
2. 按照工具的官方技能安装文档（见下文链接），安装或符号链接 (symlink) swift-concurrency/ 文件夹。
3. 使用你的 AI 工具，并要求其针对 Swift Concurrency 任务使用 “swift-concurrency” 技能。

技能保存位置

请遵循你的工具官方文档，以下是一些常用工具的链接：

• Codex: Where to save skills
• Claude: Using Skills
• Cursor: Enabling Skills

验证方法：

你的 Agent 应当能够参考 swift-concurrency/SKILL.md 中的分类指南/手册，并跳转到针对你当前错误或任务的参考文件。

此技能提供的功能

此技能为你的 AI 编程工具提供了全面的 Swift Concurrency 指导，功能包括：

指导并发决策

• 为任务选择正确的工具（async/await, actors, tasks, task groups）
• 理解何时使用 @MainActor、自定义 actors 或 nonisolated
• 驾驭隔离域并在编译时防止数据竞争
• 正确地为值类型和引用类型应用 Sendable 遵循

编写安全的并发代码

• 避免常见陷阱，如 actor 重入（reentrancy）和循环引用
• 通过适当的隔离防止数据竞争
• 正确处理任务取消和错误传播
• 在并发上下文中安全地管理内存

优化性能

• 在序列化、异步和并行执行之间做出选择
• 减少 actor 争用和不必要的挂起（suspension）点
• 理解并行性能的权衡

迁移至 Swift 6

• 针对现有代码库的分步迁移策略
• 逐步启用严格并发检查
• 将基于闭包的代码重写为 async/await
• 从 Combine/RxSwift 迁移至 Swift Concurrency
• 使用迁移工具处理即将推出的 Swift 特性

测试并发代码

• 使用 Swift Testing（推荐）或 XCTest 编写可靠的测试
• 在测试中处理 @MainActor 隔离
• 使用 withMainSerialExecutor 进行确定性测试
• 通过适当的异步处理避免不稳定的（flaky）测试

集成 Core Data

• 使用 NSManagedObjectID 安全地在隔离域之间传递数据
• 实现数据访问对象 (DAO)