AgentSkillsCN

solid-swift

Swift 6 和 SwiftUI（iOS 26+）的 SOLID 原则。文件不超过 100 行、协议分离、@Observable、actors、Preview 驱动开发。模块化为强制要求。

SKILL.md
--- frontmatter
name: solid-swift
description: SOLID principles for Swift 6 and SwiftUI (iOS 26+). Files < 100 lines, protocols separated, @Observable, actors, Preview-driven development. Features Modular MANDATORY.
versions:
  swift: "6.2"
  ios: "26"
user-invocable: true
references: references/solid-principles.md, references/single-responsibility.md, references/open-closed.md, references/liskov-substitution.md, references/interface-segregation.md, references/dependency-inversion.md, references/concurrency-patterns.md, references/anti-patterns.md, references/templates/view.md, references/templates/viewmodel.md, references/templates/service.md, references/templates/protocol.md, references/templates/model.md
related-skills: swift-core, swiftui-core, ios, macos, ipados, watchos, visionos, tvos

SOLID Swift - Apple Best Practices 2026

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

  1. •fuse-ai-pilot:explore-codebase - Analyze existing architecture
  2. •fuse-ai-pilot:research-expert - Verify Swift/Apple docs via Apple Docs MCP + Context7
  3. •XcodeBuildMCP - Build validation after code changes. Then run fuse-ai-pilot:sniper.

DRY - Reuse Before Creating (MANDATORY)

Before writing ANY new code:

  1. •Grep the codebase for similar protocols, services, or logic
  2. •Check shared locations: Core/Extensions/, Core/Utilities/, Core/Protocols/
  3. •If similar code exists -> extend/reuse instead of duplicate
  4. •If code will be used by 2+ features -> create it in Core/ directly

Architecture (Features Modular MANDATORY)

LayerLocationMax Lines
ViewsFeatures/[Feature]/Views/80
ViewModelsFeatures/[Feature]/ViewModels/100
ServicesFeatures/[Feature]/Services/100
ProtocolsFeatures/[Feature]/Protocols/30
SharedCore/{Models,Protocols,Services,Extensions,Utilities}/-

NEVER use flat Sources/ structure - always Features/[Feature]/

Critical Rules (MANDATORY)

RuleValue
File limit100 lines (split at 90)
ViewModels@MainActor @Observable
ProtocolsFeatures/[Feature]/Protocols/ or Core/Protocols/ ONLY
ModelsSendable structs
Documentation/// on all public APIs
PreviewsEvery View MUST have #Preview

Reference Guide

Concepts

TopicReferenceWhen to consult
SOLID Overviewsolid-principles.mdQuick reference all principles
SRPsingle-responsibility.mdFat views/VMs, splitting files
OCPopen-closed.mdAdding providers, extensibility
LSPliskov-substitution.mdProtocol contracts, testing
ISPinterface-segregation.mdFat protocols, splitting
DIPdependency-inversion.mdInjection, testing, mocking
Concurrencyconcurrency-patterns.mdActors, @MainActor, Sendable
Anti-Patternsanti-patterns.mdCode smells detection

Templates

TemplateWhen to use
view.mdSwiftUI View with subviews and #Preview
viewmodel.md@Observable ViewModel with @MainActor
service.mdAPI Service, Mock, Cache actor
protocol.mdService protocol, CQRS, Auth
model.mdModel, DTO, Error, Enum

Forbidden

Anti-PatternFix
Files > 100 linesSplit at 90
Protocols in impl filesMove to Protocols/ directory
ObservableObjectUse @Observable
Completion handlersUse async/await
Missing #PreviewAdd preview for every View
Non-Sendable in asyncUse struct with let
Flat Sources/ structureUse Features/[Feature]/