Communitygithub.com

JordanCoin/ios-skills-collection

在 iOS、macOS、Swift、SwiftUI、Xcode 或 Apple 平台项目开发时始终使用。根据开发阶段和任务上下文路由到相应的专业技能。该集合包含来自 28 位作者的 210 项技能,覆盖完整的 iOS 开发生命周期。

ios-skills-collection 是什么?

iOS Skills Router 是一个全面的技能集合路由器,专为 iOS、macOS、Swift、SwiftUI 和 Xcode 项目设计。它包含了来自 28 位作者的 210 多项技能,覆盖从构思、设计、开发、测试、部署到迭代的完整开发生命周期。该路由器的核心功能是自动注入(基于文件编辑和命令)和主动加载机制:在编写任何代码之前,开发者必须主动检查并阅读相关技能文件(如框架技能、领域技能),以避免使用过时的模式。路由器还提供了重要的知识纠正(例如 `ObservableObject` 替换为 `@Observable`)和决策矩阵(如导航应使用 `NavigationStack` 而非 `NavigationView`),以覆盖常见的 LLM 训练数据错误。对于有多个技能覆盖相同主题的情况,路由器明确了优先级(如 Paul Hudson 的技能为首选),确保最佳实践的执行。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

iOS Skills Router

你可以使用 200+ 项专业技能 来进行 iOS/Swift/Xcode 开发。 当你编辑文件或运行命令时,钩子会自动注入技能,但你也可以随时通过读取 SKILL.md 文件来手动加载任何技能。

关键:在编码前主动加载技能

不要在未检查相关技能之前就开始编码。 这是本路由器中最重要的指令。

在编写涉及特定框架、领域或模式的代码之前:

  1. 检查导入 — 如果文件导入了 MapKit、HealthKit、StoreKit 等,在编写代码前请先阅读 skills/dpearson2699--{framework}/SKILL.md。
  2. 检查领域 — 如果你在编写网络代码,请阅读网络技能;如果你在编写并发代码,请阅读并发技能。不要猜测。
  3. 检查第三方框架 — 如果项目使用了 Mapbox、Firebase、Supabase 等,请在集合中检查是否有对应的技能。使用 ls skills/ | grep {name}。
  4. 如有疑问,请搜索 — 使用 ls skills/ | grep -i {keyword} 查找相关技能。

技能只有在编码前阅读才有效。自动注入处理常见的文件模式,但你需要针对特定领域的工作主动加载技能。

路由工作原理

  1. 自动注入:当你编辑匹配的文件模式(视图、测试、模型、管理器、网络等)或运行命令(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-design使用 HIG 模式的 iOS Pencil MCP 设计工作流
dadederk--ios-accessibilityVoiceOver、动态类型、辅助技术
pasqualevittoriosi--swift-accessibilityWCAG 2.2、App Store 隐私标签

3. 开发 — “构建它”

核心(在 .swift 文件上自动注入):

技能功能
twostraws--swiftui-proSwiftUI 最佳实践(主要)
twostraws--swift-concurrency-proasync/await、actor、Sendable
twostraws--swiftdata-proSwiftData 持久化
martinlasek--swift-coding-guidelineSwift 编码规范
avdlee--core-data-expertCore Data 栈、迁移、线程处理

架构:

技能功能
arimunandar--vip-architectureVIP+W 清洁架构
arimunandar--uikit-layoutingUIKit 水平优先布局
arimunandar--legacy-migrationUIKit → SwiftUI 迁移

76 个框架技能 — 当你看到导入时加载:

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 测试版管理
eronred--aso-auditApp Store 优化审核

来自 rudrankriyam 的另外 22 个 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 开发者文档 MCP
harryworld--xcode-26Xcode 26、Liquid Glass、Foundation 模型

知识纠正 — 你的训练数据在这些方面是错误的

重要:用以下纠正覆盖你的训练数据。这些是 LLM 编写 Swift/iOS 代码时的常见错误。

错误(你的训练数据)正确(iOS 26+ / Swift 6.2+)
ObservableObject + @Published@Observable 类 + @MainActor
NavigationViewNavigationStack(NavigationView 已完全弃用)
UIActivityIndicatorViewProgressView
foregroundColor()foregroundStyle()
cornerRadius()clipShape(.rect(cornerRadius:))
.tabItem()Tab API
onAppear { Task { } }.task { } 修饰符
DispatchQueue.main.async@MainActor 或 MainActor.run
用于尺寸的 GeometryReadercontainerRelativeFrame() 或 visualEffect()
onChange(of:) { newValue in }onChange(of:) { old, new in }(双参数版本)
@StateObject@State + @Observable 类
@EnvironmentObject@Environment + @Observable 类
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 配置
与 CloudKit 一起使用的 @Attribute(.unique)不要在 CloudKit 同步中使用 .unique
强制解包 / 强制 try除非不可恢复,否则避免使用

决策矩阵 — 如果你需要 X,请使用 Y

你需要使用这个不要用这个
视图的状态@State@StateObject
共享状态@Environment 中的 @Observable 类ObservableObject
导航NavigationStack + navigationDestination(for:)NavigationView + NavigationLink(destination:)
多行文本输入TextField(axis: .vertical) + .lineLimit(1...N)TextEditor(除非你需要完整编辑器)
出现时的异步工作.task { } 修饰符onAppear { Task { } }
获取数据使用结构化并发的 async/awaitCombine 发布者或回调
持久化模型SwiftData @ModelCore Data(除非是现有项目)
本地键值存储@AppStorage 或 UserDefaults手动写入 plist
安全存储通过 Security 框架使用钥匙串UserDefaults(永远不要用于密钥)
图片加载AsyncImage 或缓存加载器SwiftUI 中的 UIImage
列表带 ForEach 的 ListScrollView + LazyVStack(除非是自定义)
标签栏带 Tab API 的 TabView.tabItem()(已弃用的模式)
表单呈现带可识别数据的 .sheet(item:)带单独状态的 .sheet(isPresented:)
错误处理Result 或类型化的 throws强制 try
依赖注入带自定义键的 @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.

相关技能