zhongwei/gh-krhrtky-agents-plugins-pbi-task-manager

Files

Zhongwei Li dc3739c3bd Initial commit

2025-11-30 08:35:56 +08:00

8.7 KiB

Raw Blame History

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

タスク進捗状況の確認

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

表示オプション

/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 で次のタスクを開始できます

使用するコマンド

# 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・フェーズレベル

PBI進捗: 完了PBI数/全PBI数
フェーズ分布: 完了/実装中/リファインメント中/未開始
リファインメント品質: Group完了度、決定事項の詳細度

タスク・カテゴリレベル

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

アクティビティレベル

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

完了条件

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

実行を開始しますか？

8.7 KiB Raw Blame History Unescape Escape