Swift Concurrency 6.2 Skill 是 Everything Claude Code 插件体系中专为 Swift 6.2 并发模型设计的专业能力。它让你的 Swift 代码默认单线程（MainActor），显著降低数据竞争风险，只有在明确需要并行时才用 @concurrent 显式后台调度。迁移旧项目、消除并发安全编译错误、优化 UI 架构或后台性能时，Skill 可自动识别并指导迁移、标注和调优流程，结合 Agent/Hook/Rule 体系实现端到端并发安全提升。

Everything Claude Code Swift Concurrency 6.2 Skill：Approachable Concurrency 单线程默认与 @concurrent 后台

Swift 6.2 带来了革命性的并发模型变革：默认所有异步（async）代码都在单线程（通常是 MainActor）上运行，只有显式标注 @concurrent 时才会后台并行。这一 Skill 正是将 Swift 6.2 的 Approachable Concurrency 模式集成进 Claude Code 插件体系，帮助开发者在 AI 辅助编程环境下安全、高效地迁移和优化 Swift 并发代码。

本指南将详细讲解该 Skill 的适用场景、激活条件、逐步迁移与使用流程、输出示例、常见配套 Agent 以及与其他 Skill 的协作方式，助你在实际项目中用好 Swift 6.2 并发能力。

1. 这个 Skill 解决什么问题？

传统 Swift 并发的痛点

在 Swift 6.1 及更早版本，async 函数经常会隐式切换到后台线程，即使你在 MainActor 上声明了类型，也难以避免数据竞争和编译器报错。例如：

// Swift 6.1: 可能出现数据竞争编译错误
@MainActor
final class StickerModel {
    let photoProcessor = PhotoProcessor()

    func extractSticker(_ item: PhotosPickerItem) async throws -> Sticker? {
        guard let data = try await item.loadTransferable(type: Data.self) else { return nil }
        // 这里 photoProcessor 可能被后台线程访问，导致数据竞争
        return await photoProcessor.extractSticker(data: data, with: item.itemIdentifier)
    }
}

Swift 6.2 Skill 的核心价值

• 默认单线程安全：async 保持在调用者的 actor 上，消除隐式后台切换和数据竞争。
• 显式并行：只有用 @concurrent 标注的函数才会后台并发执行，性能调优更可控。
• 协议隔离支持：MainActor 类型可安全实现非隔离协议，无需复杂 workaround。
• 全局/静态状态保护：通过 MainActor 默认推断，自动隔离全局可变状态。
• 迁移无痛：Skill 自动检测旧代码中的隐式并发风险，给出迁移建议与自动修复。

2. 触发条件：Skill 何时自动激活？

• 你在 Swift 项目中升级到 6.2 或 Xcode 26，Skill 自动检测并提示开启 Approachable Concurrency。
• 编译出现数据竞争相关错误，如“actor-isolated property accessed from nonisolated context”，Skill 会介入并生成修复建议。
• 项目配置检测到未开启 MainActor 默认推断或并发安全设置，Skill 提示并引导一键配置。
• 你在 Claude Code 内请求并发相关代码生成、迁移、代码审查时，Skill 自动分析上下文并输出最佳实践建议。

3. 使用流程：如何在实际项目中用好 Swift Concurrency 6.2 Skill

Step 1：开启 Swift 6.2 并发安全设置

• Xcode 26 项目：在 Build Settings > Swift Compiler > Concurrency，勾选 Approachable Concurrency、MainActor 默认隔离等选项。
• SwiftPM 项目：在 Package.swift 添加

  .swiftSettings([
      .enableExperimentalFeature("StrictConcurrency=complete"),
      .enableExperimentalFeature("MainActorInference=enabled")
  ])

• Skill 可自动识别未开启并提示一键配置。

Step 2：代码迁移与自动修复

• Skill 检查点：扫描项目，定位所有隐式并发风险点（如 async 函数内对 actor 状态的访问、全局变量未隔离等）。
• 自动修复建议：Skill 输出迁移 diff，例如将全局单例加 @MainActor，或将协议实现调整为隔离 conformances。
• 示例修复前后对比：

// 修复前：全局状态未隔离
final class StickerLibrary {
    static let shared: StickerLibrary = .init()  // 可能数据竞争
}

// 修复后：自动加 MainActor
@MainActor
final class StickerLibrary {
    static let shared: StickerLibrary = .init()  // 安全
}

Step 3：并行性能调优（显式 @concurrent）

• Skill 检测：只有检测到 CPU 密集型、I/O 密集型代码，Skill 才建议加 @concurrent。
• 自动标注与调用调整：

nonisolated final class PhotoProcessor {
    // ...
    @concurrent
    static func extractSubject(from data: Data) async -> Sticker { /* ... */ }
}

// 调用方需加 await
let sticker = await PhotoProcessor.extractSubject(from: data)

• Skill 输出建议：只对性能瓶颈路径加 @concurrent，避免滥用。

Step 4：协议隔离与类型安全

• Skill 自动识别：MainActor 类型实现协议时，自动用隔离 conformances，避免编译错误。
• 示例：

extension StickerModel: @MainActor Exportable {
    func export() {
        photoProcessor.exportAsPNG()
    }
}

• Skill 检查：确保协议调用方与实现方 actor 隔离一致，防止类型安全问题。

Step 5：全流程验证与测试

• Skill 配合 Verification Loop，自动检测并发相关的编译和运行时错误。
• 推荐配合 Agent：
  • Code Reviewer Agent：并发安全审查
  • Performance Optimizer Agent：性能瓶颈分析并建议 @concurrent 标注点
  • Architect Agent：架构层面并发模式选型
• 与 Hooks 协作：可在 PreToolUse 阶段自动扫描并发风险，PostToolUse 阶段输出迁移建议。

4. 输出示例

Skill 典型输出（Claude Code 会话/Agent 自动建议）：

• “检测到 extractSticker 可能存在数据竞争，建议升级 Swift 6.2 并开启 Approachable Concurrency，已为你自动添加 @MainActor 标注并修复协议实现。”
• “PhotoProcessor.extractSubject 建议加 @concurrent 并发标注，已自动调整调用方为 await 并检测全局状态隔离。”
• “StickerLibrary.shared 全局单例已自动加 @MainActor，消除并发安全隐患。”
• “协议 Exportable 的 StickerModel 实现已迁移为隔离 conformance，类型安全已通过编译检查。”

5. Skill 与其他 Claude Code 体系组件协作

• 与 Rules 体系 协同，自动检测并发相关的代码风格和安全规则，输出一致性建议。
• 与 Agent Harness Construction Skill 配合，确保多 Agent 协作时并发安全无死角。
• 与 Verification Loop Skill 联动，端到端自动化并发安全验证。
• 与 Codebase Onboarding Skill 协作，新成员可自动获得并发模型迁移建议。

6. 最佳实践与反例

最佳实践：

• 优先编写单线程安全代码，后期再用 @concurrent 优化性能热路径。
• 全局/静态变量必须加 MainActor 隔离。
• 只对确实需要后台并行的函数加 @concurrent，避免滥用。
• 遇到编译器并发安全报错，优先用 Skill 建议修复，不要用 nonisolated 逃避隔离。

反例（Anti-pattern）：

• 所有 async 函数都加 @concurrent，导致不必要的线程切换和性能损耗。
• 用 nonisolated suppress 编译错误，实际破坏隔离安全。
• 继续使用旧版 DispatchQueue 并发模式，忽略 Actor 体系。

FAQ

Q: Swift 6.2 Skill 适合哪些项目？ A: 所有新建 Swift 6.2+ 项目强烈建议启用，迁移旧项目、优化 UI 架构或需要并发安全的场景也非常适用。

Q: Skill 会自动修改我的代码吗？ A: 在 Claude Code 插件体系下，Skill 可在 Agent/Hook 驱动下自动生成迁移 diff，用户确认后批量修复，最大程度减少人工迁移负担。

Q: 旧版 async/await 代码需要全部重写吗？ A: 不需要。Skill 支持渐进式迁移，优先修复高风险点和全局状态，后续可分阶段启用 MainActor 推断和 @concurrent 标注。

---