k2works/tracking-progress

進捗追跡

プロジェクトの開発進捗を多角的に分析し、現在の状況を定量的に報告する。Git 履歴・テスト結果・ドキュメントを総合的に分析して進捗を可視化する。

オプション

| オプション | 説明 | |-----------|------| | なし | 全体的な進捗確認（デフォルト） | | --brief | 簡潔な進捗サマリー表示 | | --detailed | 詳細な進捗レポート生成 | | --iteration <番号> | 特定イテレーションの進捗確認 | | --technical | 技術的な実装状況に焦点 | | --docs | ドキュメント更新状況の確認 | | --update | docs/development/ 内のドキュメントを現在の進捗に合わせて更新 |

分析の観点

• イテレーション達成度: 計画 vs 実績の比較分析（SP、ストーリー数、期間）
• 技術実装状況: 機能完成度・テスト結果・ビルド状態
• 品質メトリクス: テストカバレッジ、静的解析結果、コード複雑度
• ドキュメント整備: 計画書・仕様書・手順書の最新性

--update オプションの詳細

docs/development/ 内のドキュメントを現在の進捗に合わせて自動更新する。

更新対象:

• docs/development/release_plan.md — 進捗状況テーブル、リリース条件チェック、バーンダウン実績値
• docs/development/iteration_plan-*.md — 成功基準チェック、タスク状態、完了条件（DoD）、メトリクス実績値

更新判定の情報源:

git log --oneline --since="2 weeks ago"   # 実装状況の分析
dotnet test --logger trx                  # テスト結果の取得
npm test -- --coverage                    # カバレッジの取得

出力例

プロジェクト進捗レポート
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Overall Status: フルスタック実装完成 (MVP 準備段階)

Iteration Progress:
├─ Iteration 1 (認証・閲覧): 完了 (計画 10 日→実績 4 日)
├─ Iteration 2 (予約機能): 計画済み
├─ Iteration 3 (キャンセル): 待機中
└─ Iteration 4 (運用準備): 待機中

Technical Implementation:
├─ Backend (.NET 9): 完全実装 (181 テスト全通過)
├─ Frontend (React TS): 完全実装
└─ API Integration: フルスタック連携確認

途中から再開

進捗追跡の途中から再開する場合は、前回の追跡結果を確認する。

Example:

ユーザー: 「イテレーション 2 の中間進捗を確認したい」
回答: --iteration 2 で現在の達成状況を分析する。
      計画 SP と完了 SP を比較し、残りの期間で完了可能か評価する。
      遅延リスクがあれば早期に報告する。

注意事項

• Git リポジトリ内で実行し、プロジェクト構造を理解していること（前提条件）
• 実行時点での動的な状況を総合的に分析する
• --update 使用時は更新前に Git でコミットしておくことを推奨する（ロールバック用）
• イテレーション開始・終了時の定期実行を推奨する
• --update 実行後、KPT セクションは手動で記入して振り返りを完了する

関連スキル

• managing-docs — ドキュメント一覧と進捗状況の確認
• git-commit — 進捗に合わせた適切なコミット実行
• planning-releases — イテレーション計画の作成・更新