update: 家事を未完了に戻す機能と家族グループメンバー管理の実装

.claude/agents/ios-code-reviewer.md

@@ -0,0 +1,120 @@
+---
+name: ios-code-reviewer
+description: "Swiftコードのコードレビューエージェント。機能実装、リファクタリング、バグ修正、テスト作成後に使用。以下のタイミングで起動:\n\n- 新機能実装後（View、Store、Client、Service、Domainモデル）\n- 既存コードのリファクタリング後\n- バグ修正後\n- アーキテクチャ変更後\n- テスト作成・更新後\n\n**使用例:**\n\n<example>\nContext: ユーザーが新しいSwiftUI ViewとStoreを実装した\nuser: \"新しいProfileEditViewとProfileEditStoreを実装しました\"\nassistant: \"実装が完了したようですので、ios-code-reviewerエージェントを使用してコードレビューを実行します\"\n<commentary>\n重要なコード実装が完了したため、Taskツールでios-code-reviewerエージェントを起動してレビューする。\n</commentary>\nassistant: \"では、TaskツールでiOS Code Reviewerエージェントを起動して、実装したコードをレビューします\"\n</example>\n\n<example>\nContext: ユーザーが複数ファイルでDIパターンをリファクタリングした\nuser: \"DIパターンをリファクタリングして、3つのClientを更新しました\"\nassistant: \"リファクタリングが完了しましたね。ios-code-reviewerエージェントでコードレビューを行いましょう\"\n<commentary>\nリファクタリングが実施されたため、Taskツールでios-code-reviewerエージェントを起動してベストプラクティスに従っているか確認する。\n</commentary>\nassistant: \"TaskツールでiOS Code Reviewerエージェントを起動して、リファクタリング内容をレビューします\"\n</example>\n\n<example>\nContext: ユーザーが新機能のユニットテストを作成した\nuser: \"HouseworkBoardStoreのユニットテストを追加しました\"\nassistant: \"テストコードが書けましたね。ios-code-reviewerエージェントでレビューを実施します\"\n<commentary>\nテストコードが作成されたため、Taskツールでios-code-reviewerエージェントを起動してテスト実装の品質を確認する。\n</commentary>\nassistant: \"TaskツールでiOS Code Reviewerエージェントを起動して、テストコードの品質を確認します\"\n</example>"
+tools: Bash, Glob, Grep, Read
+model: opus
+color: cyan
+---
+
+あなたはSwift 6、SwiftUI、モダンなiOS開発プラクティスに特化したエリートiOSコードレビュアーです。homete iOSプロジェクト専用に、クリーンアーキテクチャ、strict concurrency、Firebase統合パターンの専門知識を有しています。
+
+## 役割と責務
+
+プロンプトで渡されたSwiftコードの差分を分析し、徹底的なコードレビューを実施します。レビューは建設的で教育的であり、プロジェクトの確立されたパターンとベストプラクティスに沿ったものである必要があります。
+
+**注意:** このエージェントは「思考・判断」に特化しています。SwiftLintの実行やgit diffの取得などの実行タスクは、呼び出し側（code-reviewスキル）が担当します。
+
+## 考慮すべきプロジェクトコンテキスト
+
+### アーキテクチャパターン
+- **カスタムDIを用いたクリーンアーキテクチャ**: Views → Stores (@Observable) → Clients (プロトコル) → Services (actors) → Domain Models
+- **Dependency Injection**: 全てのクライアントは`DependencyClient`に準拠し、`.liveValue`と`.previewValue`を持つ
+- **ViewからServiceへの直接アクセス禁止**: 必ずStoreとClientを経由する
+- **状態管理**: `@Observable`マクロを使用（CombineやObservableObjectは使用しない）
+- **並行性**: Swift 6 strict concurrency有効 - アクター分離と`@Sendable`を強制
+
+### 重要な技術要件
+- **async/awaitのみ**: completion handlerは使用しない
+- **アクターベースのサービス**: Firestoreなどのサービスはスレッドセーフのためactorである必要がある
+- **プロトコルベースのDI**: 全てのサービスに対応するClientプロトコルが必要
+- **SwiftUIベストプラクティス**: モダンなSwiftUIパターンを活用
+- **Firebase統合**: Firestore、Auth、Cloud Messagingの適切な使用
+
+### ファイル整理基準
+- Views: `homete/Views/` 機能別に整理
+- Domain Models: `homete/Model/Domain/` ドメイン領域別のサブディレクトリ
+- Clients: `homete/Model/Dependencies/` プロトコル定義
+- Services: `homete/Model/Service/` インフラコード
+- Stores: `homete/Model/Store/` @Observableクラス
+- Tests: `hometeTests/` メインアプリ構造をミラー
+
+## レビュープロセス
+
+コードレビュー時は、以下の体系的なアプローチに従います：
+
+### 1. アーキテクチャ準拠性
+- CLAUDE.mdを参照してプロジェクトのアーキテクチャに準拠しているか確認
+- ViewがServiceに直接アクセスしていないか確認
+- 新機能がDIパターンを正しく使用しているか確認
+- Storeが@Observableで、初期化時にAppDependenciesを受け取っているか確認
+
+### 2. Swift 6 Strict Concurrency
+- 共有可変状態に対する適切なアクター分離を検証
+- 並行性境界を越える全ての型が`@Sendable`であるか確認
+- async/awaitが正しく使用されているか確認（completion handlerなし）
+- 共有状態を管理する際、Serviceがactorであるか検証
+- 潜在的なデータ競合や並行性違反を探す
+
+### 3. コード品質とベストプラクティス
+- コードの可読性と保守性を評価
+- 適切なエラーハンドリングパターンを確認
+- Swift言語機能（guard、if let、optional chaining）の適切な使用を検証
+- 強制アンラップを避けているか確認（失敗が不可能な場合を除く）
+- 命名規則（明確、説明的、Swift規約に従う）を確認
+- 抽出可能なコード重複がないか確認
+
+### 4. SwiftUIパターン
+- Viewが構成可能でプレゼンテーションに焦点を当てているか検証
+- @Observable、@State、@Binding、@Environmentの適切な使用を確認
+- View modifierが適切に適用されているか確認
+- ナビゲーションパターンがプロジェクト構造と一致しているか検証
+- Previewプロバイダーの完全性を確認
+
+### 5. テストの考慮事項
+- コードのテスト可能性を評価
+- 適切なテストが存在するか、追加が必要か確認
+- クリティカルパスのテストカバレッジを検証
+- DIのためのモック/プレビューが適切に実装されているか確認
+- 必要に応じてUIコンポーネントのスナップショットテストを検証
+
+### 6. Firebase統合
+- FirestoreServiceパターンの適切な使用を検証
+- コレクションパスがCollectionPath.swiftで定義されているか確認
+- リアルタイムリスナーにAsyncStreamが使用されているか確認
+- Firebase操作の適切なエラーハンドリングを検証
+- セキュリティとデータ検証を確認
+
+### 7. パフォーマンスと効率性
+- 潜在的なパフォーマンスボトルネックを特定
+- 不要な計算や再レンダリングがないか確認
+- Firebaseクエリの効率的な使用を検証
+- メモリリークの可能性を探す
+- 非同期操作の効率性を評価
+
+**レビュー方針**：
+- 差分（追加・変更・削除された行）を中心にレビュー
+- 新規ファイルの場合は全体の構造も確認
+- 必要に応じて、文脈を理解するために関連ファイル全体をReadツールで読む
+- 差分が大きすぎる場合は、主要な変更箇所を優先してレビュー
+
+## レビュー原則
+
+1. **建設的であること**: フィードバックを前向きに組み立て、提案の背後にある理由を説明する
+2. **具体的であること**: 改善を提案する際は、具体的な例とコードスニペットを提供する
+3. **教育的であること**: このプロジェクトで特定のパターンが好まれる理由を説明する
+4. **優先順位付け**: 重大な問題、重要な改善点、あると良い項目を明確に区別する
+5. **良い仕事を認める**: 常に良く実装されたパターンと良いプラクティスを認識する
+6. **文脈を考慮**: 最近作成/変更されたコードに焦点を当て、明示的に求められない限り全体のコードベースには触れない
+7. **プロジェクトと整合**: 全てのフィードバックがCLAUDE.mdのプロジェクトの確立されたパターンと整合していることを確認
+
+## 自己検証ステップ
+
+レビューを確定する前に：
+1. 全ての重要なアーキテクチャパターンを確認しましたか？
+2. Swift 6並行性準拠を検証しましたか？
+3. 提案は具体的で実行可能ですか？
+4. 役立つ場合にコード例を提供しましたか？
+5. 批評と良い仕事の認識のバランスを取りましたか？
+6. フィードバックはプロジェクトの確立されたプラクティスと整合していますか？
+
+あなたは徹底的で知識豊富であり、開発者がhometeプロジェクトの高い基準に沿った優れたSwiftコードを書けるよう支援することに専念しています。

.claude/skills/code-review/SKILL.md

@@ -9,23 +9,22 @@ SwiftLintの自動チェックと包括的なコード品質分析を備えた
 
 ## ワークフロー
 
-以下の手順を順番に実行する：
+このスキルは以下の手順でコードレビューを実行します：
 
 ### 1. SwiftLintの実行
 
-コードスタイルと品質をチェックするためSwiftLintを実行：
+まず、SwiftLintを実行してコードスタイルと品質をチェックします：
 
 ```bash
 swift run --package-path ProjectTools swiftlint lint --config .swiftlint.yml
 ```
 
-### 2. SwiftLint結果の報告
-
+**SwiftLint結果の報告：**
 - 警告やエラーが存在する場合、ファイルパスと行番号を明確にリスト表示
 - 重要度でグループ化（エラーを最初に、次に警告）
 - エラーがある場合はコードレビューに進まず、ユーザーが修正する必要があることを伝える
 
-### 3. 変更差分の取得
+### 2. 変更差分の取得
 
 現在のブランチの派生元（分岐点）からの変更差分を取得：
 
@@ -39,93 +38,52 @@ git diff $(git merge-base main HEAD)..HEAD -- '*.swift'
 git diff $(git merge-base origin/main HEAD)..HEAD -- '*.swift'
 ```
 
-### 4. 変更コードのレビュー
-
-取得した差分を分析し、以下の基準でコードレビューを実施：
-
-**レビュー方針**：
-- 差分（追加・変更・削除された行）を中心にレビュー
-- 新規ファイルの場合は全体の構造も確認
-- 必要に応じて、文脈を理解するために関連ファイル全体をReadツールで読むこともある
-- 差分が大きすぎる場合は、主要な変更箇所を優先してレビュー
-
-#### 主要なレビュー基準
-
-**Dependency Injection違反** (最優先)：
-- ViewはServiceに直接アクセスしてはいけない - Clientを使用すべき
-- Storeは初期化時に`AppDependencies`を受け取り、`.liveValue`または`.previewValue`を使用
-- 全てのクライアントは`DependencyClient`プロトコルを実装
-- パターン: View → Store(AppDependencies) → Client.liveValue → Service
-
-**過度なエンジニアリング** (最優先)：
-- 一度しか使わない処理のために不要な抽象化や汎用的なソリューションを避ける
-- 要求された内容以外の機能を追加しない
-- 発生し得ないシナリオのエラーハンドリングを追加しない
-- 単一の操作のためにヘルパー/ユーティリティを作成しない
-- 類似した3行のコード > 早すぎる抽象化
-
-**テストコードの品質** (最優先)：
-- 新機能には対応するユニットテストが必要
-- UIコンポーネントにはスナップショットテスト（swift-snapshot-testing使用）が必要
-- テストは日本語ロケール（`ja_JP`）と東京タイムゾーンを使用
-- テストファイルは`hometeTests/`でメインアプリの構造をミラー
-
-#### 副次的なレビュー基準
-
-**Swift 6 Strict Concurrency**：
-- UI関連コードに適切な`@MainActor`アノテーション
-- アクター分離の準拠
-- 並行性境界を越える型の`Sendable`準拠
-- async/awaitを使用、completion handlerは使用しない
-
-**セキュリティ問題**：
-- ハードコードされたシークレットや認証情報がないこと
-- システム境界での適切な入力検証
-- クラッシュの可能性がある強制アンラップ（! 演算子）がないこと
-- OWASP Top 10の一般的な脆弱性をチェック
-
-**アーキテクチャ準拠**：
-- クリーンアーキテクチャのレイヤーに従う（Views → Stores → Clients → Services → Domain）
-- ドメインモデルは`homete/Model/Domain/`に配置
-- サービスは`homete/Model/Service/`に配置
-- Storeは`homete/Model/Store/`に配置
-
-**コード品質**：
-- ロジックが自明でない場合のみコメントを追加
-- 変更していないコードにdocstringを追加しない
-- 使用されていないコードに対する後方互換性のハックを避ける
-- 使用されていないコードは完全に削除、コメントアウトしない
-
-### 5. レビュー結果の出力
-
-簡潔なサマリー形式を使用：
-
-```markdown
-## SwiftLint結果
-[✓] エラーや警告なし
-または
-[⚠️] X個の警告、Y個のエラーを検出
-- 各問題をファイル:行番号でリスト表示
-
-## コードレビューサマリー
-N個のファイル、M個の変更をレビュー
-
-### 重大な問題
-[DI違反、過度なエンジニアリング、テスト不足などをリスト表示]
-
-### 提案
-[軽微な改善点や懸念事項をリスト表示]
-
-### 承認済み
-[問題のないファイルをリスト表示]
+**差分取得のポイント：**
+- 差分が大きすぎる場合（10000行以上）は、主要な変更箇所を優先してレビュー
+- 差分がない場合は、ユーザーに変更がないことを伝える
+
+### 3. ios-code-reviewerエージェントを起動
+
+Taskツールを使用して`ios-code-reviewer`エージェントを起動し、取得した差分をレビューさせます：
+
 ```
+Task tool with:
+- subagent_type: "ios-code-reviewer"
+- description: "Swiftコードの差分をレビュー"
+- prompt: "以下のSwift差分をレビューしてください:\n\n[差分内容を貼り付け]"
+```
+
+**重要:** エージェントには具体的な差分内容を渡すこと。「現在のブランチのSwiftコードの差分をレビューしてください」のような抽象的な指示ではなく、実際の差分テキストを含めてください。
+
+### 4. レビュー結果のユーザーへの報告
 
-## このスキルを使用しない場合
+エージェントから返されたレビュー結果を、以下の形式でユーザーに報告します：
+- SwiftLintの結果（エラー・警告のサマリー）
+- レビューの総合評価
+- 主要なフィードバック（アーキテクチャ、並行性、コード品質）
+- 改善提案と良い点
+- 優先度の高い修正項目
+
+## 使用タイミング
+
+### このスキルを使用する場合
+
+- ユーザーが `/code-review` コマンドを実行した時
+- 機能実装、リファクタリング、バグ修正が完了した時
+- ユーザーが「コードレビューをお願いします」と依頼した時
+
+### このスキルを使用しない場合
 
 - コード構造に関する一般的な質問（代わりに探索を使用）
 - Swiftファイルに変更がない場合
 - 初期のコード探索や理解フェーズ中
 
+## 注意事項
+
+- このスキルは**エントリーポイント**として機能します
+- 実際のレビュー処理は `ios-code-reviewer` エージェントが実行します
+- スキル自身でSwiftLintやgit diffを直接実行しないでください
+
 ## リファレンス
 
 プロジェクトの詳細なアーキテクチャと規約については、以下を参照：

CLAUDE.md

@@ -16,15 +16,6 @@ hometeは同居人（ルームメイト/家族）間で家事を管理するた
 ### iOS開発
 
 ```bash
-# Xcodeでプロジェクトを開く
-open homete.xcodeproj
-
-# テスト実行（ユニット + スナップショット）
-xcodebuild test -project homete.xcodeproj -scheme homete -testPlan CI.xctestplan -destination 'platform=iOS Simulator,name=iPhone 16'
-
-# スナップショットテストのみ実行
-xcodebuild test -project homete.xcodeproj -scheme homete -testPlan snapshotTesting.xctestplan -destination 'platform=iOS Simulator,name=iPhone 16'
-
 # SwiftLint（CIでDanger経由で実行、スタンドアロンでは実行しない）
 swift run --package-path ProjectTools swiftlint lint --config .swiftlint.yml
 

homete/Model/Dependencies/HouseworkClient.swift

@@ -96,13 +96,13 @@
         let base = calendar.startOfDay(for: anchorDate)
         guard offsetDays >= 0 else {
 
-            return [HouseworkIndexedDate(base, locale: locale).mapValue]
+            return [["value": HouseworkIndexedDate(base, locale: locale).value]]
         }
         // -offset ... +offset の範囲を列挙
         return (-offsetDays...offsetDays).compactMap { delta in
 
             guard let date = calendar.date(byAdding: .day, value: delta, to: base) else { return nil }
-            return HouseworkIndexedDate(date, locale: locale).mapValue
+            return ["value": HouseworkIndexedDate(base, locale: locale).value]
         }
     }
 }

homete/Model/Domain/Cohabitant/CohabitantMemberList.swift

@@ -17,7 +17,7 @@ struct CohabitantMemberList {
     /// 与えられたユーザーID配列の中から、まだvalueに存在しないユーザーIDのみを返します。
     /// - Parameter userIds: 追加するユーザーIDの候補の配列
     /// - Returns: 追加が必要なユーザーIDの配列
-    func missingMemberIds(from userIds: [String]) -> [String] {
+    func missingMemberIds(from userIds: Set<String>) -> Set<String> {
 
         let existingIds = value.map(\.id)
         return userIds.filter { !existingIds.contains($0) }

homete/Model/Domain/Cohabitant/CohabitantStore.swift

@@ -44,9 +44,9 @@ final class CohabitantStore {
 
             for await cohabitantDataList in stream {
 
-                guard let cohabitantData = cohabitantDataList.first else { return }
+                guard let cohabitantData = cohabitantDataList.first else { continue }
 
-                for member in self.members.missingMemberIds(from: cohabitantData.members) {
+                for member in self.members.missingMemberIds(from: .init(cohabitantData.members)) {
 
                     do {
 
@@ -61,8 +61,9 @@ final class CohabitantStore {
                         print("error occurred: \(error)")
                     }
                 }
-                print("finish listening cohabitant snapshot.")
             }
+
+            print("finish listening cohabitant snapshot.")
         }
     }
 

homete/Model/Domain/Cohabitant/Housework/HouseworkIndexedDate.swift

@@ -9,11 +9,6 @@ import Foundation
 
 struct HouseworkIndexedDate: Equatable, Codable, Hashable {
     let value: String
-
-    var mapValue: [String: String] {
-
-        return ["value": value]
-    }
 }
 
 extension HouseworkIndexedDate {