362 lines
15 KiB
Markdown
362 lines
15 KiB
Markdown
---
|
||
description: すべてのPBIとタスクを一覧表示する（カテゴリ・グループ・フェーズ情報含む）
|
||
argument-hint: [--compact] [--phase=PHASE] [--category=CAT]
|
||
allowed-tools: Bash, Read, Glob
|
||
---
|
||
|
||
# PBIとタスクの一覧表示
|
||
|
||
プロジェクト内のすべてのProduct Backlog Item（PBI）とそのタスクを、リファインメントフェーズとカテゴリ別に一覧表示します。
|
||
|
||
## 表示オプション
|
||
|
||
```bash
|
||
/task-list # 詳細表示（グループ・カテゴリ情報含む）
|
||
/task-list --compact # コンパクト表示
|
||
/task-list --phase=completed # 特定フェーズのPBIのみ
|
||
/task-list --category=models # 特定カテゴリのタスクに焦点
|
||
```
|
||
|
||
## 実行内容
|
||
|
||
### 1. 表示モードの選択
|
||
|
||
**詳細表示（デフォルト）:**
|
||
- リファインメントフェーズ別のPBI分類
|
||
- カテゴリ別タスク進捗（Setup→Models→Services→UI→Tests）
|
||
- グループ履歴と決定事項の表示
|
||
- 依存関係とブロック状況
|
||
|
||
**コンパクト表示（--compact）:**
|
||
- 表形式でのサマリー表示
|
||
- フェーズ、カテゴリ進捗、ブロック状況の概要
|
||
|
||
**フィルター表示:**
|
||
- --phase: 特定フェーズ（completed/in-progress/planning）のPBIのみ
|
||
- --category: 特定カテゴリ（setup/models/services/ui/tests）に焦点
|
||
|
||
### 2. 詳細表示の内容（フェーズ・カテゴリ別）
|
||
|
||
```
|
||
=== フェーズ別 PBI 一覧 ===
|
||
|
||
🎉 完了済み PBI (1個)
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
✅ **PBI #123**: ユーザー認証機能の実装
|
||
📊 全体進捗: 8/8 タスク完了 (100%)
|
||
📅 期間: 2024-01-01 ~ 2024-01-08 (8日間)
|
||
🔗 URL: https://github.com/org/repo/issues/123
|
||
|
||
📋 リファインメント履歴:
|
||
✅ Group 1: 要件・制約確定 (01-01 10:08)
|
||
✅ Group 2: 技術・アーキテクチャ設計 (01-01 10:20)
|
||
✅ Group 3: 実装・タスク構成 (01-01 10:28)
|
||
|
||
📊 カテゴリ別達成状況:
|
||
✅ Setup: 1/1 (100%) - プロジェクト環境構築
|
||
✅ Models: 2/2 (100%) - User model、認証テーブル設計
|
||
✅ Services: 2/2 (100%) - 認証API、パスワードリセット
|
||
✅ UI: 2/2 (100%) - ログイン・登録フォーム
|
||
✅ Tests: 1/1 (100%) - 認証機能テスト
|
||
|
||
🔄 実装中 PBI (1個)
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
⏳ **PBI #124**: 商品管理機能
|
||
📊 全体進捗: 3/10 タスク完了 (30%)
|
||
📅 開始: 2024-01-09, 推定完了: 2024-01-18
|
||
🔗 URL: https://github.com/org/repo/issues/124
|
||
🚧 ブロック: 2タスク (Models完了待ち)
|
||
|
||
📋 リファインメント履歴:
|
||
✅ Group 1: 要件・制約確定 (01-09 09:15)
|
||
✅ Group 2: 技術・アーキテクチャ設計 (01-09 09:35)
|
||
✅ Group 3: 実装・タスク構成 (01-09 09:45)
|
||
|
||
📊 カテゴリ別進捗:
|
||
✅ Setup: 1/1 (100%)
|
||
└── ✅ 商品管理環境構築 (done-setup-1.md)
|
||
|
||
🔄 Models: 1/3 (33%)
|
||
├── ✅ Product modelの実装 (done-models-1.md)
|
||
├── ⏳ Category modelの実装 (wip-models-2.md) - 開始: 10:30
|
||
└── ⬜ 在庫管理テーブル設計 (todo-models-3.md)
|
||
|
||
⏳ Services: 0/3 (0%) - Models完了待ち
|
||
├── ⬜ 商品CRUD API (todo-services-1.md) [depends: models-2,3]
|
||
├── ⬜ 検索API実装 (todo-services-2.md) [depends: models-1,2]
|
||
└── ⬜ 在庫管理API (todo-services-3.md) [depends: models-3]
|
||
|
||
⬜ UI: 0/2 (0%)
|
||
├── ⬜ 商品一覧画面 (todo-ui-1.md)
|
||
└── ⬜ 商品詳細・編集画面 (todo-ui-2.md)
|
||
|
||
⬜ Tests: 0/1 (0%)
|
||
└── ⬜ 商品管理機能テスト (todo-tests-1.md)
|
||
|
||
💡 次の実行可能アクション:
|
||
- Models残り2タスク (高優先度)
|
||
- UI系タスクは並行実行可能
|
||
|
||
📋 リファインメント中 PBI (1個)
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
📝 **PBI #125**: 決済システム連携
|
||
📊 リファインメント進捗: Group 2/3 (67%)
|
||
📅 開始: 2024-01-10, Group 3実行中
|
||
🔗 URL: https://github.com/org/repo/issues/125
|
||
|
||
📋 リファインメント履歴:
|
||
✅ Group 1: 要件・制約確定 (01-10 14:20)
|
||
- 処理分野: 統合系 (外部API連携)
|
||
- 機能範囲: Stripe決済、返金処理、定期課金
|
||
- セキュリティ: 強化レベル (PCI DSS準拠)
|
||
- 規模: 中規模対応
|
||
|
||
⏳ Group 2: 技術・アーキテクチャ設計 (進行中)
|
||
- 決済プロバイダー: Stripe
|
||
- webhook処理: Express middleware
|
||
- データ暗号化: AES-256
|
||
- 📝 API設計検討中...
|
||
|
||
⬜ Group 3: 実装・タスク構成 (未開始)
|
||
|
||
⬜ 未開始 PBI (1個)
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
📋 **PBI #126**: レポート機能
|
||
📊 状況: Issue作成済み、リファインメント待ち
|
||
📅 作成: 2024-01-11
|
||
🔗 URL: https://github.com/org/repo/issues/126
|
||
|
||
💡 次のアクション: `/task-refine 126` でリファインメント開始
|
||
```
|
||
|
||
### 3. コンパクト表示の内容
|
||
|
||
```
|
||
PBI# タイトル フェーズ タスク進捗 カテゴリ進捗 ブロック URL
|
||
---- -------------------- ----------- ----------- ----------------------------- ------- ------
|
||
#123 ユーザー認証機能 完了 8/8 (100%) S:✅ M:✅ Sv:✅ U:✅ T:✅ なし GitHub
|
||
#124 商品管理機能 実装中 3/10 (30%) S:✅ M:🔄 Sv:⏳ U:⬜ T:⬜ 2タスク GitHub
|
||
#125 決済システム連携 リファイン 0/0 (0%) Group 2/3 進行中 なし GitHub
|
||
#126 レポート機能 未開始 0/0 (0%) リファインメント待ち なし GitHub
|
||
|
||
凡例: S=Setup, M=Models, Sv=Services, U=UI, T=Tests
|
||
✅=完了, 🔄=進行中, ⏳=待機中, ⬜=未開始
|
||
```
|
||
|
||
### 4. 全体サマリーの表示
|
||
|
||
```
|
||
=== プロジェクト全体サマリー ===
|
||
|
||
📈 PBI進捗
|
||
🎉 完了: 1/4 PBI (25%)
|
||
🔄 実装中: 1/4 PBI (25%)
|
||
📝 リファインメント中: 1/4 PBI (25%)
|
||
⬜ 未開始: 1/4 PBI (25%)
|
||
|
||
📊 タスク進捗 (実装フェーズのみ)
|
||
✅ 完了: 11/18 タスク (61.1%)
|
||
⏳ 実行中: 1/18 タスク (5.6%)
|
||
⬜ 未着手: 6/18 タスク (33.3%)
|
||
|
||
🔧 カテゴリ別進捗
|
||
✅ Setup: 2/2 完了 (100%)
|
||
🔄 Models: 3/5 進行中 (60%)
|
||
⏳ Services: 2/5 待機中 (40%)
|
||
⬜ UI: 2/4 未開始 (50%)
|
||
⬜ Tests: 1/2 未開始 (50%)
|
||
|
||
🚧 ボトルネック分析
|
||
⚠️ Modelsカテゴリが進捗阻害要因
|
||
💡 2タスクがModels完了待ちでブロック中
|
||
🎯 Models優先実行でServices解放可能
|
||
|
||
⚡ パフォーマンス指標
|
||
📅 平均実装期間: 8日/PBI
|
||
🔄 現在のベロシティ: 1.4タスク/日
|
||
📈 完了予測: PBI #124は2024-01-18完了見込み
|
||
|
||
📝 推奨アクション
|
||
🎯 即座に実行可能:
|
||
• /task-next 124 --category=models (高優先度)
|
||
• /task-next 124 --category=ui (並行可能)
|
||
|
||
📋 中期計画:
|
||
• /task-refine 125 でGroup 3完了
|
||
• /task-refine 126 で新規PBI開始
|
||
|
||
🔧 最適化:
|
||
• Models完了後、Services 2タスク並行実行検討
|
||
• UI系タスクはModels依存なしで先行実行可能
|
||
```
|
||
|
||
## 使用するコマンド
|
||
|
||
```bash
|
||
# フェーズ別PBI一覧
|
||
find tasks -name "pbi-*" -type d | sort
|
||
for pbi in tasks/pbi-*; do
|
||
phase=$(grep "^phase:" "$pbi/README.md" 2>/dev/null | cut -d' ' -f2)
|
||
echo "$pbi: $phase"
|
||
done
|
||
|
||
# リファインメントグループ進捗確認
|
||
for pbi in tasks/pbi-*; do
|
||
if [ -f "$pbi/.refine-progress.json" ]; then
|
||
current_group=$(jq -r '.current_group' "$pbi/.refine-progress.json")
|
||
echo "$pbi: Group $current_group/3"
|
||
fi
|
||
done
|
||
|
||
# カテゴリ別タスクカウント（全PBI）
|
||
for category in setup models services ui tests; do
|
||
total=$(find tasks -name "*-$category-*.md" | wc -l)
|
||
done=$(find tasks -name "done-$category-*.md" | wc -l)
|
||
wip=$(find tasks -name "wip-$category-*.md" | wc -l)
|
||
todo=$(find tasks -name "todo-$category-*.md" | wc -l)
|
||
echo "$category: $done/$total 完了, $wip実行中, $todo未着手"
|
||
done
|
||
|
||
# 依存関係とブロック状況
|
||
for pbi in tasks/pbi-*; do
|
||
blocked=0
|
||
for todo_file in "$pbi"/todo-*.md; do
|
||
if [ -f "$todo_file" ]; then
|
||
depends=$(grep "depends_on:" "$todo_file" | cut -d: -f2)
|
||
for dep in $depends; do
|
||
if [ ! -f "$pbi/done-$dep.md" ]; then
|
||
((blocked++))
|
||
break
|
||
fi
|
||
done
|
||
fi
|
||
done
|
||
echo "$(basename $pbi): $blocked タスクがブロック中"
|
||
done
|
||
|
||
# ベロシティと期間計算
|
||
total_completed_tasks=$(find tasks -name "done-*.md" | wc -l)
|
||
first_task_date=$(find tasks -name "done-*.md" -exec grep "completed:" {} \; | head -1 | cut -d' ' -f2)
|
||
current_date=$(date -u +%Y-%m-%dT%H:%M:%SZ)
|
||
# 期間計算とベロシティ算出のロジック
|
||
|
||
# 推定完了日計算
|
||
for pbi in tasks/pbi-*; do
|
||
remaining_tasks=$(find "$pbi" -name "todo-*.md" -o -name "wip-*.md" | wc -l)
|
||
if [ $remaining_tasks -gt 0 ]; then
|
||
estimated_days=$((remaining_tasks / velocity))
|
||
estimated_completion=$(date -d "+$estimated_days days" +%Y-%m-%d)
|
||
echo "$(basename $pbi): 推定完了 $estimated_completion"
|
||
fi
|
||
done
|
||
|
||
# フェーズ別統計
|
||
grep "^phase:" tasks/pbi-*/README.md | cut -d: -f3 | sort | uniq -c
|
||
```
|
||
|
||
## 状態アイコンの定義
|
||
|
||
### PBIレベル
|
||
- ✅ **完了**: 全タスク完了、フェーズcompleted
|
||
- ⏳ **実行中**: wipタスクあり、フェーズcompleted
|
||
- 🔄 **進行中**: doneタスクあり、フェーズcompleted
|
||
- 📝 **リファインメント中**: Group 1-3実行中
|
||
- ⬜ **未着手**: リファインメント未開始
|
||
|
||
### タスクレベル
|
||
- ✅ **完了**: done-{category}-N.md
|
||
- ⏳ **実行中**: wip-{category}-N.md
|
||
- 🚧 **ブロック中**: todo状態だが依存タスク未完了
|
||
- ⬜ **未着手**: todo-{category}-N.md
|
||
|
||
### カテゴリレベル
|
||
- ✅ **完了**: カテゴリ内全タスク完了
|
||
- 🔄 **進行中**: 一部タスク完了、一部実行中
|
||
- ⏳ **待機中**: 依存関係によりブロック
|
||
- ⬜ **未開始**: カテゴリ内全タスクがtodo
|
||
|
||
## データ集計項目
|
||
|
||
### PBIレベル集計
|
||
- **フェーズ別分布**: completed/in-progress/planning/未開始
|
||
- **リファインメント進捗**: Group完了状況 (Group 1-3)
|
||
- **実装進捗**: タスク完了率（実装フェーズのPBIのみ）
|
||
- **期間統計**: 平均実装期間、リファインメント期間
|
||
|
||
### カテゴリレベル集計
|
||
- **カテゴリ別進捗**: Setup/Models/Services/UI/Tests毎の完了率
|
||
- **依存関係**: ブロックされているタスク数、解放待ちタスク数
|
||
- **並行度**: 同時実行可能なカテゴリとタスク数
|
||
- **ボトルネック**: 進捗阻害要因となっているカテゴリ
|
||
|
||
### パフォーマンス指標
|
||
- **ベロシティ**: タスク完了速度（タスク/日）
|
||
- **スループット**: PBI完了速度（PBI/週）
|
||
- **サイクルタイム**: リファインメント〜完了までの期間
|
||
- **品質指標**: 手戻り発生率、再リファインメント率
|
||
|
||
### 予測・最適化
|
||
- **完了予測**: 残りタスクの推定完了日
|
||
- **並行実行提案**: 依存関係を考慮した最適実行順序
|
||
- **リソース配分**: カテゴリ別の作業負荷分散提案
|
||
- **ボトルネック解消**: 進捗改善のための優先アクション
|
||
|
||
## エラーハンドリング
|
||
|
||
- tasksディレクトリが存在しない場合の案内
|
||
- PBIディレクトリは存在するがREADME.mdがない場合の警告
|
||
- タスクファイルの形式が不正な場合の警告表示
|
||
- 引数が無効な場合の使用方法表示
|
||
|
||
## 推奨アクションの提案
|
||
|
||
### 即座実行可能アクション
|
||
- **高優先度タスク**: 依存関係なし、ブロックなしの重要タスク
|
||
- **並行実行**: 異なるカテゴリの独立タスク
|
||
- **ボトルネック解消**: 他タスクのブロック要因となっているタスク
|
||
|
||
### フェーズ別推奨アクション
|
||
- **完了済みPBI**: 🎉 完了祝福、新PBI計画提案
|
||
- **実装中PBI**: 次タスク実行、並行作業検討
|
||
- **リファインメント中PBI**: Group続行、一時停止オプション
|
||
- **未開始PBI**: リファインメント開始提案
|
||
|
||
### 最適化提案
|
||
- **スケジュール最適化**: 依存関係を考慮した実行順序調整
|
||
- **リソース配分**: カテゴリ間の作業負荷バランス調整
|
||
- **並行度向上**: 独立実行可能なタスクの特定と提案
|
||
- **品質向上**: リファインメント品質改善、手戻り防止策
|
||
|
||
### 戦略的提案
|
||
- **容量計画**: 新PBI追加のタイミングと優先度
|
||
- **技術債務**: リファクタリングタスクの計画的実行
|
||
- **スキル開発**: カテゴリ別の習熟度向上計画
|
||
- **プロセス改善**: リファインメント効率化、ベロシティ向上
|
||
|
||
## 完了条件
|
||
|
||
### 基本表示要件
|
||
- フェーズ別PBI分類が適切に表示されている
|
||
- カテゴリ別タスク進捗が正確に表示されている
|
||
- リファインメントグループ進捗が表示されている
|
||
- 依存関係とブロック状況が明確に示されている
|
||
|
||
### データ精度要件
|
||
- 全体進捗率が正確に計算・表示されている
|
||
- カテゴリ別進捗率が正確に算出されている
|
||
- ベロシティと完了予測が適切に計算されている
|
||
- ボトルネック分析が正確に実行されている
|
||
|
||
### ユーザビリティ要件
|
||
- 状態アイコンが統一され理解しやすい
|
||
- 重要情報が視覚的に強調されている
|
||
- 次のアクションが具体的で実行可能
|
||
- フィルター機能が適切に動作している
|
||
|
||
### 戦略的価値要件
|
||
- プロジェクト全体の健全性が把握できる
|
||
- 意思決定に必要な情報が提供されている
|
||
- 最適化機会が明確に提示されている
|
||
- 将来予測が実用的なレベルで提供されている
|
||
|
||
実行を開始しますか？ |