1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | Swift-Concurrency-Agent-Skill | — |
| 作者/维护者 | Antoine van der Lee（SwiftLee 博客作者、Swift Concurrency Course 创作者） | GitHub API + 作者个人网站 |
| 来源链接 | https://github.com/AvdLee/Swift-Concurrency-Agent-Skill | — |
| 许可证 | MIT | GitHub API + LICENSE 原文核对 |
| GitHub Stars | 1,604 | GitHub API |
| Forks | 100 | GitHub API |
| 最新版本 | v2.1.1（2026-05-04 发布） | GitHub Releases |
| 安装方式 | npx skills add、Claude Code 插件市场、pi 包管理器、手动 symlink 四种渠道均可 |
官方 README |
2. 功能介绍与亮点
Swift Concurrency Agent Skill 把 Swift 并发模型的诊断与迁移经验固化成 AI 编码助手可直接执行的决策流程，覆盖 async/await、actor 隔离、Sendable 一致性、Task 生命周期与取消、Swift 6 严格并发迁移、并发代码测试、Core Data 跨隔离域集成、以及基于 Instruments 的性能优化。
核心能力：
- Fast Path 诊断流程：先读取
Package.swift/.pbxproj判定语言模式、严格并发级别与默认隔离设置，再确定代码的隔离边界，避免不问青红皂白就套用@MainActor - 诊断信息对照表：把编译器/SwiftLint 的具体报错文案（如
Sending value of non-Sendable type...）逐条映射到“首先检查什么→最小安全修复→深入参考文档”的处理路径 - 14 份细分参考文档：actor 隔离、Sendable、Task、迁移步骤、测试、性能、内存管理、linting、Core Data 集成等主题各自独立成文
- 护栏式建议：明确要求不得把
@MainActor当万能贴布丁，@unchecked Sendable等逃生舱必须附带书面不变量说明
主要亮点：内容提炼自作者本人在大型生产代码库中迁移到 Swift 6 的真实经验；近 3 个月内有 14 位独立开发者提交并被合并的 Pull Request（涵盖 Xcode 26 新特性补充、描述精简、路径修复、pi 包管理器支持等），并非单人维护的空气仓库；版本持续迭代至 v2.1.1。
3. 适用场景
所属分类：工程效率与代码质量
适合正在把现有 Swift 代码库迁移到 Swift 6 严格并发检查的团队、调试数据竞争或隔离错误的 iOS/macOS 开发者、需要为并发代码编写可靠测试（Swift Testing 或 XCTest）的工程师，以及希望减少 actor 争用、优化并发性能的 Apple 平台开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json与plugin.json，可通过/plugin marketplace add+/plugin install两条命令安装，也支持项目级.claude/settings.json自动推送给团队成员 - Codex：支持——README 提供 OpenAI 官方“Where to save skills”文档链接，并提供通用的
npx skills add安装方式 - OpenClaw：未验证——抓取材料未提及
- Hermes Agent：未验证——抓取材料未提及
5. 推荐理由
由资深 Swift 并发专家独立打造并持续维护、有真实社区贡献验证的 Swift 6 并发迁移与调试指南，把“诊断信息→隔离边界判断→最小安全修复”的处理流程固化给 AI 编码助手，避免其滥用 @MainActor 之类万能贴布丁式修复。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 1,604 star、100 fork；近 3 个月内有 14 位独立开发者提交并被合并 PR（涉及新特性支持、内容修正、安装渠道扩展），非单人维护 |
| 可用性 | 9 | npx skills add 一条命令即可安装，另有 Claude Code 插件市场、pi 包管理器、手动 symlink 三条备选路径；SKILL.md 含完整诊断对照表，另配 14 份细分参考文档；最近一次提交在近 3 个月内；全程无付费依赖（作者付费课程仅为可选深入学习链接） |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
- shell 命令执行范围：技能正文与全部 14 份参考文档均为纯 Markdown 知识与代码示例，不含任何 shell 命令或可执行脚本
- 联网外发：无数据外发
- API key/凭据：不需要任何密钥或账号
- 可疑指令：抓取 SKILL.md 全文与全部参考文档目录，未发现面向 AI 助手的隐蔽指令或异常代码
- 作者信誉：具名个人开发者（SwiftLee 博客、个人网站公开可查），14 位独立贡献者的真实合并记录印证并非刷星仓库
- License：MIT，已核对仓库 LICENSE 原文
- 最近维护：最近一次提交在近 3 个月窗口内，非弃置项目
7. 跟同类 Skills 相比的优势
| 同类 Skill | 定位 | 与本 skill 的差异 |
|---|---|---|
| SwiftUI-Agent-Skill | 面向 SwiftUI 界面开发的最佳实践与品牌资产指南 | 解决的是界面层设计与实现规范问题，不涉及并发隔离、数据竞争或 Swift 6 迁移 |
| Core-Data-Agent-Skill | 聚焦 Apple Core Data 框架的数据建模、fetch 请求与性能模式 | 解决的是持久化层建模问题，仅在跨隔离域传递 NSManagedObject 时与并发话题有交集 |
| Xcode-Build-Optimization-Agent-Skill | 聚焦 Xcode 增量与全量构建速度的基准测试与优化 | 解决的是编译期构建性能问题，不涉及运行时并发安全或数据竞争调试 |
三者与本 skill 出自同一作者之手，共同覆盖 iOS/macOS 开发的不同环节，但分别指向界面、持久化、构建速度；Swift Concurrency Agent Skill 是其中唯一专门处理运行时并发安全、数据竞争根因与 Swift 6 迁移决策的一份。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价可查证。GitHub 仓库本身可见 14 位独立开发者提交并被合并的 Pull Request，覆盖内容修正、新特性补充与安装渠道扩展，是目前唯一可核实的第三方参与证据。
9. 其他补充
除 Claude Code 插件市场与 Codex 官方安装文档外，仓库还提供 pi 包管理器（面向其他 Agent 运行时）安装方式；README 中列出三个同作者的姊妹技能（SwiftUI、Core Data、Swift Testing）供有其他 Apple 平台开发需求的用户按需搭配安装。
10. 安装使用方式
- 推荐方式（
skills.sh平台，适配多种 Agent）：npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency - Claude Code 插件市场：
/plugin marketplace add AvdLee/Swift-Concurrency-Agent-Skill /plugin install swift-concurrency@swift-concurrency-agent-skill - pi 包管理器：
pi install https://github.com/AvdLee/Swift-Concurrency-Agent-Skill - 手动安装：clone 仓库后，将
swift-concurrency/文件夹按各 Agent 官方文档 symlink 进对应的 skills 目录 - 安装后无需重启，直接让 AI 助手“使用 swift concurrency 技能分析当前项目的并发改进点”即可触发
11. 注意事项
- 内容基于作者个人经验与其付费课程提炼而成，非 Apple 官方出品，不能完全替代官方 Swift Concurrency 文档
- 在 OpenClaw、Hermes Agent 上的兼容性尚未经过验证，安装前建议先小范围测试
- 仓库聚焦纯 Swift/Apple 平台的并发场景，对其他语言的并发调试不适用