Swift Architecture Skill

Overview

このスキルを使用して、SwiftUI/UIKit コードベースに最適な Swift アーキテクチャプレイブックを選定し、ユーザーのタスクに適用します。

Workflow

Step 1: リクエストコンテキストを分析する

アーキテクチャを選定する前に、以下を把握します:

• タスクタイプ (新機能追加、リファクタリング、PR レビュー、デバッグ)
• UI スタック (SwiftUI, UIKit, またはその混在)
• スコープ (単一画面、複数画面、アプリ全体)
• 保持すべき既存の慣例

Step 2: アーキテクチャを選定する

ユーザーが明示的にアーキテクチャを指定した場合、コミット前に初期候補としてフィットチェックを実行します:

• UI スタックの適合性 (SwiftUI/UIKit/混在)、状態の複雑さ、エフェクト編成の必要性、チーム熟知度、既存コードベースの慣例に対して検証
• 適合する場合、指定されたアーキテクチャで進める
• 主要な制約と不一致がある場合、その不一致を明示的に説明し、references/selection-guide.md から最も適合する代替案を推奨
• ユーザーが不一致なアーキテクチャを引き続き希望する場合、リスク軽減計画を進め、リスクを事前に明記

アーキテクチャが指定されない場合、references/selection-guide.md を読み込み、指定された制約 (状態の複雑さ、チーム熟知度、テスト目標、エフェクト編成の必要性、フレームワーク選好) から最適なフィットを推論します。推奨理由を簡潔に説明します。

アーキテクチャリファレンスマッピング:

• MVVM → references/mvvm.md
• MVI → references/mvi.md
• TCA → references/tca.md
• Clean Architecture → references/clean-architecture.md
• VIPER → references/viper.md
• Reactive → references/reactive.md
• MVP → references/mvp.md
• Coordinator → references/coordinator.md

Step 3: 既存コードベースを分析する (該当する場合)

コードが既に存在する場合:

• 現在のアーキテクチャと DI スタイルを検出
• 並行処理モデル (async/await, Combine, GCD, 混在) を記録
• ローカル慣例に推奨事項を合わせる

Step 4: 具体的な成果物を生成する

選定したアーキテクチャリファレンスを読み込み、その指針をユーザーのリクエストに合わせた成果物に変換します:

• ファイルとモジュール構造: 機能に固有のファイル名を含むディレクトリレイアウト
• 状態と依存関係の境界: 具体的な型、プロトコル、インジェクションポイント
• 非同期戦略: キャンセル、アクター分離、エラーパス
• テスト戦略: テスト対象、依存関係のスタブ方法、テスト構造の例
• マイグレーションパス (リファクタリング用): 現在のアーキテクチャからターゲットアーキテクチャへの段階的なステップ
• UI スタック適応: 選定したアーキテクチャの SwiftUI と UIKit のガイダンスが異なるべき場所

Step 5: チェックリストで検証する

リファレンスファイルのアーキテクチャ固有の PR レビューチェックリストで終了し、ユーザーの機能に適応させます。

Output Requirements

• 推奨事項をリクエストされた機能またはレビュータスクの範囲内に保つ
• プロトコルベースの依存性注入と明示的な状態モデリングを優先
• 既存コードで見つかったアンチパターンをフラグし、直接的な修正を提供
• すべての非同期フローにキャンセルとエラーハンドリングを含める
• 明示的なアーキテクチャリクエストの場合、短いフィット結果 (fit または mismatch) を理由 1～2 個とともに含める
• 不一致ケースの場合、最も適合する代替案 1 つと、その理由を指定された制約より明確に含める
• コードを記述する場合、タスクに関連するパターンのみを含める — プレイブック全体をダンプしない
• リファレンススニペットをデフォルトで説明的なものとして扱う；実行可能なコードが必要な場合のみ、完全なコンパイルスキャフォルディングを追加
• 最小限のブロッキング質問のみを尋ねる；それ以外は事前に明記した明示的な前提で進める
• PR をレビューする場合、アーキテクチャ固有のチェックリストを使用し、特定の違反を行レベルの修正で指摘する