Name: swiftui-coding-guidelines
Author: xtone

Imported from xtone/ai_development_tools (ios_development/skills/swiftui-coding-guidelines/SKILL.md). Install upstream with npx skills add xtone/ai_development_tools --skill swiftui-coding-guidelines. Copyright stays with the author.

SwiftUI Coding Guidelines

SwiftUIの日常的な開発で参照するコアガイドライン。

ディレクトリ構成

swiftui-coding-guidelines/
├── SKILL.md (このファイル)
└── references/
    ├── best-practices.md      # ベストプラクティス
    ├── patterns-list.md       # 1-x: リスト・データ表示系
    ├── patterns-navigation.md # 2-x: ナビゲーション・画面遷移系
    ├── patterns-forms.md      # 3-x: フォーム・入力系
    ├── patterns-views.md      # 4-x: View構築・レイアウト系
    └── anti-patterns.md       # アンチパターン

リファレンスファイル

references/best-practices.md

SwiftUIのベストプラクティス集：

状態管理: プロパティラッパー（@State、@Binding、@StateObject等）
パフォーマンス最適化: View構造、LazyスタックとGrid、Equatable
コンポーネント設計: 責務分離、Root Views vs Content Views、ViewModifier
非同期処理: .taskモディファイア、async/await、@MainActor
ナビゲーション: NavigationStack（iOS 16+）、型安全ルーティング
Layoutプロトコル: GeometryReaderの代替（iOS 16+）
Preview駆動開発: 複数状態プレビュー

references/patterns-list.md（1-x: リスト・データ表示系）

番号	パターン
1-1	無限スクロール（Pagination）
1-2	プルトゥリフレッシュ
1-3	フィルタリング・ソート
1-4	スワイプアクション
1-5	コンテキストメニュー

references/patterns-navigation.md（2-x: ナビゲーション・画面遷移系）

番号	パターン
2-1	タブビュー
2-2	ナビゲーション（NavigationStack）
2-3	モーダル表示（Sheet / FullScreenCover）
2-4	アラート・ダイアログ

references/patterns-forms.md（3-x: フォーム・入力系）

番号	パターン
3-1	検索機能（デバウンス付き）
3-2	フォーム入力（バリデーション付き）
3-3	認証画面（ログイン / 新規登録 / OTP）

references/patterns-views.md（4-x: View構築・レイアウト系）

番号	パターン
4-1	AsyncImage（キャッシュ付き）
4-2	空状態・エラー状態
4-3	アニメーション
4-4	View重なり（ZStack / overlay / background）
4-5	ContentUnavailableView（iOS 17+）

references/anti-patterns.md

アンチパターンと解決策：

状態管理、パフォーマンス、ビジネスロジック
非同期処理、ナビゲーション、メモリ管理
ViewのIdentity: 不安定なID、ForEachでのインデックス使用
AnyView: 型消去によるパフォーマンス低下
コンポーネント設計: スペーシング管理、opacity vs if文

使用方法

新規実装時

該当するpatterns-*.mdで実装パターン確認
best-practices.mdで関連ベストプラクティス確認
anti-patterns.mdで避けるべきパターン確認

問題解決時

anti-patterns.mdで該当パターン検索
best-practices.mdで推奨実装確認

重要な原則

状態の最小化: 導出可能な状態は持たない
責務の分離: Root Views（ロジック）とContent Views（UI）を分離
パフォーマンス: Lazy、Equatable、非同期処理の適切な使用
ViewのIdentity: 安定したIDを使用、ForEachでインデックス禁止
スペーシングは親が管理: 子コンポーネントはpaddingでスペースを作らない

関連スキル

swiftui-ssot: 状態管理（SSOT）の詳細設計
swiftui-code-review-checklist: PRレビュー用チェックリスト
swift-ios-migration: iOS 17/18、Swift 6移行
swiftui-accessibility: アクセシビリティ対応

Install swiftui-coding-guidelines and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xtone-ai-development-tools-swiftui-coding-guidelines", "kind": "skill", "name": "swiftui-coding-guidelines", "description": "Core coding guidelines for iOS, iPadOS, macOS, watchOS, tvOS, and visionOS app development using SwiftUI and Swift. Use when implementing Views, working with @State/@Binding/@Observable/@StateObject, using NavigationStack/List/LazyVStack, designing components, or asking about SwiftUI patterns (infinite scroll, pull-to-refresh, search). Covers best practices, implementation patterns, and anti-patterns to avoid.", "publisher": "xtone", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Core coding guidelines for iOS, iPadOS, macOS, watchOS, tvOS, and visionOS app development using SwiftUI and Swift. Use when implementing Views, working with @State/@Binding/@Observable/@StateObject, using NavigationStack/List/LazyVStack, designing components, or asking about SwiftUI patterns (infinite scroll, pull-to-refresh, search). Covers best practices, implementation patterns, and anti-patterns to avoid." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/xtone/ai_development_tools", "path": "ios_development/skills/swiftui-coding-guidelines/SKILL.md", "ref": "HEAD", "url": "https://github.com/xtone/ai_development_tools/blob/HEAD/ios_development/skills/swiftui-coding-guidelines/SKILL.md", "key": "xtone/ai_development_tools/ios_development/skills/swiftui-coding-guidelines/SKILL.md" } }, "instructions": "# SwiftUI Coding Guidelines\n\nSwiftUIの日常的な開発で参照するコアガイドライン。\n\n## ディレクトリ構成\n\n```\nswiftui-coding-guidelines/\n├── SKILL.md (このファイル)\n└── references/\n ├── best-practices.md # ベストプラクティス\n ├── patterns-list.md # 1-x: リスト・データ表示系\n ├── patterns-navigation.md # 2-x: ナビゲーション・画面遷移系\n ├── patterns-forms.md # 3-x: フォーム・入力系\n ├── patterns-views.md # 4-x: View構築・レイアウト系\n └── anti-patterns.md # アンチパターン\n```\n\n## リファレンスファイル\n\n### references/best-practices.md\nSwiftUIのベストプラクティス集：\n- **状態管理**: プロパティラッパー（@State、@Binding、@StateObject等）\n- **パフォーマンス最適化**: View構造、LazyスタックとGrid、Equatable\n", "cost": { "context_tokens": 615 } }

swiftui-coding-guidelines

About