show-plan

name	show-plan
description	Claude Codeのプランモードで作成された実装計画を確認・一覧表示する

プラン確認スキル

以下の手順で実行中または保存済みの計画を確認してください：

1. 計画ファイルの検索と優先順位

計画ファイルは以下の場所に存在し、優先順位に従って表示されます：

優先順位（高→低）:

1. プロジェクトローカル: .claude/plans/ （Claude Code管理の計画）
2. プロジェクトドキュメント: docs/**/*PLAN*.md （独自の計画ドキュメント）
3. グローバル: ~/.claude/plans/ （全プロジェクト共通）

検索パターン:

• .claude/plans/*.md - Claude Code標準の計画
• docs/**/*PLAN*.md - プロジェクト独自の計画（例: ROS2_INTEGRATION_PLAN.md）
• docs/**/*plan*.md - 小文字の計画ファイルも検出
• ~/.claude/plans/*.md - グローバル計画

表示ルール:

• プロジェクト内の計画（ローカル + ドキュメント）を最優先で表示
• 一覧表示時は、ローカル/ドキュメント/グローバルを明示的に区別
• デフォルトで表示する「最新の計画」は、プロジェクト内を優先

2. 引数とオプション

$ARGUMENTS は以下の形式で解釈：

• --detail または -d: 詳細表示モード（計画の全セクションを詳しく説明）
• --list または -l: 一覧のみ表示（内容は表示しない）
• --all または -a: グローバルのプランも含めて全て表示（デフォルトはローカル優先）
• <ファイル名>: 指定した計画ファイルを表示

例:

• /show-plan → プロジェクトローカルの最新計画をサマリー表示（なければグローバル）
• /show-plan --detail → 最新の計画を詳細表示
• /show-plan -l → プロジェクトローカルの計画一覧のみ表示
• /show-plan -l --all → ローカル + グローバルの全計画を一覧表示
• /show-plan concurrent-inventing-map.md → 指定ファイルをサマリー表示
• /show-plan concurrent-inventing-map.md --detail → 指定ファイルを詳細表示

3. 実行内容

1. 計画ファイルの検索:

   • プロジェクトローカル: .claude/plans/*.md を検索
   • プロジェクトドキュメント: 以下のパターンで検索
     • docs/**/*PLAN*.md （大文字PLAN）
     • docs/**/*plan*.md （小文字plan）
   • グローバル: ~/.claude/plans/*.md を検索
   • .claude/settings.json で plansDirectory が設定されていればそれも確認

2. 計画ファイルの収集と優先順位付け:

   • プロジェクトローカル（.claude/plans/）を最優先で収集
   • プロジェクトドキュメント（docs/）を次に収集
   • --all オプションがある場合のみ、グローバルのプランも収集
   • 各プランに出典（ローカル/ドキュメント/グローバル）をタグ付け
   • 各カテゴリ内では最終更新日時順にソート

3. 表示モードの判定:

   • --list オプション: 一覧表示のみで終了
   • ファイル名指定: 指定されたプランを表示（全カテゴリから検索）
   • 指定なし: 最新のプラン（プロジェクト内優先）を表示

4. 表示:

   • --detail オプションの有無に応じて、詳細/サマリー表示を切り替え
   • 出典（ローカル/ドキュメント/グローバル）を明記

4. 出力フォーマット

計画一覧（プロジェクト内優先）

【プロジェクトローカル (.claude/plans/)】
保存されている計画はありません

【プロジェクトドキュメント (docs/)】
- docs/ROS2_INTEGRATION_PLAN.md (最終更新: 2026-01-20 15:30) ← プロジェクト最新
- docs/CONTROLLER_MENU_USB_PLAN.md (最終更新: 2026-01-18 10:00)
- docs/SERIAL_CLI_REBUILD_PLAN.md (最終更新: 2026-01-15 14:20)

【グローバル (~/.claude/plans/)】 ※ --all オプションで表示
表示するには --all オプションを使用してください

計画一覧（--all オプション使用時）

【プロジェクトローカル (.claude/plans/)】
保存されている計画はありません

【プロジェクトドキュメント (docs/)】
- docs/ROS2_INTEGRATION_PLAN.md (最終更新: 2026-01-20 15:30) ← プロジェクト最新
- docs/CONTROLLER_MENU_USB_PLAN.md (最終更新: 2026-01-18 10:00)

【グローバル (~/.claude/plans/)】
- stateful-sleeping-crystal.md (最終更新: 2026-01-24 11:10) ← グローバル最新
- concurrent-inventing-map.md (最終更新: 2026-01-24 06:59)
...

サマリー表示（デフォルト）

• 出典表示: [プロジェクトローカル], [プロジェクトドキュメント], または [グローバル] をタイトルに明記
• ファイルパスを表示（ドキュメントの場合）
• タイトルと概要
• コマンド/モジュール構成（ツリー形式）
• 実装フェーズの一覧（簡潔なテーブル形式）
• 主要なポイントのみ抽出

例:

## [プロジェクトドキュメント] ROS2統合プラン
**ファイル**: docs/ROS2_INTEGRATION_PLAN.md

### 概要
StampFlyドローンにROS2統合を追加する実装計画...

詳細表示（--detail）

• 出典表示: [プロジェクトローカル], [プロジェクトドキュメント], または [グローバル] をタイトルに明記
• ファイルパスを表示
• 計画ファイルの全内容を構造化して表示
• 各コマンド/機能の詳細説明（オプション、必要データ、使用例）
• 実装フェーズの詳細ステップ
• ファイル構成の完全な説明
• パラメータ一覧、ワークフロー、参照ファイルなど全情報
• コード例や設定例も含めて表示

5. 優先順位のロジック

「最新の計画」の決定:

1. プロジェクトローカル（.claude/plans/）にプランがある → ローカルの最新を選択
2. プロジェクトローカルが空 → プロジェクトドキュメント（docs/）の最新を選択
3. プロジェクト内が空 → グローバル（~/.claude/plans/）の最新を選択
4. 全て空 → エラーメッセージを表示

一覧表示の順序:

1. プロジェクトローカル（.claude/plans/）のプランを最新順で表示
2. プロジェクトドキュメント（docs/）のプランを最新順で表示
3. --all オプションがある場合のみ、グローバル（~/.claude/plans/）のプランも最新順で表示

検索範囲:

• デフォルト: プロジェクト内のみ（ローカル + ドキュメント）
• --all オプション: プロジェクト内 + グローバル