Swift Concurrency Skill：先分析项目并发，再谈 Swift 6 迁移

适合谁

如果你在维护 Swift 项目，希望编码助手按一份专家技能来谈安全并发、性能和 Swift 6+ 迁移，而不是凭记忆混用旧的线程 API，这个技能更合适。它面向任何支持 Agent Skills 开放格式的 AI 编码工具。格式说明见

https://agentskills.io/home

你需要已经有可分析的 Swift 工程，并接受用一条 npx 命令把 swift-concurrency 技能加进去。只想读 WWDC 笔记、不打算让助手读仓库的人，收益有限。页面举例了若干带客户端清单的产品，同时写了「任何支持该格式的工具」，所以不要把举例理解成封闭名单。

3 分钟完成第一次尝试

官方安装就是这一条：

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

它会把该技能写入当前 Agent 环境。先确认本机有 npx，并且这是你要分析的那个 Swift 项目所在环境，再执行。不要并列另一套安装器。

装好后用官方示例做只读分析，不要先迁移：

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

成功信号按页面的 How to verify：助手应引用 skills/swift-concurrency/SKILL.md 里的 triage/playbook，并跳进与你的错误或任务对应的参考文件。若它只给泛泛的 async 建议、却不提这份 playbook，先停下来让它打开技能文件。分析阶段不要允许它改 actor、改隔离或升到 Swift 6。

使用案例

案例一：检查当前项目的并发改进点。就用上一节那句官方提示。任务是分析，不是改代码。摘录没有写它会扫描哪些目录，也没有写报告格式。因此你能确认的是：它声明使用了 swift concurrency 技能，并且落到 SKILL.md 的分流手册。若建议已经变成「我来帮你改这些文件」，先要一份文件清单再决定。

案例二：对着具体错误或迁移任务查参考页。验证步骤写明：针对你的 error or task，跳进相应 reference file。当你已经有一条编译器并发诊断，或明确要做 Swift 6+ 迁移时，让助手先打开 playbook，再打开对应参考，而不是直接改语言模式。性能优化也被列为能力，但没有给出性能探针命令。所以性能任务同样先对照参考文件；缺了命令就不要发明基准脚本。

使用边界

这是专家指导技能，不是自动迁移器。安全并发、性能、Swift 6+ 迁移都在范围内，但第一次应停在分析和引用。仓库还被写成可移植的 Agent Plugin（spec 1.0.0），兼容客户端会从根目录 plugin.json 和 skills/ 发现技能。那是包装说明，不是第二条安装命令。安装仍只用上面的 npx skills add。

插件规范见

https://agent-plugins.org/

不要据此再走未写出的商店安装。参考文件的完整清单没有出现在摘录里；你无法根据这份材料点名某一份 reference。

第一次停在分析。任何修改 Swift 并发代码、变更语言模式或批量加 @MainActor 的动作，都要先让助手列出将改文件和它依据的参考页，你确认后再继续。