---
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`
```

## 次のステップ

完了状況に応じて以下を提案：
- 次に取り組むべきタスクを提示
- ワークフローの次のステップを案内
- すべて完了した場合は、次のアクション（レビュー、デプロイなど）を提案