--- 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分類が適切に表示されている - カテゴリ別タスク進捗が正確に表示されている - リファインメントグループ進捗が表示されている - 依存関係とブロック状況が明確に示されている ### データ精度要件 - 全体進捗率が正確に計算・表示されている - カテゴリ別進捗率が正確に算出されている - ベロシティと完了予測が適切に計算されている - ボトルネック分析が正確に実行されている ### ユーザビリティ要件 - 状態アイコンが統一され理解しやすい - 重要情報が視覚的に強調されている - 次のアクションが具体的で実行可能 - フィルター機能が適切に動作している ### 戦略的価値要件 - プロジェクト全体の健全性が把握できる - 意思決定に必要な情報が提供されている - 最適化機会が明確に提示されている - 将来予測が実用的なレベルで提供されている 実行を開始しますか？