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