3.1 KiB
3.1 KiB
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を推奨）