mcp-probe-kit 2.0.0 → 2.0.1

package/docs/specs/v2.1-planning.md

@@ -0,0 +1,335 @@
+# MCP Probe Kit v2.1 版本规划
+
+## 📋 版本信息
+
+**版本号**: 2.1.0  
+**计划发布**: 2026-02-15  
+**当前状态**: 📝 规划中  
+**上一版本**: 2.0.0 (2026-01-27)
+
+---
+
+## 🎯 版本目标
+
+v2.1 版本聚焦于**优化开发体验**和**提升文档质量**，主要改进项目上下文管理和文档组织方式。
+
+**核心主题**: 模块化与效率提升
+
+---
+
+## ✨ 主要特性
+
+### 1. 模块化项目上下文 (project-context-modular)
+
+**优先级**: P1  
+**状态**: 📝 规格设计完成  
+**预估工作量**: 5 故事点（9-14 小时）
+
+#### 功能描述
+
+改进 `init_project_context` 工具，支持生成模块化的项目上下文文档。
+
+**核心改进**：
+- 将单一的 `project-context.md` 拆分为索引文件 + 5 个分类文档
+- 按需加载，减少 AI 上下文压力
+- 保持向后兼容，默认使用单文件模式
+
+**文档结构**：
+```
+docs/
+├── project-context.md          # 索引文件
+└── project-context/            # 分类文档
+    ├── tech-stack.md           # 技术栈
+    ├── architecture.md         # 架构
+    ├── coding-standards.md     # 编码规范
+    ├── dependencies.md         # 依赖
+    └── workflows.md            # 工作流
+```
+
+**使用方式**：
+```bash
+# 单文件模式（默认，向后兼容）
+init_project_context
+
+# 模块化模式（新功能）
+init_project_context mode=modular
+```
+
+**规格文档**: [docs/specs/project-context-modular/](./project-context-modular/)
+
+---
+
+## 📊 工作量估算
+
+### 总体估算
+
+| 特性 | 故事点 | 预估时间 | 优先级 |
+|------|--------|----------|--------|
+| project-context-modular | 5 | 9-14h | P1 |
+| **总计** | **5** | **9-14h** | |
+
+### 时间分配
+
+| 阶段 | 时间 | 占比 |
+|------|------|------|
+| 开发 | 6-8h | 60% |
+| 测试 | 2-3h | 25% |
+| 文档 | 1-2h | 12% |
+| 验收 | 0.5-1h | 5% |
+
+---
+
+## 📅 开发计划
+
+### 里程碑
+
+| 里程碑 | 日期 | 内容 |
+|--------|------|------|
+| M1: 规格完成 | 2026-01-27 ✅ | 需求、设计、任务文档完成 |
+| M2: 开发完成 | 2026-01-30 | 核心功能实现，测试通过 |
+| M3: 文档完成 | 2026-02-03 | README、在线文档更新 |
+| M4: 发布准备 | 2026-02-10 | 最终测试、CHANGELOG |
+| M5: 正式发布 | 2026-02-15 | npm 发布，文档上线 |
+
+### 详细时间线
+
+#### Week 1 (2026-01-27 - 2026-02-02)
+
+**Day 1-2: 核心开发**
+- [ ] 创建模板文件（6个）
+- [ ] 实现项目信息分析函数
+- [ ] 实现模板渲染和文件生成
+- [ ] 添加 mode 参数支持
+
+**Day 3: 测试和优化**
+- [ ] 编写单元测试
+- [ ] 编写集成测试
+- [ ] 性能优化
+- [ ] 错误处理
+
+#### Week 2 (2026-02-03 - 2026-02-09)
+
+**Day 1-2: 文档更新**
+- [ ] 更新 README.md
+- [ ] 更新在线文档
+- [ ] 添加使用示例
+- [ ] 更新 CHANGELOG
+
+**Day 3-4: 验收和测试**
+- [ ] 手动测试（多种项目类型）
+- [ ] 兼容性测试
+- [ ] 性能测试
+- [ ] 代码审查
+
+#### Week 3 (2026-02-10 - 2026-02-15)
+
+**Day 1-2: 发布准备**
+- [ ] 最终测试
+- [ ] 版本号更新
+- [ ] 构建和打包
+- [ ] 发布说明
+
+**Day 3: 正式发布**
+- [ ] npm 发布
+- [ ] 文档网站更新
+- [ ] GitHub Release
+- [ ] 社区通知
+
+---
+
+## 🎯 成功指标
+
+### 功能指标
+
+- [ ] 模块化模式正常工作
+- [ ] 单文件模式保持兼容
+- [ ] 文档独立完整
+- [ ] 性能满足要求（< 2秒）
+
+### 质量指标
+
+- [ ] 代码覆盖率 > 80%
+- [ ] 所有测试通过
+- [ ] 无严重 Bug
+- [ ] 向后兼容 100%
+
+### 用户体验指标
+
+- [ ] 文档清晰易懂
+- [ ] 使用简单直观
+- [ ] 错误提示友好
+- [ ] 性能体验良好
+
+---
+
+## ⚠️ 风险管理
+
+### 主要风险
+
+| 风险 | 影响 | 概率 | 缓解措施 | 负责人 |
+|------|------|------|----------|--------|
+| 向后兼容性破坏 | 高 | 低 | 默认单文件模式，充分测试 | 开发团队 |
+| 发布延期 | 中 | 中 | 预留缓冲时间，简化非核心功能 | PM |
+| 用户接受度低 | 中 | 低 | 提供清晰文档，保持可选性 | 产品团队 |
+
+### 应急计划
+
+**如果开发延期**：
+- 优先保证核心功能（模块化模式）
+- 简化测试范围（仅核心流程）
+- 延后文档更新（可在 2.1.1 补充）
+
+**如果发现严重 Bug**：
+- 立即修复并重新测试
+- 延后发布日期
+- 发布 Hotfix 版本
+
+---
+
+## 📝 发布说明（草稿）
+
+### v2.1.0 - 模块化与效率提升
+
+**发布日期**: 2026-02-15
+
+#### 🎉 新特性
+
+**模块化项目上下文**
+- 支持生成模块化的项目上下文文档
+- 将项目信息分类到 5 个独立文档
+- 提供索引文件进行导航
+- 按需加载，减少 AI 上下文压力
+
+#### 🔧 改进
+
+- 优化文档组织方式
+- 提升大型项目的分析性能
+- 改进错误提示信息
+
+#### 🐛 修复
+
+- 修复 xxx 问题
+- 修复 xxx 问题
+
+#### 📚 文档
+
+- 更新 README.md
+- 更新在线文档
+- 添加模块化模式使用指南
+
+#### ⚠️ 破坏性变更
+
+无。本版本完全向后兼容。
+
+#### 🔄 迁移指南
+
+无需迁移。默认行为保持不变。
+
+如需使用新的模块化模式：
+```bash
+init_project_context mode=modular
+```
+
+---
+
+## 🔗 相关资源
+
+### 规格文档
+- [project-context-modular 规格](./project-context-modular/)
+  - [需求文档](./project-context-modular/requirements.md)
+  - [设计文档](./project-context-modular/design.md)
+  - [任务清单](./project-context-modular/tasks.md)
+  - [工作量估算](./project-context-modular/estimate.md)
+
+### 项目文档
+- [README.md](../../README.md)
+- [CHANGELOG.md](../../CHANGELOG.md)
+- [在线文档](https://mcp-probe-kit.bytezonex.com)
+
+### 开发资源
+- [GitHub Repository](https://github.com/mybolide/mcp-probe-kit)
+- [npm Package](https://www.npmjs.com/package/mcp-probe-kit)
+- [Issue Tracker](https://github.com/mybolide/mcp-probe-kit/issues)
+
+---
+
+## 📞 团队协作
+
+### 角色分工
+
+| 角色 | 负责人 | 职责 |
+|------|--------|------|
+| 产品经理 | - | 需求管理、优先级决策 |
+| 技术负责人 | - | 技术方案、代码审查 |
+| 开发工程师 | - | 功能实现、单元测试 |
+| 测试工程师 | - | 测试计划、质量保证 |
+| 文档工程师 | - | 文档编写、示例代码 |
+
+### 沟通机制
+
+- **每日站会**: 同步进度，识别阻塞
+- **周会**: 回顾进展，调整计划
+- **代码审查**: 所有代码必须经过审查
+- **文档审查**: 所有文档必须经过审查
+
+---
+
+## 📈 后续规划
+
+### v2.2 候选特性
+
+- 支持自定义文档模板
+- 支持多语言文档生成
+- 支持文档自动更新
+- 集成到 CI/CD 流程
+
+### 长期规划
+
+- 构建完整的项目知识库
+- 支持团队协作和共享
+- 集成更多 AI 工具
+- 提供可视化界面
+
+---
+
+## ✅ 检查清单
+
+### 开发前
+
+- [x] 需求文档完成
+- [x] 设计文档完成
+- [x] 任务清单完成
+- [x] 工作量估算完成
+- [ ] 技术方案评审通过
+- [ ] 资源分配确认
+
+### 开发中
+
+- [ ] 代码实现完成
+- [ ] 单元测试通过
+- [ ] 集成测试通过
+- [ ] 代码审查通过
+- [ ] 性能测试通过
+
+### 发布前
+
+- [ ] 文档更新完成
+- [ ] CHANGELOG 更新
+- [ ] 版本号更新
+- [ ] 最终测试通过
+- [ ] 发布说明准备
+
+### 发布后
+
+- [ ] npm 发布成功
+- [ ] 文档网站更新
+- [ ] GitHub Release 创建
+- [ ] 社区通知发送
+- [ ] 监控用户反馈
+
+---
+
+*规划版本: 1.0.0*  
+*创建时间: 2026-01-27*  
+*维护者: MCP Probe Kit Team*  
+*状态: 规划中*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "AI-Powered Development Toolkit - MCP Server with 39 practical tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "type": "module",
   "main": "build/index.js",
@@ -63,7 +63,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3"
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "tar": "^7.5.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -71,7 +72,6 @@
     "@vitest/ui": "^4.0.18",
     "csv-parse": "^6.1.0",
     "fast-check": "^4.5.3",
-    "tar": "^7.5.6",
     "tsx": "^4.21.0",
     "typescript": "^5.3.0",
     "vitest": "^4.0.18"