mcpField
P
plan-gap-analysis

plan-gap-analysis

github.com/d-o-hub测试与质量1341 次安装今天更新
代码仓库

关于 plan-gap-analysis

plan-gap-analysis 是用于对照 plans/ 文档与实际代码的分析技能，面向审查项目实现与需求覆盖情况的开发者。它按阶段盘点、识别并排序差距，并生成带文件位置和影响说明的待办报告。

主要功能

  1. 01盘点计划文档与代码文件
  2. 02按项目阶段检查需求
  3. 03识别并排序实现差距
  4. 04生成带路径的待办报告

适用场景

  1. 01核对架构计划与代码实现
  2. 02检查安全要求和测试覆盖
  3. 03整理待处理的实现缺口

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/d-o-hub/rust-self-learning-memory --skill plan-gap-analysis

安装后在 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/*"

要分析的 Crate：

  • do-memory-core - 核心数据结构和编排
  • do-memory-storage-turso - Turso/libSQL 后端
  • do-memory-storage-redb - redb 缓存层
  • do-memory-mcp - MCP 服务和沙箱
  • do-memory-test-utils - 测试工具
  • benches - 性能基准测试
阶段 3：差距识别

检查各个阶段：

阶段重点领域
理解数据结构、类型定义
计划架构决策、成功指标
执行存储、学习、MCP 功能
审查FR1-FR7、NFR1-NFR6 测试
安全攻击面、缓解措施
反馈边缘情况、优化
阶段 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