Initial commit

commands/complete-task.md

@@ -0,0 +1,185 @@
+---
+description: タスクを完了としてマークする
+argument-hint: [タスクID] [完了コメント（オプション）]
+---
+
+# タスクの完了
+
+指定したタスクを完了としてマークし、進捗を更新します。
+
+## 引数
+$ARGUMENTS
+
+## 想定される引数形式
+
+```
+/complete-task 5
+/complete-task 5 ユーザーモデルのテストも完了
+/complete-task 3
+```
+
+## 処理手順
+
+### 1. 引数のパース
+
+引数から以下を抽出します：
+- **タスクID**: 数値（必須）
+- **完了コメント**: 追加のメモ（オプション）
+
+### 2. タスクファイルの読み込み
+
+`.tasks.json` ファイルを読み込み、指定されたIDのタスクを検索します。
+
+### 3. バリデーション
+
+以下をチェックします：
+- タスクIDが存在するか
+- タスクがすでに完了していないか
+- 依存関係が解決されているか（このタスクの依存タスクがすべて完了しているか）
+
+### 4. 完了処理
+
+タスクの状態を `completed` に更新し、以下の情報を記録します：
+- `status`: "completed"
+- `completedAt`: 完了日時
+- `completionNote`: 完了コメント（提供されている場合）
+- `actualHours`: 実際の作業時間（可能であれば startedAt から計算）
+
+### 5. 進捗の再計算
+
+全体の進捗率と残り時間を再計算します。
+
+### 6. 依存タスクの通知
+
+このタスクに依存している他のタスクがある場合、それらが開始可能になったことを通知します。
+
+## 出力例
+
+### 成功時（基本）
+
+```
+✅ タスク #5 を完了しました
+
+タスク: ユーザーモデルの作成
+完了日時: 2025-10-12 16:30
+作業時間: 2.0時間（推定: 2時間）
+
+## 進捗更新
+- 完了: 3/7 (43%)
+- 推定残り時間: 7時間
+
+## 次に取り組めるタスク
+✅ #6: 認証APIエンドポイントの実装
+   （依存関係が解決されました）
+```
+
+### 成功時（コメント付き）
+
+```
+✅ タスク #5 を完了しました
+
+タスク: ユーザーモデルの作成
+完了日時: 2025-10-12 16:30
+作業時間: 2.5時間（推定: 2時間）
+コメント: ユーザーモデルのテストも完了
+
+## 進捗更新
+- 完了: 3/7 (43%)
+- 推定残り時間: 7時間
+
+## 次に取り組めるタスク
+✅ #6: 認証APIエンドポイントの実装
+✅ #8: フロントエンドフォームの作成
+```
+
+### ワークフロータスク完了時
+
+```
+✅ タスク #3 を完了しました
+
+タスク: テスト作成 (/create-tests)
+完了日時: 2025-10-12 17:00
+
+## ワークフロー進捗
+✅ 1. 要件整理
+✅ 2. ドキュメント作成
+✅ 3. テスト作成
+⬜ 4. 実装
+
+## 次のステップ
+`/implement` を実行して実装を開始
+```
+
+### 全タスク完了時
+
+```
+✅ すべてのタスクが完了しました
+
+機能: ユーザー認証機能
+開始: 2025-10-12 10:00
+完了: 2025-10-12 18:00
+総作業時間: 8時間（推定: 9時間）
+
+## 完了したタスク
+✅ 1. 要件整理
+✅ 2. ドキュメント作成
+✅ 3. テスト作成
+✅ 4. 実装
+✅ 5. ユーザーモデルの作成
+✅ 6. 認証APIエンドポイントの実装
+✅ 7. フロントエンドフォームの作成
+
+## 推奨される次のアクション
+1. コードレビューを依頼
+2. 統合テストを実行
+3. ステージング環境にデプロイ
+4. ドキュメントを最終確認
+```
+
+### エラー時（依存関係未解決）
+
+```
+⚠️  タスクを完了できません
+
+タスク: #6 認証APIエンドポイントの実装
+理由: 依存タスクが未完了です
+
+未完了の依存タスク:
+- #5: ユーザーモデルの作成 (状態: in_progress)
+
+推奨:
+先に #5 を完了させてから、再度 `/complete-task 6` を実行してください。
+```
+
+### エラー時（タスクが見つからない）
+
+```
+❌ タスクの完了に失敗しました
+
+原因: タスク #99 が見つかりません
+
+利用可能なタスクID: 1, 2, 3, 4, 5, 6, 7
+タスク一覧を確認: `/list-tasks`
+```
+
+### エラー時（既に完了済み）
+
+```
+ℹ️  タスクは既に完了しています
+
+タスク: #5 ユーザーモデルの作成
+完了日時: 2025-10-12 16:30
+
+他の未完了タスク:
+- #6: 認証APIエンドポイントの実装
+- #7: フロントエンドフォームの作成
+
+タスク一覧: `/list-tasks`
+```
+
+## 次のステップ
+
+完了状況に応じて以下を提案：
+- 次に取り組むべきタスクを提示
+- ワークフローの次のステップを案内
+- すべて完了した場合は、次のアクション（レビュー、デプロイなど）を提案