gh-krhrtky-agents-plugins-pbi-task-manager/commands/task-status.md

---
description: タスクの進捗状況を表示する（カテゴリ・グループ情報含む）
argument-hint: [issue_number] [--detail] [--category=CAT]
allowed-tools: Bash, Read, Glob
---

# タスク進捗状況の確認

指定されたPBI（$1が指定された場合）または全PBIのタスク進捗状況を、リファインメントグループとカテゴリ別に表示します。

## 表示オプション

```bash
/task-status                        # 全PBI概要表示
/task-status 123                    # PBI #123詳細表示
/task-status 123 --detail           # 詳細表示（グループ履歴含む）
/task-status --category=setup       # Setup系タスクのみ表示
```

## 実行内容

### 1. PBI指定時の詳細表示（$1が存在）

**基本情報の表示:**
```
【PBI #$1】<title>
URL: <github_url>
作成日: <created>
更新日: <updated>
フェーズ: <phase> (completed/in-progress/planning)

全体進捗: <done>/<total> タスク完了 (<percentage>%)
```

**リファインメントグループ履歴** (--detail指定時):
```
=== リファインメント履歴 ===
✅ Group 1: 要件・制約確定 (2024-01-01 10:08)
   - 処理分野: 認証系
   - 機能範囲: ログイン、登録、パスワードリセット
   - セキュリティ: 基本レベル
   - 規模: 中規模対応

✅ Group 2: 技術・アーキテクチャ設計 (2024-01-01 10:20)
   - バックエンド: Node.js + Express + PostgreSQL
   - フロントエンド: React + TypeScript
   - 認証方式: JWT (24時間有効期限)
   - API: RESTful 4エンドポイント

✅ Group 3: 実装・タスク構成 (2024-01-01 10:28)
   - タスク数: 8個
   - カテゴリ: Setup(1), Models(2), Services(2), UI(2), Tests(1)
   - 実装期間: 5-8日想定
```

**カテゴリ別進捗:**
```
=== カテゴリ別進捗 ===
✅ Setup: 1/1 完了 (100%)
   └── ✅ プロジェクト環境構築 (done-setup-1.md)

🔄 Models: 1/2 進行中 (50%)
   ├── ✅ User model実装 (done-models-1.md)
   └── ⏳ 認証関連テーブル設計 (wip-models-2.md) - 開始: 10:45

⏳ Services: 0/2 待機中 (0%) - Models完了待ち
   ├── ⬜ 認証API実装 (todo-services-1.md)
   └── ⬜ パスワードリセット機能 (todo-services-2.md)

⬜ UI: 0/2 未開始 (0%)
   ├── ⬜ ログインフォーム実装 (todo-ui-1.md)
   └── ⬜ 登録フォーム実装 (todo-ui-2.md)

⬜ Tests: 0/1 未開始 (0%)
   └── ⬜ 認証機能テスト (todo-tests-1.md)
```

**推奨アクション:**
- 実行可能タスク: Models残り1タスク (高優先度)
- ブロック解除: Models完了後にServices 2タスクが実行可能
- 並行作業: UI系タスクは独立して実行可能
- 全完了時: 🎉 PBI完了祝福メッセージ

### 2. 全PBI一覧表示（引数なし）

**PBI別サマリー（カテゴリ・グループ情報含む）:**
```
=== PBI 一覧 ===

✅ PBI #123: ユーザー認証機能
   📊 進捗: 8/8 (100%) | フェーズ: 完了
   📋 カテゴリ: Setup(✅), Models(✅), Services(✅), UI(✅), Tests(✅)
   🕒 期間: 2024-01-01 ~ 2024-01-08 (8日)
   🔗 URL: https://github.com/org/repo/issues/123

⏳ PBI #124: 商品管理機能
   📊 進捗: 3/10 (30%) | フェーズ: 実装中
   📋 カテゴリ: Setup(✅), Models(🔄), Services(⏳), UI(⬜), Tests(⬜)
   🚧 ブロック: 2タスク (Models完了待ち)
   🔗 URL: https://github.com/org/repo/issues/124

📋 PBI #125: 決済システム
   📊 進捗: 0/6 (0%) | フェーズ: リファインメント中
   📋 グループ: Group 2実行中 (技術・アーキテクチャ設計)
   🔗 URL: https://github.com/org/repo/issues/125

⬜ PBI #126: レポート機能
   📊 進捗: 0/0 (0%) | フェーズ: 未開始
   📋 ステータス: Issue作成済み、リファインメント待ち
   🔗 URL: https://github.com/org/repo/issues/126
```

**全体サマリー（カテゴリ・フェーズ別）:**
```
=== 全体サマリー ===
📊 PBI進捗: 1/4 完了 (25%)
📋 タスク進捗: 11/24 完了 (45.8%)
⏳ 実行中: 2タスク、1リファインメント

📈 フェーズ別状況:
   ✅ 完了: 1 PBI
   🔄 実装中: 1 PBI
   📋 リファインメント中: 1 PBI
   ⬜ 未開始: 1 PBI

📂 カテゴリ別進捗:
   ✅ Setup: 3/3 完了 (100%)
   🔄 Models: 4/6 進行中 (66.7%)
   ⏳ Services: 2/8 開始可能 (25%)
   ⬜ UI: 1/6 待機中 (16.7%)
   ⬜ Tests: 1/1 未開始 (0%)

🎯 次の実行可能アクション:
   💡 PBI #124: Models残り2タスク
   📋 PBI #125: Group 3 (タスク構成) 実行可能
   ➕ PBI #126: Group 1 (要件確定) から開始
```

### 3. 状況に応じた案内表示

**進捗状況別のメッセージ:**
- 全完了: 🎉 すべてのタスクが完了しています！
- 実行中あり: 💡 `/task-next` で次のタスクを実行できます
- 未着手のみ: 💡 `/task-next` で次のタスクを開始できます

## 使用するコマンド

```bash
# PBI一覧の取得
find tasks -name "pbi-*" -type d | sort

# リファインメント進捗の確認
grep "^phase:" tasks/pbi-$1/README.md
ls tasks/pbi-$1/.refine-progress.json 2>/dev/null

# カテゴリ別タスクカウント
find tasks/pbi-$1 -name "todo-setup-*.md" | wc -l
find tasks/pbi-$1 -name "wip-models-*.md" | wc -l
find tasks/pbi-$1 -name "done-services-*.md" | wc -l
find tasks/pbi-$1 -name "*-ui-*.md" | wc -l
find tasks/pbi-$1 -name "*-tests-*.md" | wc -l

# 全体のカテゴリ別集計
for cat in setup models services ui tests; do
    echo "$cat: $(find tasks -name "*-$cat-*.md" | wc -l)"
done

# 優先度・依存関係情報
grep "priority:" tasks/pbi-$1/todo-*.md
grep "depends_on:" tasks/pbi-$1/todo-*.md
grep "estimated_hours:" tasks/pbi-$1/todo-*.md

# リファインメントグループ履歴
if [ -f "tasks/pbi-$1/README.md" ]; then
    sed -n '/## リファインメント履歴/,/## タスク一覧/p' tasks/pbi-$1/README.md
fi

# 実行可能タスクの特定
for todo_file in tasks/pbi-$1/todo-*.md; do
    # 依存関係チェック後、実行可能なタスクを特定
    depends=$(grep "depends_on:" "$todo_file" | cut -d: -f2)
    # 依存タスクがすべて完了している場合のみ表示
done

# フェーズ別PBI集計
grep "^phase:" tasks/pbi-*/README.md | sort | uniq -c
```

## ファイル構造の想定

```
tasks/
├── pbi-123/
│   ├── .refine-progress.json  # リファインメント進捗（Group状態）
│   ├── README.md              # PBI概要、グループ履歴、カテゴリ別タスク
│   ├── done-setup-1.md        # 完了タスク（カテゴリ別）
│   ├── wip-models-2.md        # 実行中タスク
│   ├── todo-services-1.md     # 未着手タスク
│   ├── todo-services-2.md
│   ├── todo-ui-1.md
│   ├── todo-ui-2.md
│   └── todo-tests-1.md
├── pbi-124/
│   ├── .refine-progress.json  # Group 2で中断中
│   └── README.md              # 部分的なリファインメント情報
└── pbi-125/
    └── (リファインメント未実行)
```

**リファインメント状態の分類:**
- `phase: completed` - 全グループ完了、タスク実装中
- `phase: in-progress` - グループ途中で中断
- `phase: planning` - リファインメント未開始
- `.refine-progress.json` - グループ進捗と決定履歴

## エラーハンドリング

- 指定されたPBIが存在しない場合の適切なエラー
- README.mdが見つからない場合の警告
- tasksディレクトリが存在しない場合の案内
- タスクファイルの形式が不正な場合の警告

## 表示される進捗指標

### PBI・フェーズレベル
1. **PBI進捗**: 完了PBI数/全PBI数
2. **フェーズ分布**: 完了/実装中/リファインメント中/未開始
3. **リファインメント品質**: Group完了度、決定事項の詳細度

### タスク・カテゴリレベル
4. **タスク進捗**: 完了タスク数/全タスク数（カテゴリ別）
5. **カテゴリバランス**: Setup→Models→Services→UI→Tests の進行状況
6. **依存関係状況**: ブロックされているタスク数、実行可能タスク数

### アクティビティレベル
7. **実行中作業**: 現在のwipタスク数、推定残り時間
8. **ボトルネック**: 進捗を阻害しているカテゴリ・依存関係
9. **最適化提案**: 並行実行可能タスク、優先度調整の提案

## 完了条件

- 指定されたPBIまたは全PBIの状況が正確に表示されている
- 進捗率が正しく計算されている
- 次のアクションが適切に提案されている
- エラー時も適切なガイダンスが表示されている

実行を開始しますか？