plan-gap-analysis について
plan-gap-analysisは、計画と実装済みコードを照合する開発者向けスキルです。文書とソースを段階別に確認し、差分を優先度付けして、ファイル参照付きのTODOにまとめます。
主な機能
- 01計画文書とソースファイルの一覧化
- 02工程ごとの要件確認
- 03実装ギャップの特定と優先順位付け
- 04ファイル参照付きTODOの作成
活用シーン
- 01アーキテクチャ計画とコードの照合
- 02セキュリティ要件とテスト範囲の確認
- 03未実装項目の整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/plan-gap-analysisを入力して読み込まれたか確認します。
詳細
計画と実装のギャップ分析
plans/ に記載された計画と実際の実装とのギャップを分析します。
ワークフロー
フェーズ 1：計画の一覧化
すべての計画ファイルを読み込みます。
00-overview.md- プロジェクトの概要とメトリクス01-understand.md- 要件とコンポーネント02-plan.md- アーキテクチャの決定事項とロードマップ03-execute.md- 実装の詳細04-review.md- 品質要件05-secure.md- セキュリティ要件06-feedback-loop.md- 改善
フェーズ 2：コードベースの一覧化
# List all crates
find . -name "Cargo.toml" -not -path "*/target/*"
# List source files
find . -name "*.rs" -not -path "*/target/*"
分析対象のクレート：
do-memory-core- コアデータ構造とオーケストレーションdo-memory-storage-turso- Turso/libSQL バックエンドdo-memory-storage-redb- redb キャッシュレイヤーdo-memory-mcp- MCP サーバーとサンドボックスdo-memory-test-utils- テストユーティリティbenches- パフォーマンスベンチマーク
フェーズ 3：ギャップの特定
各フェーズを確認します。
| フェーズ | 注目領域 |
|---|---|
| UNDERSTAND | データ構造、型定義 |
| PLAN | アーキテクチャの決定事項、成功指標 |
| EXECUTE | ストレージ、学習、MCP 機能 |
| REVIEW | FR1-FR7、NFR1-NFR6 のテスト |
| SECURE | 攻撃対象領域、緩和策 |
| FEEDBACK | エッジケース、最適化 |
フェーズ 4：優先順位付け
重大（本番環境への導入を妨げるもの）：
- セキュリティの脆弱性
- データ破損のリスク
- コア機能の不足
高（品質に影響するもの）：
- パフォーマンス目標の未達
- テストカバレッジが目標未満
- エラーハンドリングの不足
中（技術的負債）：
- コード品質の問題
- ドキュメントの不足
フェーズ 5：TODO の生成
## Phase [N]: [NAME]
### Critical Priority
- [ ] [Component] - [Missing item]
- File: path/to/file.rs
- Plan: plans/0X-phase.md:LineNumber
- Impact: [Description]
- Effort: [Estimate]
出力形式
# Plan Gap Analysis Report
**Total Requirements**: X
**Implemented**: Y (Z%)
**Gaps Identified**: N
## By Phase
- Phase 1: X/Y complete
- Phase 2: X/Y complete
- ...
## Critical Gaps
1. [Gap] - Priority, Effort
ベストプラクティス
✓ 系統的に確認する：すべての要件をチェックします
✓ 具体的に記載する：正確なファイルの場所を示します
✓ 正確に確認する：推測せず、検証します
✓ 優先順位を付ける：重大 > 高 > 中 > 低
✓ 実行可能にする：ファイルパスと見積もりを記載します
コメント
Markdown 対応