Name: swiftui-ssot
Author: xtone

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

SwiftUI SSOT (Single Source of Truth)

SwiftUIにおける状態管理とSSOT原則の包括的ガイド。

ディレクトリ構成

swiftui-ssot/
├── SKILL.md (このファイル)
└── references/
    └── ssot.md

リファレンスファイル

references/ssot.md

Single Source of Truth（SSOT）の包括的ガイド：

SSOTの3つの柱: 唯一の情報源、導出状態、単方向データフロー
Property Wrapper選択フローチャート: @State/@Binding/@StateObject/@ObservedObject/@EnvironmentObject
パターン別ガイド:
- 状態重複の解消
- 導出状態（Computed Property）
- State Lifting（状態の持ち上げ）
- 兄弟View間通信
- EnvironmentObjectの適切な使用
違反検出方法: コードスメル、検索パターン
iOS 17+ @ObservableでのSSO実装
レビューチェックリスト

使用方法

状態設計時

references/ssot.mdのProperty Wrapper選択フローチャートを参照
データの所有者を明確化
導出可能な状態は持たない

状態関連の問題発生時

references/ssot.mdの違反パターンを確認
該当するパターンの解決策を適用

PRレビュー時

references/ssot.mdのレビューチェックリストを使用

SSOT 3つの柱

唯一の情報源: 各データは1箇所でのみ管理
導出状態: 他の状態から計算可能なものは持たない
単方向データフロー: 親→子へデータを渡し、子→親へはアクション

Property Wrapper 選択ガイド

状況	推奨
View内のローカル状態	`@State`
親から受け取る値（読み書き）	`@Binding`
Viewが所有するObservableObject	`@StateObject`
外部から注入されるObservableObject	`@ObservedObject`
アプリ全体で共有	`@EnvironmentObject`
iOS 17+	`@Observable` + `@Bindable`

関連スキル

swiftui-coding-guidelines: 基本的なベストプラクティス
swift-ios-migration: iOS 17 @Observable移行

Install swiftui-ssot 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-ssot", "kind": "skill", "name": "swiftui-ssot", "description": "Single Source of Truth (SSOT) guidelines for SwiftUI state management. Use when designing state architecture, choosing between @State/@Binding/@StateObject/@ObservedObject/@EnvironmentObject, fixing state synchronization issues, refactoring duplicated state, or reviewing state management in PRs. Covers SSOT principles, property wrapper selection, state lifting, and common violations.", "publisher": "xtone", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Single Source of Truth (SSOT) guidelines for SwiftUI state management. Use when designing state architecture, choosing between @State/@Binding/@StateObject/@ObservedObject/@EnvironmentObject, fixing state synchronization issues, refactoring duplicated state, or reviewing state management in PRs. Covers SSOT principles, property wrapper selection, state lifting, and common violations." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/xtone/ai_development_tools", "path": "ios_development/skills/swiftui-ssot/SKILL.md", "ref": "HEAD", "url": "https://github.com/xtone/ai_development_tools/blob/HEAD/ios_development/skills/swiftui-ssot/SKILL.md", "key": "xtone/ai_development_tools/ios_development/skills/swiftui-ssot/SKILL.md" } }, "instructions": "# SwiftUI SSOT (Single Source of Truth)\n\nSwiftUIにおける状態管理とSSOT原則の包括的ガイド。\n\n## ディレクトリ構成\n\n```\nswiftui-ssot/\n├── SKILL.md (このファイル)\n└── references/\n └── ssot.md\n```\n\n## リファレンスファイル\n\n### references/ssot.md\nSingle Source of Truth（SSOT）の包括的ガイド：\n- **SSOTの3つの柱**: 唯一の情報源、導出状態、単方向データフロー\n- **Property Wrapper選択フローチャート**: @State/@Binding/@StateObject/@ObservedObject/@EnvironmentObject\n- **パターン別ガイド**:\n - 状態重複の解消\n - 導出状態（Computed Property）\n - State Lifting（状態の持ち上げ）\n - 兄弟View間通信\n - EnvironmentObjectの適切な使用\n- **違反検出方法**: コードスメル、検索パターン\n- **iOS 17+ @ObservableでのSSO実装**\n- **レビューチェックリスト**\n\n## 使用方法\n\n### 状態設計時\n1.", "cost": { "context_tokens": 328 } }

swiftui-ssot

About