119 lines
3.1 KiB
Markdown
119 lines
3.1 KiB
Markdown
---
|
||
description: タスクの状態を更新する
|
||
argument-hint: [タスクID] [新しい状態] [理由（オプション）]
|
||
---
|
||
|
||
# タスク状態の更新
|
||
|
||
指定したタスクの状態を更新します。
|
||
|
||
## 引数
|
||
$ARGUMENTS
|
||
|
||
## 想定される引数形式
|
||
|
||
```
|
||
/update-task 5 in_progress
|
||
/update-task 7 blocked データベーススキーマの確認待ち
|
||
/update-task 3 pending
|
||
```
|
||
|
||
## 状態の種類
|
||
|
||
- `pending`: 未着手
|
||
- `in_progress`: 作業中
|
||
- `completed`: 完了（`/complete-task` の使用を推奨）
|
||
- `blocked`: ブロック中（理由を記載してください）
|
||
|
||
## 処理手順
|
||
|
||
### 1. 引数のパース
|
||
|
||
引数から以下を抽出します：
|
||
- **タスクID**: 数値
|
||
- **新しい状態**: pending, in_progress, completed, blocked のいずれか
|
||
- **理由**: 状態変更の理由（blocked の場合は必須）
|
||
|
||
### 2. タスクファイルの読み込み
|
||
|
||
`.tasks.json` ファイルを読み込み、指定されたIDのタスクを検索します。
|
||
|
||
### 3. バリデーション
|
||
|
||
以下をチェックします：
|
||
- タスクIDが存在するか
|
||
- 状態が有効な値か
|
||
- blocked の場合、理由が提供されているか
|
||
- 依存関係の問題がないか（依存タスクが未完了なのに in_progress にしようとしていないか）
|
||
|
||
### 4. 状態の更新
|
||
|
||
タスクの状態を更新し、以下の情報も記録します：
|
||
- `updatedAt`: 更新日時
|
||
- `blockReason`: ブロック理由（blocked の場合）
|
||
- `startedAt`: 開始日時（pending → in_progress の場合）
|
||
|
||
### 5. 依存関係のチェック
|
||
|
||
タスクを `completed` にする場合、このタスクに依存している他のタスクがあれば通知します。
|
||
|
||
## 出力例
|
||
|
||
### 成功時
|
||
|
||
```
|
||
✅ タスク #5 の状態を更新しました
|
||
|
||
タスク: ユーザーモデルの作成
|
||
旧状態: pending → 新状態: in_progress
|
||
開始日時: 2025-10-12 14:30
|
||
|
||
このタスクに依存しているタスク:
|
||
- #6: 認証APIエンドポイントの実装
|
||
```
|
||
|
||
### ブロック時
|
||
|
||
```
|
||
🚫 タスク #7 をブロック状態にしました
|
||
|
||
タスク: データベースマイグレーション
|
||
理由: データベーススキーマの確認待ち
|
||
|
||
推奨アクション:
|
||
1. 関係者に確認を依頼
|
||
2. 他のタスク（#5, #6）を先に進める
|
||
3. 問題が解決したら `/update-task 7 pending` で再開
|
||
```
|
||
|
||
### エラー時
|
||
|
||
```
|
||
❌ タスクの更新に失敗しました
|
||
|
||
原因: タスク #99 が見つかりません
|
||
|
||
利用可能なタスクID: 1, 2, 3, 4, 5, 6, 7
|
||
タスク一覧を確認: `/list-tasks`
|
||
```
|
||
|
||
### 依存関係エラー時
|
||
|
||
```
|
||
⚠️ 依存関係の警告
|
||
|
||
タスク #6 を in_progress にしようとしていますが、
|
||
依存タスク #5 (ユーザーモデルの作成) がまだ完了していません。
|
||
|
||
推奨:
|
||
- 先に #5 を完了させる
|
||
- または依存関係を見直す
|
||
```
|
||
|
||
## 次のステップ
|
||
|
||
状態に応じて以下を提案：
|
||
- `in_progress` にした場合: 作業のヒントや関連ドキュメントを提示
|
||
- `blocked` にした場合: 代わりに取り組めるタスクを提案
|
||
- `completed` にした場合: 次のタスクを提案（`/complete-task` を推奨）
|