zhongwei/gh-krhrtky-agents-plugins-pbi-task-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Zhongwei Li
2025-11-30 08:35:56 +08:00
commit dc3739c3bd
10 changed files with 2422 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

362
commands/task-list.md Normal file
View File

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