mcp-probe-kit 1.15.1 → 2.0.0

package/docs/specs/vnext-upgrade/tasks/M8.7-HELPER-TOOLS.md

@@ -0,0 +1,24 @@
+# M8.7: 辅助工具迁移
+
+## 📊 任务概览
+
+| 项目 | 信息 |
+|------|------|
+| 任务编号 | M8.7 |
+| 故事点 | 4 |
+| 预估时间 | 3-5 天 |
+| 工具数 | 3 个 |
+| 测试数 | 9 个（每工具 3 个）|
+| 状态 | 🔴 未开始 |
+
+---
+
+## 📋 工具列表
+
+1. **detect_shell** - 检测 Shell 环境
+2. **init_setting** - 初始化设置
+3. **gen_skill** - 生成技能文档
+
+---
+
+**[返回任务索引](./00-INDEX.md)** | **[下一个: M8.8](./M8.8-INTEGRATION-TESTS.md)**

package/docs/specs/vnext-upgrade/tasks/M8.8-INTEGRATION-TESTS.md

@@ -0,0 +1,90 @@
+# M8.8: 完整集成测试
+
+## 📊 任务概览
+
+| 项目 | 信息 |
+|------|------|
+| 任务编号 | M8.8 |
+| 故事点 | 6 |
+| 预估时间 | 1 周 |
+| 优先级 | P0 |
+| 依赖 | M8.5 ✅ |
+| 状态 | 🟢 可以开始 |
+
+---
+
+## 🎯 任务目标
+
+为所有 37 个新工具添加契约测试，确保 100% 覆盖。
+
+**状态更新**: ✅ 所有契约测试已完成（142/142 测试通过）
+
+---
+
+## 📋 测试统计（已更新）
+
+| 工具组 | 工具数 | 每工具测试数 | 总测试数 | 状态 |
+|--------|--------|--------------|----------|------|
+| P0 工具 | 6 | 4 | 24 | ✅ 100% |
+| P1 工具 | 7 | 4 | 28 | ✅ 100% |
+| 生成工具 | 7 | 4 | 28 | ✅ 100% |
+| 编排工具 | 5 | 4 | 20 | ✅ 100% |
+| 项目管理 | 7 | 3 | 21 | ✅ 100% |
+| UI/UX 工具 | 5 | 4-5 | 21 | ✅ 100% |
+| **总计** | **37** | - | **142** | **✅ 100%** |
+
+**注**: 原计划 43 个工具，已清理 10 个过时工具，剩余 37 个（包含 6 个 P0 工具已完成）
+
+---
+
+## 📝 测试任务
+
+### ✅ 1. 契约测试框架（已完成）
+
+所有 37 个工具的契约测试已添加到 `tests/contracts/structured-output.test.ts`。
+
+### ✅ 2. Schema 验证（已完成）
+
+所有工具返回的数据都符合 Schema 定义，包含 `_meta.schema` 字段。
+
+### ✅ 3. 向后兼容性（已完成）
+
+所有工具都返回 `content.text`，旧客户端可以正常使用。
+
+### ✅ 4. 完整测试套件（已完成）
+
+```bash
+npm test
+```
+
+**测试结果**: 142/142 契约测试通过 ✅
+
+---
+
+## ✅ 验收标准（已达成）
+
+- [x] 所有 142 个契约测试通过 ✅
+- [x] Schema 验证 100% 通过 ✅
+- [x] 向后兼容性 100% ✅
+- [x] TypeScript 类型检查通过 ✅
+- [x] 所有集成测试通过 ✅
+- [x] 代码覆盖率 > 80% ✅
+
+---
+
+## 🎉 完成总结
+
+M8.8 集成测试任务已全部完成！所有 37 个工具的契约测试（142 个测试）全部通过，达到 100% 覆盖率。
+
+**关键成果**:
+- ✅ 142 个契约测试全部通过
+- ✅ 所有工具正确实现结构化输出
+- ✅ 所有工具包含 `_meta.schema` 字段
+- ✅ 向后兼容性 100%
+- ✅ TypeScript 编译通过
+
+**下一步**: M8.9 文档完善
+
+---
+
+**[返回任务索引](./00-INDEX.md)** | **[下一个: M8.9](./M8.9-DOCUMENTATION.md)**

package/docs/specs/vnext-upgrade/tasks/M8.9-DOCUMENTATION.md

@@ -0,0 +1,103 @@
+# M8.9: 文档完善
+
+## 📊 任务概览
+
+| 项目 | 信息 |
+|------|------|
+| 任务编号 | M8.9 |
+| 故事点 | 6 |
+| 预估时间 | 1 周 |
+| 优先级 | P0 |
+| 依赖 | M8.8 ✅ |
+| 状态 | 🟡 可以开始 |
+
+---
+
+## 🎯 任务目标
+
+更新所有文档，添加所有 37 个工具的使用示例和 Schema 说明。
+
+**注**: 原计划 43 个工具，已清理 10 个过时工具，剩余 37 个（包含 6 个 P0 工具）
+
+---
+
+## 📋 文档任务
+
+### 1. 更新核心文档
+
+#### docs/STRUCTURED_OUTPUT.md
+- [ ] 添加所有 37 个工具的示例
+- [ ] 更新 Schema 定义说明
+- [ ] 添加最佳实践
+- [ ] 添加故障排查指南
+
+#### README.md
+- [ ] 更新工具列表（37 个工具，已清理 10 个）
+- [ ] 添加结构化输出说明
+- [ ] 更新使用示例
+- [ ] 更新特性列表
+- [ ] 添加 vNext 升级说明
+
+#### CHANGELOG.md
+- [ ] 详细记录所有变更
+- [ ] 列出所有新增的 Schema
+- [ ] 说明向后兼容性
+- [ ] 添加迁移指南链接
+
+---
+
+### 2. 完善文档站
+
+#### docs/index.html
+- [ ] 更新首页内容
+- [ ] 添加结构化输出介绍
+
+#### 新增页面
+- [ ] `pages/all-tools.html` - 所有工具参考
+- [ ] `pages/schemas.html` - Schema 完整参考
+- [ ] `pages/migration.html` - 迁移指南
+- [ ] `pages/examples.html` - 使用示例
+
+---
+
+### 3. 创建工具分类文档
+
+#### docs/tools/ 目录
+- [ ] `P1-HIGH-VALUE.md` - P1 工具文档
+- [ ] `GENERATION.md` - 生成工具文档
+- [ ] `ORCHESTRATION.md` - 编排工具文档
+- [ ] `PROJECT-MANAGEMENT.md` - 项目管理工具文档
+- [ ] `UI-UX.md` - UI/UX 工具文档
+
+---
+
+### 4. 更新工具清单
+
+#### tools-manifest.json
+- [ ] 更新 `structuredOutput.tools` 列表
+- [ ] 更新 `structuredOutput.schemas` 映射
+- [ ] 更新覆盖率统计
+
+---
+
+## ✅ 验收标准
+
+- [ ] 所有核心文档更新完成
+- [ ] 每个工具都有使用示例
+- [ ] Schema 文档完整
+- [ ] 文档站页面完整
+- [ ] 迁移指南清晰
+- [ ] 工具清单准确
+
+---
+
+## 📦 产出物
+
+1. **更新的核心文档**（3 个）
+2. **文档站页面**（4 个新页面）
+3. **工具分类文档**（5 个）
+4. **更新的工具清单**
+
+---
+
+**[返回任务索引](./00-INDEX.md)**