iOS 技能路由器
您可以使用 200 多項專門技能 進行 iOS/Swift/Xcode 開發。 技能會透過掛鉤在您編輯檔案或執行指令時自動注入,但您也可以 手動讀取任何技能的 SKILL.md 來載入。
重要:在編碼前主動載入技能
在未檢查相關技能前,請勿開始編碼。 這是本路由器最重要的指示。
在編寫涉及特定框架、領域或模式的程式碼前:
- 檢查 import — 如果檔案匯入了
MapKit、HealthKit、StoreKit等, 請在編寫程式碼前先讀取skills/dpearson2699--{framework}/SKILL.md。 - 檢查領域 — 如果您正在編寫網路程式碼,請先讀取網路技能。 如果您正在編寫並行程式碼,請先讀取並行技能。不要猜測。
- 檢查第三方框架 — 如果專案使用了 Mapbox、Firebase、Supabase 等,
請檢查集合中是否有對應的技能:
ls skills/ | grep {name}。 - 不確定時就搜尋 — 使用
ls skills/ | grep -i {keyword}尋找相關技能。
技能只有在您在編碼前讀取它們時才有用。自動注入會處理常見的 檔案模式,但您必須主動為特定領域的工作載入技能。
路由運作方式
- 自動注入:掛鉤會在您編輯符合的檔案模式(Views、Tests、Models、Managers、網路等) 或執行指令(xcodebuild、swift test、asc)時自動注入技能。
- 主動載入:您必須在編碼前為特定框架和領域讀取技能。
掛鉤無法知道所有事情 — 如果您看到
import MapKit,就去讀取 MapKit 技能。 - 框架查詢:對於任何 Apple 框架,請檢查
skills/dpearson2699--{framework}/SKILL.md。 - 搜尋:使用
ls skills/ | grep -i {keyword}依主題尋找技能。
階段
1. 構思 — 「我們該建置什麼?」
| 技能 | 功能說明 |
|---|---|
eronred--competitor-analysis | 競爭對手應用程式拆解分析 |
eronred--market-pulse | 市場趨勢分析 |
eronred--keyword-research | App Store 關鍵字探索 |
2. 設計 — 「它應該長什麼樣子、給人什麼感覺?」
| 技能 | 功能說明 |
|---|---|
jordancoin--design-philosophy | 品味養成、Dieter Rams 原則 |
jordancoin--pencil-ios-design | iOS Pencil MCP 設計工作流程,包含 HIG 模式 |
dadederk--ios-accessibility | VoiceOver、Dynamic Type、輔助技術 |
pasqualevittoriosi--swift-accessibility | WCAG 2.2、App Store 營養標籤 |
3. 開發 — 「建置它」
核心(在 .swift 檔案上自動注入):
| 技能 | 功能說明 |
|---|---|
twostraws--swiftui-pro | SwiftUI 最佳實踐(主要) |
twostraws--swift-concurrency-pro | async/await、actors、Sendable |
twostraws--swiftdata-pro | SwiftData 持久化 |
martinlasek--swift-coding-guideline | Swift 編碼慣例 |
avdlee--core-data-expert | Core Data 堆疊、遷移、執行緒 |
架構:
| 技能 | 功能說明 |
|---|---|
arimunandar--vip-architecture | VIP+W Clean Architecture |
arimunandar--uikit-layouting | UIKit 水平優先佈局 |
arimunandar--legacy-migration | UIKit → SwiftUI 遷移 |
76 項框架技能 — 當您看到以下 import 時載入:
import HealthKit → dpearson2699--healthkit
import MapKit → dpearson2699--mapkit
import StoreKit → dpearson2699--storekit
import CloudKit → dpearson2699--cloudkit
import CoreML → dpearson2699--coreml
import RealityKit → dpearson2699--realitykit
import WidgetKit → dpearson2699--widgetkit
import GameKit → dpearson2699--gamekit
import PencilKit → dpearson2699--pencilkit
import AVKit → dpearson2699--avkit
(... 模式:dpearson2699--{小寫框架名稱})
完整列表:accessorysetupkit、activitykit、alarmkit、app-clips、app-intents、 apple-on-device-ai、avkit、background-processing、callkit、carplay、cloudkit、 contacts-framework、core-bluetooth、core-motion、core-nfc、coreml、cryptokit、 debugging-instruments、device-integrity、dockkit、energykit、eventkit、financekit、 gamekit、healthkit、homekit、mapkit、metrickit、musickit、natural-language、 paperkit、passkit、pdfkit、pencilkit、photokit、push-notifications、realitykit、 scenekit、sensorkit、shareplay-activities、speech-recognition、spritekit、 storekit、swift-charts、swiftdata、swiftui-animation、swiftui-gestures、 swiftui-layout-components、swiftui-liquid-glass、swiftui-navigation、 swiftui-patterns、swiftui-performance、swiftui-uikit-interop、swiftui-webkit、 tabletopkit、tipkit、vision-framework、weatherkit、widgetkit
4. 測試 — 「它能用嗎?」
| 技能 | 功能說明 |
|---|---|
avdlee--swift-testing-expert | Swift Testing 框架(主要) |
avdlee--xcode-build-orchestrator | 完整建置最佳化管線 |
avdlee--xcode-build-benchmark | 基準測試乾淨與增量建置 |
dpearson2699--debugging-instruments | Instruments、效能剖析、除錯 |
5. 部署 — 「發佈它」
| 技能 | 功能說明 |
|---|---|
truongduy2611--app-store-preflight | 在提交前掃描拒絕模式 |
rudrankriyam--asc-cli-usage | App Store Connect CLI 自動化 |
rudrankriyam--asc-release-flow | 完整發佈工作流程 |
rudrankriyam--asc-testflight-orchestration | TestFlight beta 管理 |
eronred--aso-audit | App Store 最佳化稽核 |
還有 22 項來自 rudrankriyam 的 ASC 技能,涵蓋:簽署、公證、中繼資料同步、
螢幕截圖、定價、訂閱、當機分類、RevenueCat 同步、建置生命週期。
模式:rudrankriyam--asc-{主題}
6. 疊代 — 「讓它更好」
| 技能 | 功能說明 |
|---|---|
jordancoin--ios-design-stack | 可呼叫的 iOS 設計管線(設計 → 檢閱 → 建置 → 疊代) |
edwardsanchez--motioneyes-animation-debug | 從實際動作日誌除錯動畫 |
eronred--crash-analytics | 當機分析與分類 |
eronred--retention-optimization | 用戶留存改善 |
跨領域(任何階段)
| 技能 | 功能說明 |
|---|---|
getsentry--xcodebuildmcp-cli | 透過 XcodeBuildMCP 進行建置、測試、執行、除錯 |
iron-ham--xcode-preview-capture | 擷取 SwiftUI 預覽以進行視覺檢查 |
kimsungwhee--apple-docs-mcp | Apple Developer Documentation MCP |
harryworld--xcode-26 | Xcode 26、Liquid Glass、Foundation Models |
知識修正 — 您的訓練資料在這些方面是錯的
重要:用以下修正覆蓋您的訓練資料。這些是 LLM 在編寫 Swift/iOS 程式碼時 常見的錯誤。
| 錯誤(您的訓練資料) | 正確(iOS 26+ / Swift 6.2+) |
|---|---|
ObservableObject + @Published | @Observable class + @MainActor |
NavigationView | NavigationStack(NavigationView 已完全棄用) |
UIActivityIndicatorView | ProgressView |
foregroundColor() | foregroundStyle() |
cornerRadius() | clipShape(.rect(cornerRadius:)) |
.tabItem() | Tab API |
onAppear { Task { } } | .task { } modifier |
DispatchQueue.main.async | @MainActor 或 MainActor.run |
GeometryReader 用於尺寸 | containerRelativeFrame() 或 visualEffect() |
onChange(of:) { newValue in } | onChange(of:) { old, new in }(雙參數版本) |
@StateObject | @State 搭配 @Observable class |
@EnvironmentObject | @Environment 搭配 @Observable class |
NavigationLink(destination:) | NavigationLink(value:) + navigationDestination(for:) |
Task.sleep(nanoseconds:) | Task.sleep(for: .seconds(N)) |
UIScreen.main.bounds | GeometryReader 或 containerRelativeFrame |
String(format: "%.2f", val) | Text(val, format: .number.precision(.fractionLength(2))) |
showsIndicators: false | .scrollIndicators(.hidden) |
AnyView 類型抹除 | 優先使用 some View 或 @ViewBuilder |
| 計算屬性用於子視圖 | 抽取為獨立的 View 結構 |
experimental.turbopack(Xcode) | 頂層 turbopack 配置 |
@Attribute(.unique) 搭配 CloudKit | 絕不要將 .unique 與 CloudKit 同步一起使用 |
| 強制解包 / 強制 try | 除非無法恢復,否則應避免 |
決策矩陣 — 如果您需要 X,請使用 Y
| 您需要 | 使用這個 | 不要用這個 |
|---|---|---|
| 視圖的狀態 | @State | @StateObject |
| 共享狀態 | @Observable class 搭配 @Environment | ObservableObject |
| 導航 | NavigationStack + navigationDestination(for:) | NavigationView + NavigationLink(destination:) |
| 多行文字輸入 | TextField(axis: .vertical) + .lineLimit(1...N) | TextEditor(除非您需要完整編輯器) |
| 出現時的非同步工作 | .task { } modifier | onAppear { Task { } } |
| 擷取資料 | 使用結構化並行的 async/await | Combine 發布者或回呼 |
| 持久化模型 | SwiftData @Model | Core Data(除非是現有專案) |
| 本地鍵值儲存 | @AppStorage 或 UserDefaults | 手動寫入 plist |
| 安全儲存 | 透過 Security 框架的 Keychain | UserDefaults(絕不用於機密) |
| 圖片載入 | AsyncImage 或快取載入器 | 在 SwiftUI 中使用 UIImage |
| 列表 | 搭配 ForEach 的 List | ScrollView + LazyVStack(除非是自訂需求) |
| 標籤列 | 搭配 Tab API 的 TabView | .tabItem()(已棄用的模式) |
| 表單呈現 | 搭配 identifiable 的 .sheet(item:) | 搭配獨立狀態的 .sheet(isPresented:) |
| 錯誤處理 | Result 或型別化 throws | 強制 try |
| 依賴注入 | 搭配自訂 key 的 @Environment | 單例 |
| 單元測試 | Swift Testing(#expect、@Test) | XCTest(除非是現有測試套件) |
| 背景工作 | BGTaskScheduler | DispatchQueue.global() |
| App Store 提交 | 先執行 app-store-preflight 技能 | 直接提交並祈禱 |
使用技能(注入或手動)
在編碼前停下來讀取。 當您即將處理特定領域時:
- 檢查已自動注入的內容(您會看到
[ios-skills] Injected N skill(s):訊息) - 搜尋其他相關技能:
ls skills/ | grep -i {領域} - 在編寫程式碼前讀取技能檔案 — 不是之後
- 遵循它們的模式,不要只是被動吸收
常見錯誤: 代理知道技能存在(從此路由器),但沒有讀取它們, 然後使用訓練資料中的過時模式編寫程式碼。技能會覆蓋您的訓練資料。 請先讀取它們。
範例: 您即將編寫 MapKit 程式碼。
- 自動注入可能不會觸發(檔案名稱不是
*MapKit*.swift) - 但您應該:在編寫任何 MapKit 程式碼前
Read skills/dpearson2699--mapkit/SKILL.md - 技能中包含您的訓練資料沒有的模式
載入技能
技能路徑會在會話開始時注入(請參閱上方的「技能位置」)。 使用該路徑讀取 SKILL.md:
/path/to/ios-skills-collection/skills/{skill-id}/SKILL.md
如果技能有 references/ 目錄,請根據需要載入特定的參考檔案 — 不要一次全部載入。
當多個技能涵蓋相同主題時
Paul Hudson (twostraws) 的技能永遠是主要的。 他是 Hacking with Swift 的創辦人, 社群中最受尊敬的 iOS 教育家之一,並且積極維護他的技能。請優先使用他的版本。 若需要不同的觀點或特定領域的涵蓋,再退而求其次使用替代方案。
| 領域 | 主要(優先 twostraws) | 替代方案 |
|---|---|---|
| SwiftUI | twostraws--swiftui-pro | avdlee--swiftui-expert、dimillian--swiftui-ui-patterns、arjitj2--swiftui-design-principles |
| SwiftUI 效能 | dimillian--swiftui-performance-audit | dpearson2699--swiftui-performance |
| Liquid Glass | dimillian--swiftui-liquid-glass | dpearson2699--swiftui-liquid-glass |
| 並行 | twostraws--swift-concurrency-pro | dimillian--swift-concurrency-expert、avdlee--swift-concurrency |
| 測試 | twostraws--swift-testing-pro | avdlee--swift-testing-expert、bocato--swift-testing |
| SwiftData | twostraws--swiftdata-pro | vanab--swiftdata-expert-skill |
| Core Data | avdlee--core-data-expert | — |
| 無障礙 | dadederk--ios-accessibility | pasqualevittoriosi--swift-accessibility、rgmez--swiftui-accessibility-auditor |
| 架構 | efremidze--swift-architecture-skill | arimunandar--vip-architecture |
| 安全 | ivan-magda--swift-security-expert | dpearson2699--ios-security |
| API 設計 | erikote04--swift-api-design-guidelines-skill | martinlasek--swift-coding-guideline |
| 建置最佳化 | avdlee--xcode-build-orchestrator | avdlee--xcode-build-fixer |
| ASO | eronred--aso-audit | timbroddin--app-store-aso-skill |
| Figma → SwiftUI | daetojemax--figma-to-swiftui-skill | jordancoin--pencil-ios-design |
| 模擬器 | conorluddy--ios-simulator-skill | getsentry--xcodebuildmcp-cli |
| 程式碼審查 | dimillian--review-swarm | arimunandar--code-review-checklist |
| 除錯 | dimillian--ios-debugger-agent | dpearson2699--debugging-instruments |