Initial commit

2025-11-30 08:35:56 +08:00
commit dc3739c3bd
10 changed files with 2422 additions and 0 deletions
--- a/commands/task-status.md
+++ b/commands/task-status.md
@@ -0,0 +1,247 @@
+---
+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の状況が正確に表示されている
+- 進捗率が正しく計算されている
+- 次のアクションが適切に提案されている
+- エラー時も適切なガイダンスが表示されている
+
+実行を開始しますか？