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 的動作，都要先讓助手列出將改檔案和它依據的參考頁，你確認後再繼續。