mcp-probe-kit 3.0.3 → 3.0.6

package/docs/specs/git-work-report/tasks.md

@@ -1,197 +0,0 @@
-# 任务清单：git-work-report
-
-## 概述
-
-实现 git-work-report 功能的任务分解。按照 MCP Probe Kit 的开发流程，分为准备、实现、测试、文档四个阶段。
-
----
-
-## 任务列表
-
-### 阶段 1: 准备工作
-
-- [ ] 1.1 创建工具实现文件
-  - 在 `src/tools/` 目录创建 `git_work_report.ts`
-  - 添加基本的文件结构和导入语句
-  - _需求: 所有需求的基础_
-
-- [ ] 1.2 定义 TypeScript 接口
-  - 定义 `GitWorkReportArgs` 接口
-  - 定义内部数据结构（`CommitInfo`, `DateRange`）
-  - _需求: 需求 1, 2, 5_
-
-- [ ] 1.3 添加工具 Schema
-  - 在 `src/schemas/git-tools.ts` 添加 `gitWorkReportSchema`
-  - 定义输入参数的 JSON Schema
-  - 在 `src/schemas/index.ts` 导出 Schema
-  - _需求: 所有需求_
-
----
-
-### 阶段 2: 核心实现
-
-- [ ] 2.1 实现参数验证函数
-  - 实现 `validateArgs()` 函数
-  - 验证日期参数是否提供
-  - 验证日期格式 (YYYY-MM-DD)
-  - 检查参数冲突（日报 vs 周期报）
-  - 验证日期范围合理性
-  - _需求: 需求 5_
-
-- [ ] 2.2 实现 Git 命令执行
-  - 导入 `child_process` 和 `promisify`
-  - 实现 `getCommitList()` 函数（执行 git log）
-  - 实现 `getCommitDiff()` 函数（执行 git show）
-  - 添加命令执行错误处理
-  - _需求: 需求 1, 2, 3_
-
-- [ ] 2.3 实现日期范围构建
-  - 实现 `buildDateRange()` 函数
-  - 处理日报模式（单个日期）
-  - 处理周期报模式（日期范围）
-  - 格式化为 Git 命令所需的时间格式
-  - _需求: 需求 1, 2_
-
-- [ ] 2.4 实现 Diff 内容聚合
-  - 遍历提交列表
-  - 并发获取每个提交的 diff（使用 Promise.all）
-  - 聚合所有 diff 内容
-  - 处理无提交的情况
-  - _需求: 需求 1, 2, 3_
-
-- [ ] 2.5 实现 AI 分析提示构建
-  - 实现 `buildAnalysisPrompt()` 函数
-  - 组装 diff 内容
-  - 添加分析要求和输出格式说明
-  - 提供输出示例
-  - _需求: 需求 3, 4_
-
-- [ ] 2.6 实现输出文件写入
-  - 实现 `writeOutputFile()` 函数
-  - 使用 `fs/promises` 的 `writeFile` 和 `mkdir`
-  - 自动创建目录（如果不存在）
-  - 添加文件写入错误处理
-  - _需求: 需求 6_
-
-- [ ] 2.7 实现主函数 `gitWorkReport()`
-  - 整合所有子函数
-  - 实现完整的工作流程
-  - 使用 `formatResponse()` 格式化输出
-  - 添加 try-catch 错误处理
-  - _需求: 所有需求_
-
-- [ ] 2.8 导出工具
-  - 在 `src/tools/index.ts` 导出 `gitWorkReport`
-  - _需求: 所有需求_
-
-- [ ] 2.9 注册到 MCP 服务器
-  - 在 `src/index.ts` 的 `CallToolRequestSchema` 处理器中添加路由
-  - 添加 `case "git_work_report"` 分支
-  - _需求: 所有需求_
-
----
-
-### 阶段 3: 测试
-
-- [ ] 3.1 编写单元测试
-  - 创建 `src/tools/__tests__/git_work_report.test.ts`
-  - 测试参数验证逻辑
-  - 测试日期格式验证
-  - 测试无提交情况
-  - 测试错误处理
-  - _需求: 所有需求_
-
-- [ ] 3.2 本地集成测试
-  - 编译代码 (`npm run build`)
-  - 使用 MCP Inspector 测试工具
-  - 测试日报模式
-  - 测试周期报模式
-  - 测试输出文件功能
-  - 测试各种边界情况
-  - _需求: 所有需求_
-
-- [ ] 3.3 实际项目测试
-  - 在真实 Git 仓库中测试
-  - 验证 diff 分析的准确性
-  - 验证输出格式符合要求
-  - 收集用户反馈
-  - _需求: 需求 3, 4_
-
----
-
-### 阶段 4: 文档和发布
-
-- [ ] 4.1 更新项目文档
-  - 在 `README.md` 的工具列表中添加 `git_work_report`
-  - 添加使用示例
-  - 更新工具数量统计
-  - _需求: 所有需求_
-
-- [ ] 4.2 更新网站文档
-  - 在 `docs/data/tools.js` 添加工具信息
-  - 在 `docs/pages/all-tools.html` 添加工具说明
-  - 添加使用示例
-  - _需求: 所有需求_
-
-- [ ] 4.3 更新 CHANGELOG
-  - 在 `CHANGELOG.md` 添加新功能说明
-  - 记录版本号和发布日期
-  - _需求: 所有需求_
-
-- [ ] 4.4 代码审查
-  - 检查代码风格一致性
-  - 检查错误处理完整性
-  - 检查类型定义准确性
-  - 检查注释和文档完整性
-  - _需求: 所有需求_
-
----
-
-## 检查点
-
-- [ ] 阶段 1 完成后：文件结构创建完成，Schema 定义正确
-- [ ] 阶段 2 完成后：核心功能实现完成，可以编译通过
-- [ ] 阶段 3 完成后：所有测试通过，功能验证正确
-- [ ] 阶段 4 完成后：文档更新完成，准备发布
-
----
-
-## 文件变更清单
-
-| 文件 | 操作 | 说明 |
-|------|------|------|
-| `src/tools/git_work_report.ts` | 新建 | 工具实现主文件 |
-| `src/tools/__tests__/git_work_report.test.ts` | 新建 | 单元测试文件 |
-| `src/tools/index.ts` | 修改 | 导出新工具 |
-| `src/schemas/git-tools.ts` | 修改 | 添加工具 Schema |
-| `src/schemas/index.ts` | 修改 | 导出新 Schema |
-| `src/index.ts` | 修改 | 注册工具路由 |
-| `docs/specs/git-work-report/requirements.md` | 新建 | 需求文档 |
-| `docs/specs/git-work-report/design.md` | 新建 | 设计文档 |
-| `docs/specs/git-work-report/tasks.md` | 新建 | 任务清单（本文件） |
-| `docs/data/tools.js` | 修改 | 添加工具信息 |
-| `docs/pages/all-tools.html` | 修改 | 添加工具说明 |
-| `README.md` | 修改 | 更新工具列表和示例 |
-| `CHANGELOG.md` | 修改 | 添加版本更新记录 |
-
----
-
-## 预估工作量
-
-| 阶段 | 预估时间 | 说明 |
-|------|---------|------|
-| 阶段 1: 准备工作 | 0.5 小时 | 创建文件和定义接口 |
-| 阶段 2: 核心实现 | 3-4 小时 | 实现所有功能逻辑 |
-| 阶段 3: 测试 | 2-3 小时 | 编写测试和验证功能 |
-| 阶段 4: 文档和发布 | 1-2 小时 | 更新文档和代码审查 |
-| **总计** | **7-10 小时** | 中级开发者预估 |
-
----
-
-## 检查清单
-
-- [x] 任务分阶段合理
-- [x] 每项任务可执行且可验证
-- [x] 任务与需求一一对应
-- [x] 文件变更清单完整
-- [x] 工作量预估合理