# Show Plan

> Claude Codeのプランモードで作成された実装計画を確認・一覧表示する Use when this capability is needed.

- Skill: `tomevault-io/show-plan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/show-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/show-plan/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/show-plan

---


## プラン確認スキル

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

### 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` オプション: プロジェクト内 + グローバル

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/m5fly-kanazawa) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->