show-plan - SKILL.md Agent Skill

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

プラン確認スキル

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

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

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

優先順位（高→低）:

プロジェクトローカル: .claude/plans/ （Claude Code管理の計画）
プロジェクトドキュメント: docs/**/*PLAN*.md （独自の計画ドキュメント）
グローバル: ~/.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. 実行内容

計画ファイルの検索:
- プロジェクトローカル: .claude/plans/*.md を検索
- プロジェクトドキュメント: 以下のパターンで検索
  - docs/**/*PLAN*.md （大文字PLAN）
  - docs/**/*plan*.md （小文字plan）
- グローバル: ~/.claude/plans/*.md を検索
- .claude/settings.json で plansDirectory が設定されていればそれも確認
計画ファイルの収集と優先順位付け:
- プロジェクトローカル（.claude/plans/）を最優先で収集
- プロジェクトドキュメント（docs/）を次に収集
- --all オプションがある場合のみ、グローバルのプランも収集
- 各プランに出典（ローカル/ドキュメント/グローバル）をタグ付け
- 各カテゴリ内では最終更新日時順にソート
表示モードの判定:
- --list オプション: 一覧表示のみで終了
- ファイル名指定: 指定されたプランを表示（全カテゴリから検索）
- 指定なし: 最新のプラン（プロジェクト内優先）を表示
表示:
- --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. 優先順位のロジック

「最新の計画」の決定:

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

一覧表示の順序:

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

検索範囲:

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