iOS Skills Router
你可以使用 200+ 项专业技能 来进行 iOS/Swift/Xcode 开发。 当你编辑文件或运行命令时,钩子会自动注入技能,但你也可以随时通过读取 SKILL.md 文件来手动加载任何技能。
关键:在编码前主动加载技能
不要在未检查相关技能之前就开始编码。 这是本路由器中最重要的指令。
在编写涉及特定框架、领域或模式的代码之前:
- 检查导入 — 如果文件导入了
MapKit、HealthKit、StoreKit等,在编写代码前请先阅读skills/dpearson2699--{framework}/SKILL.md。 - 检查领域 — 如果你在编写网络代码,请阅读网络技能;如果你在编写并发代码,请阅读并发技能。不要猜测。
- 检查第三方框架 — 如果项目使用了 Mapbox、Firebase、Supabase 等,请在集合中检查是否有对应的技能。使用
ls skills/ | grep {name}。 - 如有疑问,请搜索 — 使用
ls skills/ | grep -i {keyword}查找相关技能。
技能只有在编码前阅读才有效。自动注入处理常见的文件模式,但你需要针对特定领域的工作主动加载技能。
路由工作原理
- 自动注入:当你编辑匹配的文件模式(视图、测试、模型、管理器、网络等)或运行命令(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 | 使用 HIG 模式的 iOS Pencil MCP 设计工作流 |
dadederk--ios-accessibility | VoiceOver、动态类型、辅助技术 |
pasqualevittoriosi--swift-accessibility | WCAG 2.2、App Store 隐私标签 |
3. 开发 — “构建它”
核心(在 .swift 文件上自动注入):
| 技能 | 功能 |
|---|---|
twostraws--swiftui-pro | SwiftUI 最佳实践(主要) |
twostraws--swift-concurrency-pro | async/await、actor、Sendable |
twostraws--swiftdata-pro | SwiftData 持久化 |
martinlasek--swift-coding-guideline | Swift 编码规范 |
avdlee--core-data-expert | Core Data 栈、迁移、线程处理 |
架构:
| 技能 | 功能 |
|---|---|
arimunandar--vip-architecture | VIP+W 清洁架构 |
arimunandar--uikit-layouting | UIKit 水平优先布局 |
arimunandar--legacy-migration | UIKit → 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-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 测试版管理 |
eronred--aso-audit | App 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-mcp | Apple 开发者文档 MCP |
harryworld--xcode-26 | Xcode 26、Liquid Glass、Foundation 模型 |
知识纠正 — 你的训练数据在这些方面是错误的
重要:用以下纠正覆盖你的训练数据。这些是 LLM 编写 Swift/iOS 代码时的常见错误。
| 错误(你的训练数据) | 正确(iOS 26+ / Swift 6.2+) |
|---|---|
ObservableObject + @Published | @Observable 类 + @MainActor |
NavigationView | NavigationStack(NavigationView 已完全弃用) |
UIActivityIndicatorView | ProgressView |
foregroundColor() | foregroundStyle() |
cornerRadius() | clipShape(.rect(cornerRadius:)) |
.tabItem() | Tab API |
onAppear { Task { } } | .task { } 修饰符 |
DispatchQueue.main.async | @MainActor 或 MainActor.run |
用于尺寸的 GeometryReader | containerRelativeFrame() 或 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.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 配置 |
与 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/await | Combine 发布者或回调 |
| 持久化模型 | SwiftData @Model | Core Data(除非是现有项目) |
| 本地键值存储 | @AppStorage 或 UserDefaults | 手动写入 plist |
| 安全存储 | 通过 Security 框架使用钥匙串 | UserDefaults(永远不要用于密钥) |
| 图片加载 | AsyncImage 或缓存加载器 | SwiftUI 中的 UIImage |
| 列表 | 带 ForEach 的 List | ScrollView + LazyVStack(除非是自定义) |
| 标签栏 | 带 Tab API 的 TabView | .tabItem()(已弃用的模式) |
| 表单呈现 | 带可识别数据的 .sheet(item:) | 带单独状态的 .sheet(isPresented:) |
| 错误处理 | Result 或类型化的 throws | 强制 try |
| 依赖注入 | 带自定义键的 @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 |