Prompt file imported from guidoor/guidoor (
.claude/commands/review-plan-status.md). Fill in{{arguments}}before use. Copyright stays with the author.
実装計画進捗レビュー
現在の実装計画とその進捗状況を包括的に確認し、git履歴およびGitHub/Linear Issuesと照合して実際の作業状況を分析します。深い分析により、計画と実装の乖離や次のアクションを明確化します。
実行内容
-
計画書類の読み込みと分析
CURRENT_PLAN_PROGRESS.md- 現在の進捗管理状況- 最新の
implementation-plan-*.md- 全体実装計画 - 計画の構造と優先順位の把握
-
Git履歴との照合
- 現在のブランチとコミット履歴
- 最近の作業内容と計画の整合性確認
- マージ済み/未マージの作業確認
-
GitHub/Linear Issues確認
- 関連するIssueの状態確認
- 計画と紐づくIssueの進捗状況
- ブロッカーや未解決問題の特定
-
総合分析レポート
- 計画vs実装の差分分析
- 完了/進行中/未着手タスクの整理
- 推奨される次のアクション
プロジェクト情報の取得
# 計画ディレクトリの内容確認
!ls -lt docs/plans/*.md | head -5
# 現在のブランチとコミット状況
!git branch --show-current
!git log --oneline -10
# 最近の作業ファイル確認
!git diff --name-only HEAD~5..HEAD 2>/dev/null | head -10
処理手順
1. 進捗管理ファイルの読み込み
# 現在の進捗状況を把握
@docs/plans/CURRENT_PLAN_PROGRESS.md
2. 最新の実装計画書の特定と読み込み
# 最新の実装計画ファイルを特定
!ls -t docs/plans/implementation-plan-*.md | grep -v template | head -1
# 特定したファイルを読み込み
@[上記で特定したファイルパス]
3. Git履歴の詳細分析
# 現在のブランチ
!git branch --show-current
# 最近のコミット履歴(詳細)
!git log --pretty=format:"%h - %an, %ar : %s" --since="7 days ago"
# 計画に関連するコミットを検索
!git log --grep="Phase\|phase\|Issue\|issue\|#[0-9]" --oneline -20
# 未マージの作業確認
!git branch -r --no-merged origin/main | head -10
4. GitHub/Linear Issues確認
# Linear Issuesの取得(最新10件)
mcp__linear__list_issues
limit: 10
orderBy: "updatedAt"
includeArchived: false
# 特定のIssue詳細確認(番号が判明した場合)
mcp__linear__get_issue
id: "[issue_id]"
5. 深い分析と考察
# 収集した情報を元に深く考察
# 以下の観点で分析:
# - 計画通りに進んでいる部分
# - 遅延や問題が発生している部分
# - 計画にない追加作業
# - 次に優先すべきタスク
引数の活用
引数が指定された場合({{arguments}})、特定の観点に焦点を当てた分析を実行:
# 例: /review-plan-status "Phase 2"
# → Phase 2に特化した詳細分析
# 例: /review-plan-status "issue-14"
# → Issue #14に関連する進捗確認
# 例: /review-plan-status "today"
# → 本日の作業と計画の照合
出力形式
📊 実装計画進捗レビュー
═══════════════════════════════════════
📅 レビュー日時: [現在日時]
🌿 現在のブランチ: [ブランチ名]
📋 計画概要:
計画名: [計画書から抽出]
開始日: [日付]
目標: [主要目標]
✅ 完了タスク ([数]件):
- [タスク名]: [コミットハッシュ]
- ...
🔄 進行中タスク ([数]件):
- [タスク名]: [進捗%]
- ...
📝 未着手タスク ([数]件):
- [タスク名]: [優先度]
- ...
🚨 ブロッカー/課題:
- [Issue番号]: [概要]
- ...
💡 分析結果:
[深い考察による分析結果]
- 計画との乖離: [あり/なし]
- 進捗率: [%]
- リスク要因: [特定されたリスク]
🎯 推奨アクション:
1. [次に取り組むべきタスク]
2. [解決すべき課題]
3. [計画の調整提案]
注意事項
- 深い分析: 単なる情報の羅列ではなく、関連性と意味を考察
- 客観性: 計画と実装の差異を客観的に評価
- 実用性: 次のアクションが明確になるような分析結果
- 時間軸: 過去の履歴から未来の予測まで含む包括的視点
関連コマンド
/current-plan- 現在の計画詳細を表示/update-plan- 計画を更新/sync-todos- TODOリストと計画を同期
トラブルシューティング
計画ファイルが見つからない場合
# アーカイブも含めて検索
!find docs/plans -name "*.md" -type f | sort -r
Git履歴が多すぎる場合
# 期間を絞って確認
!git log --since="3 days ago" --oneline
Linear APIが応答しない場合
# GitHub CLIで代替確認
!gh issue list --limit 10 2>/dev/null || echo "GitHub CLI not available"
拡張機能
計画の自動更新提案
収集した情報を基に、CURRENT_PLAN_PROGRESS.mdの更新案を生成
メトリクス計算
- タスク完了率
- 平均完了時間
- ベロシティ推定
視覚化
- 進捗のマークダウン表現
- タスク依存関係の表示
