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