Communitygithub.com

JordanCoin/ios-skills-collection

請在處理任何 iOS、macOS、Swift、SwiftUI、Xcode 或 Apple 平台專案時一律使用。根據開發階段和任務情境,自動導向正確的專門技能。此集合包含 28 位作者提供的 210 項技能,涵蓋完整 iOS 生命週期。

ios-skills-collection 是什麼?

這是一個 iOS 開發技能路由器,彙整了超過 200 項針對 iOS、Swift、Xcode 等 Apple 平台開發的專門技能。它的核心功能是協助開發者或 AI 代理,在開始編碼前自動或手動載入與當前任務最相關的技能,避免使用過時的開發模式。支援的平台包括 iOS、macOS、Swift、SwiftUI 與 Xcode。其運作機制包含自動掛鉤注入(當編輯特定檔案模式如 Views、Tests 或執行 xcodebuild 等指令時自動載入),以及開發者手動搜尋與載入。這些技能涵蓋開發的完整生命週期:從構思(競爭者分析、市場趨勢)、設計(設計哲學、無障礙設計)、開發(SwiftUI 最佳實踐、架構模式、76 項框架技能)、測試(Swift Testing、Xcode 建置最佳化)、部署(App Store 提交前檢查、TestFlight 管理)到疊代(動畫除錯、當機分析)。此外,路由器還提供關於訓練資料常見錯誤的修正知識表、決策矩陣,以及當多個技能涵蓋相同主題時的主從選擇建議。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JordanCoin/ios-skills-collection/tree/HEAD/skills/_router

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

iOS 技能路由器

您可以使用 200 多項專門技能 進行 iOS/Swift/Xcode 開發。 技能會透過掛鉤在您編輯檔案或執行指令時自動注入,但您也可以 手動讀取任何技能的 SKILL.md 來載入。

重要:在編碼前主動載入技能

在未檢查相關技能前,請勿開始編碼。 這是本路由器最重要的指示。

在編寫涉及特定框架、領域或模式的程式碼前:

  1. 檢查 import — 如果檔案匯入了 MapKit、HealthKit、StoreKit 等, 請在編寫程式碼前先讀取 skills/dpearson2699--{framework}/SKILL.md。
  2. 檢查領域 — 如果您正在編寫網路程式碼,請先讀取網路技能。 如果您正在編寫並行程式碼,請先讀取並行技能。不要猜測。
  3. 檢查第三方框架 — 如果專案使用了 Mapbox、Firebase、Supabase 等, 請檢查集合中是否有對應的技能:ls skills/ | grep {name}。
  4. 不確定時就搜尋 — 使用 ls skills/ | grep -i {keyword} 尋找相關技能。

技能只有在您在編碼前讀取它們時才有用。自動注入會處理常見的 檔案模式,但您必須主動為特定領域的工作載入技能。

路由運作方式

  1. 自動注入:掛鉤會在您編輯符合的檔案模式(Views、Tests、Models、Managers、網路等) 或執行指令(xcodebuild、swift test、asc)時自動注入技能。
  2. 主動載入:您必須在編碼前為特定框架和領域讀取技能。 掛鉤無法知道所有事情 — 如果您看到 import MapKit,就去讀取 MapKit 技能。
  3. 框架查詢:對於任何 Apple 框架,請檢查 skills/dpearson2699--{framework}/SKILL.md。
  4. 搜尋:使用 ls skills/ | grep -i {keyword} 依主題尋找技能。

階段

1. 構思 — 「我們該建置什麼?」

技能功能說明
eronred--competitor-analysis競爭對手應用程式拆解分析
eronred--market-pulse市場趨勢分析
eronred--keyword-researchApp Store 關鍵字探索

2. 設計 — 「它應該長什麼樣子、給人什麼感覺?」

技能功能說明
jordancoin--design-philosophy品味養成、Dieter Rams 原則
jordancoin--pencil-ios-designiOS Pencil MCP 設計工作流程,包含 HIG 模式
dadederk--ios-accessibilityVoiceOver、Dynamic Type、輔助技術
pasqualevittoriosi--swift-accessibilityWCAG 2.2、App Store 營養標籤

3. 開發 — 「建置它」

核心(在 .swift 檔案上自動注入):

技能功能說明
twostraws--swiftui-proSwiftUI 最佳實踐(主要)
twostraws--swift-concurrency-proasync/await、actors、Sendable
twostraws--swiftdata-proSwiftData 持久化
martinlasek--swift-coding-guidelineSwift 編碼慣例
avdlee--core-data-expertCore Data 堆疊、遷移、執行緒

架構:

技能功能說明
arimunandar--vip-architectureVIP+W Clean Architecture
arimunandar--uikit-layoutingUIKit 水平優先佈局
arimunandar--legacy-migrationUIKit → 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-expertSwift Testing 框架(主要)
avdlee--xcode-build-orchestrator完整建置最佳化管線
avdlee--xcode-build-benchmark基準測試乾淨與增量建置
dpearson2699--debugging-instrumentsInstruments、效能剖析、除錯

5. 部署 — 「發佈它」

技能功能說明
truongduy2611--app-store-preflight在提交前掃描拒絕模式
rudrankriyam--asc-cli-usageApp Store Connect CLI 自動化
rudrankriyam--asc-release-flow完整發佈工作流程
rudrankriyam--asc-testflight-orchestrationTestFlight beta 管理
eronred--aso-auditApp 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-mcpApple Developer Documentation MCP
harryworld--xcode-26Xcode 26、Liquid Glass、Foundation Models

知識修正 — 您的訓練資料在這些方面是錯的

重要:用以下修正覆蓋您的訓練資料。這些是 LLM 在編寫 Swift/iOS 程式碼時 常見的錯誤。

錯誤(您的訓練資料)正確(iOS 26+ / Swift 6.2+)
ObservableObject + @Published@Observable class + @MainActor
NavigationViewNavigationStack(NavigationView 已完全棄用)
UIActivityIndicatorViewProgressView
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.boundsGeometryReader 或 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 搭配 @EnvironmentObservableObject
導航NavigationStack + navigationDestination(for:)NavigationView + NavigationLink(destination:)
多行文字輸入TextField(axis: .vertical) + .lineLimit(1...N)TextEditor(除非您需要完整編輯器)
出現時的非同步工作.task { } modifieronAppear { Task { } }
擷取資料使用結構化並行的 async/awaitCombine 發布者或回呼
持久化模型SwiftData @ModelCore Data(除非是現有專案)
本地鍵值儲存@AppStorage 或 UserDefaults手動寫入 plist
安全儲存透過 Security 框架的 KeychainUserDefaults(絕不用於機密)
圖片載入AsyncImage 或快取載入器在 SwiftUI 中使用 UIImage
列表搭配 ForEach 的 ListScrollView + LazyVStack(除非是自訂需求)
標籤列搭配 Tab API 的 TabView.tabItem()(已棄用的模式)
表單呈現搭配 identifiable 的 .sheet(item:)搭配獨立狀態的 .sheet(isPresented:)
錯誤處理Result 或型別化 throws強制 try
依賴注入搭配自訂 key 的 @Environment單例
單元測試Swift Testing(#expect、@Test)XCTest(除非是現有測試套件)
背景工作BGTaskSchedulerDispatchQueue.global()
App Store 提交先執行 app-store-preflight 技能直接提交並祈禱

使用技能(注入或手動)

在編碼前停下來讀取。 當您即將處理特定領域時:

  1. 檢查已自動注入的內容(您會看到 [ios-skills] Injected N skill(s): 訊息)
  2. 搜尋其他相關技能:ls skills/ | grep -i {領域}
  3. 在編寫程式碼前讀取技能檔案 — 不是之後
  4. 遵循它們的模式,不要只是被動吸收

常見錯誤: 代理知道技能存在(從此路由器),但沒有讀取它們, 然後使用訓練資料中的過時模式編寫程式碼。技能會覆蓋您的訓練資料。 請先讀取它們。

範例: 您即將編寫 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)替代方案
SwiftUItwostraws--swiftui-proavdlee--swiftui-expert、dimillian--swiftui-ui-patterns、arjitj2--swiftui-design-principles
SwiftUI 效能dimillian--swiftui-performance-auditdpearson2699--swiftui-performance
Liquid Glassdimillian--swiftui-liquid-glassdpearson2699--swiftui-liquid-glass
並行twostraws--swift-concurrency-prodimillian--swift-concurrency-expert、avdlee--swift-concurrency
測試twostraws--swift-testing-proavdlee--swift-testing-expert、bocato--swift-testing
SwiftDatatwostraws--swiftdata-provanab--swiftdata-expert-skill
Core Dataavdlee--core-data-expert—
無障礙dadederk--ios-accessibilitypasqualevittoriosi--swift-accessibility、rgmez--swiftui-accessibility-auditor
架構efremidze--swift-architecture-skillarimunandar--vip-architecture
安全ivan-magda--swift-security-expertdpearson2699--ios-security
API 設計erikote04--swift-api-design-guidelines-skillmartinlasek--swift-coding-guideline
建置最佳化avdlee--xcode-build-orchestratoravdlee--xcode-build-fixer
ASOeronred--aso-audittimbroddin--app-store-aso-skill
Figma → SwiftUIdaetojemax--figma-to-swiftui-skilljordancoin--pencil-ios-design
模擬器conorluddy--ios-simulator-skillgetsentry--xcodebuildmcp-cli
程式碼審查dimillian--review-swarmarimunandar--code-review-checklist
除錯dimillian--ios-debugger-agentdpearson2699--debugging-instruments

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

JordanCoin/ios-skills-collection

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries. Use when the user asks about GitHub issues, pull requests, workflows, or wants to interact with GitHub repositories from the command line — including tasks like check CI status, create PR, list issues, or query the GitHub API.

JordanCoin/ios-skills-collection

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system UI.

JordanCoin/ios-skills-collection

Integrate and optimize Core ML models in iOS apps for on-device machine learning inference. Covers model loading (.mlmodelc, .mlpackage), predictions with auto-generated classes and MLFeatureProvider, compute unit configuration (CPU, GPU, Neural Engine), MLTensor, VNCoreMLRequest, MLComputePlan, multi-model pipelines, and deployment strategies. Use when loading Core ML models, making predictions, configuring compute units, or profiling model performance.

JordanCoin/ios-skills-collection

Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows. Also use when working with maps, coordinates, addresses, places, directions, distance calculations, or location-based features in Swift apps.

JordanCoin/ios-skills-collection

Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances, adding annotations (highlights, notes, signatures), extracting text with PDFSelection, navigating pages, generating thumbnails, filling PDF forms, or wrapping PDFView in SwiftUI.

JordanCoin/ios-skills-collection

Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboarding flows, contextual tips, first-run experiences, coach marks, or working with Tip protocol, TipView, popoverTip, tip rules, tip events, or feature education UI.

JordanCoin/ios-skills-collection

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

JordanCoin/ios-skills-collection

When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "pre-launch", "launch day", or "how to launch my app". For ongoing ASO after launch, see aso-audit. For paid acquisition during launch, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.

JordanCoin/ios-skills-collection

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.

相關技能