AvdLee/Swift-Testing-Agent-Skill

解決的問題

本專案為AI程式碼工具提供一個專用的知識庫（即「技能」），協助開發者實作並遷移至現代 Swift 測試框架。解決了AI代理缺乏關於 Swift 測試API、XCTest遷移策略以及平行執行模式的最新且實用的指引問題。

如何運作

本專案遵循 Agent Skills 開放格式，提供一組結構化的 Markdown 參考文件（包含作戰手冊與決策點），AI代理可加以吸收。這些參考文件涵蓋 #expect 與 #require 宏、參數化測試、非同步測試，以及單一目標中 Swift Testing 與 XCTest 共存等主題。

適用對象

• 採用新 Swift 測試框架的開發者與團隊。
• 逐步遷移既有 XCTest 套件的工程師。
• 調試不穩定測試或優化平行測試執行的開發者。

主要亮點

• 源碼導向的指引：基於 WWDC 2024 會議與全面的 SwiftLee 文章。
• 遷移支援：提供從 XCTAssert* 模式到現代 Swift Testing 宏的詳細對應關係。
• 現代優先方法：優先採用宏基礎診斷與平行預設，而非傳統風格。
• 廣泛的工具相容性：支援透過 skills.sh、Claude Code 插件安裝，以及 Cursor 和 Codex 等工具的手動安裝。