@liangjie559567/ultrapower 5.6.5 → 5.6.7

package/docs/plans/2026-03-05-mcp-adoption-atomic-tasks.md

@@ -9,6 +9,7 @@
 ## 阶段 1：MCP 服务器包装器（Week 1-2）
 
 ### 1.1.1 安装 MCP SDK 依赖
+
 **父任务：** 1.1 搭建 MCP 服务器框架
 **预计时间：** 30 分钟
 **负责人：** executor (haiku)
@@ -20,14 +21,17 @@ npm install --save-dev @types/node
 ```
 
 **验收：**
-- [ ] package.json 包含 `@modelcontextprotocol/sdk`
-- [ ] `npm run build` 成功
+
+* [ ] package.json 包含 `@modelcontextprotocol/sdk`
+
+* [ ] `npm run build` 成功
 
 **输出：** `package.json`, `package-lock.json`
 
 ---
 
 ### 1.1.2 创建 MCP 服务器入口文件
+
 **父任务：** 1.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -40,15 +44,19 @@ npm install --save-dev @types/node
 4. 设置 capabilities: { tools: {} }
 
 **验收：**
-- [ ] 文件创建成功
-- [ ] TypeScript 编译通过
-- [ ] 导出 server 实例
+
+* [ ] 文件创建成功
+
+* [ ] TypeScript 编译通过
+
+* [ ] 导出 server 实例
 
 **输出：** `src/mcp/ultrapower-mcp-server.ts`
 
 ---
 
 ### 1.1.3 实现 stdio 传输层
+
 **父任务：** 1.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -61,15 +69,19 @@ npm install --save-dev @types/node
 4. 添加优雅退出（process.on('SIGINT')）
 
 **验收：**
-- [ ] 可通过 `node dist/mcp/ultrapower-mcp-server.js` 启动
-- [ ] 响应 stdin 输入
-- [ ] 错误不导致进程崩溃
+
+* [ ] 可通过 `node dist/mcp/ultrapower-mcp-server.js` 启动
+
+* [ ] 响应 stdin 输入
+
+* [ ] 错误不导致进程崩溃
 
 **输出：** `src/mcp/ultrapower-mcp-server.ts`（更新）
 
 ---
 
 ### 1.1.4 添加日志系统
+
 **父任务：** 1.1
 **预计时间：** 30 分钟
 **负责人：** executor (haiku)
@@ -82,15 +94,19 @@ npm install --save-dev @types/node
 4. 支持 `MCP_LOG_LEVEL` 环境变量
 
 **验收：**
-- [ ] 日志输出到 stderr
-- [ ] 日志级别可配置
-- [ ] 不影响 MCP 协议通信
+
+* [ ] 日志输出到 stderr
+
+* [ ] 日志级别可配置
+
+* [ ] 不影响 MCP 协议通信
 
 **输出：** `src/mcp/logger.ts`
 
 ---
 
 ### 1.1.5 编写 MCP 服务器启动测试
+
 **父任务：** 1.1
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -103,14 +119,17 @@ npm install --save-dev @types/node
 4. 测试 capabilities 返回
 
 **验收：**
-- [ ] 测试通过
-- [ ] 覆盖率 >80%
+
+* [ ] 测试通过
+
+* [ ] 覆盖率 >80%
 
 **输出：** `src/mcp/__tests__/server-startup.test.ts`
 
 ---
 
 ### 1.2.1 创建工具类型定义
+
 **父任务：** 1.2 实现工具转换适配器
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -123,15 +142,19 @@ npm install --save-dev @types/node
 4. 定义转换函数签名
 
 **验收：**
-- [ ] 类型定义完整
-- [ ] 符合 MCP 规范
-- [ ] TypeScript 编译通过
+
+* [ ] 类型定义完整
+
+* [ ] 符合 MCP 规范
+
+* [ ] TypeScript 编译通过
 
 **输出：** `src/mcp/types.ts`
 
 ---
 
 ### 1.2.2 实现 LSP 工具转换（12 个）
+
 **父任务：** 1.2
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -146,15 +169,19 @@ npm install --save-dev @types/node
 6. 转换 lsp_code_actions, lsp_code_action_resolve
 
 **验收：**
-- [ ] 12 个 LSP 工具全部转换
-- [ ] inputSchema 符合 JSON Schema
-- [ ] 保留原有参数结构
+
+* [ ] 12 个 LSP 工具全部转换
+
+* [ ] inputSchema 符合 JSON Schema
+
+* [ ] 保留原有参数结构
 
 **输出：** `src/mcp/adapters/lsp-adapter.ts`
 
 ---
 
 ### 1.2.3 实现 AST 工具转换（2 个）
+
 **父任务：** 1.2
 **预计时间：** 30 分钟
 **负责人：** executor (haiku)
@@ -166,14 +193,17 @@ npm install --save-dev @types/node
 3. 转换 ast_grep_replace
 
 **验收：**
-- [ ] 2 个 AST 工具转换完成
-- [ ] 支持元变量语法
+
+* [ ] 2 个 AST 工具转换完成
+
+* [ ] 支持元变量语法
 
 **输出：** `src/mcp/adapters/ast-adapter.ts`
 
 ---
 
 ### 1.2.4 实现 Python REPL 工具转换（1 个）
+
 **父任务：** 1.2
 **预计时间：** 20 分钟
 **负责人：** executor (haiku)
@@ -184,13 +214,15 @@ npm install --save-dev @types/node
 2. 转换 python_repl
 
 **验收：**
-- [ ] python_repl 转换完成
+
+* [ ] python_repl 转换完成
 
 **输出：** `src/mcp/adapters/python-adapter.ts`
 
 ---
 
 ### 1.2.5 实现 Notepad 工具转换（6 个）
+
 **父任务：** 1.2
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -203,13 +235,15 @@ npm install --save-dev @types/node
 4. 转换 notepad_prune, notepad_stats
 
 **验收：**
-- [ ] 6 个 Notepad 工具转换完成
+
+* [ ] 6 个 Notepad 工具转换完成
 
 **输出：** `src/mcp/adapters/notepad-adapter.ts`
 
 ---
 
 ### 1.2.6 实现 State 工具转换（5 个）
+
 **父任务：** 1.2
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -221,13 +255,15 @@ npm install --save-dev @types/node
 3. 转换 state_list_active, state_get_status
 
 **验收：**
-- [ ] 5 个 State 工具转换完成
+
+* [ ] 5 个 State 工具转换完成
 
 **输出：** `src/mcp/adapters/state-adapter.ts`
 
 ---
 
 ### 1.2.7 实现 ProjectMemory 工具转换（4 个）
+
 **父任务：** 1.2
 **预计时间：** 45 分钟
 **负责人：** executor (sonnet)
@@ -239,13 +275,15 @@ npm install --save-dev @types/node
 3. 转换 project_memory_add_note, project_memory_add_directive
 
 **验收：**
-- [ ] 4 个 ProjectMemory 工具转换完成
+
+* [ ] 4 个 ProjectMemory 工具转换完成
 
 **输出：** `src/mcp/adapters/memory-adapter.ts`
 
 ---
 
 ### 1.2.8 实现 Trace 工具转换（2 个）
+
 **父任务：** 1.2
 **预计时间：** 30 分钟
 **负责人：** executor (haiku)
@@ -256,13 +294,15 @@ npm install --save-dev @types/node
 2. 转换 trace_timeline, trace_summary
 
 **验收：**
-- [ ] 2 个 Trace 工具转换完成
+
+* [ ] 2 个 Trace 工具转换完成
 
 **输出：** `src/mcp/adapters/trace-adapter.ts`
 
 ---
 
 ### 1.2.9 实现 Skills 工具转换（3 个）
+
 **父任务：** 1.2
 **预计时间：** 30 分钟
 **负责人：** executor (haiku)
@@ -274,13 +314,15 @@ npm install --save-dev @types/node
 3. 转换 list_omc_skills
 
 **验收：**
-- [ ] 3 个 Skills 工具转换完成
+
+* [ ] 3 个 Skills 工具转换完成
 
 **输出：** `src/mcp/adapters/skills-adapter.ts`
 
 ---
 
 ### 1.2.10 创建统一适配器入口
+
 **父任务：** 1.2
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -293,15 +335,19 @@ npm install --save-dev @types/node
 4. 实现 `getAllMCPTools()` 函数
 
 **验收：**
-- [ ] 返回 35 个工具
-- [ ] 工具分类正确
-- [ ] 无重复工具名
+
+* [ ] 返回 35 个工具
+
+* [ ] 工具分类正确
+
+* [ ] 无重复工具名
 
 **输出：** `src/mcp/tool-adapter.ts`
 
 ---
 
 ### 1.2.11 编写工具转换单元测试
+
 **父任务：** 1.2
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -314,15 +360,17 @@ npm install --save-dev @types/node
 4. 测试工具描述完整性
 
 **验收：**
-- [ ] 覆盖率 >80%
-- [ ] 所有测试通过
+
+* [ ] 覆盖率 >80%
+
+* [ ] 所有测试通过
 
 **输出：** `src/mcp/__tests__/tool-adapter.test.ts`
 
 ---
 
-
 ### 1.3.1 实现工具名称解析器
+
 **父任务：** 1.3 实现工具调用路由
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -336,15 +384,19 @@ npm install --save-dev @types/node
 5. 支持命名空间：`ultrapower:lsp_hover`
 
 **验收：**
-- [ ] 三种格式都能正确解析
-- [ ] 返回统一的工具实现
-- [ ] 未找到时返回明确错误
+
+* [ ] 三种格式都能正确解析
+
+* [ ] 返回统一的工具实现
+
+* [ ] 未找到时返回明确错误
 
 **输出：** `src/mcp/tool-resolver.ts`
 
 ---
 
 ### 1.3.2 实现工具调用处理器
+
 **父任务：** 1.3
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -358,15 +410,19 @@ npm install --save-dev @types/node
 5. 格式化返回结果
 
 **验收：**
-- [ ] 成功调用现有工具
-- [ ] 参数正确传递
-- [ ] 返回格式符合 MCP 规范
+
+* [ ] 成功调用现有工具
+
+* [ ] 参数正确传递
+
+* [ ] 返回格式符合 MCP 规范
 
 **输出：** `src/mcp/tool-router.ts`
 
 ---
 
 ### 1.3.3 添加错误处理
+
 **父任务：** 1.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -380,15 +436,19 @@ npm install --save-dev @types/node
 5. 返回结构化错误信息
 
 **验收：**
-- [ ] 错误信息清晰可调试
-- [ ] 包含错误类型和堆栈
-- [ ] 不暴露敏感信息
+
+* [ ] 错误信息清晰可调试
+
+* [ ] 包含错误类型和堆栈
+
+* [ ] 不暴露敏感信息
 
 **输出：** `src/mcp/tool-router.ts`（更新）
 
 ---
 
 ### 1.3.4 实现超时保护
+
 **父任务：** 1.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -401,15 +461,19 @@ npm install --save-dev @types/node
 4. 支持 `MCP_TOOL_TIMEOUT` 环境变量
 
 **验收：**
-- [ ] 超时后抛出明确错误
-- [ ] 不阻塞其他请求
-- [ ] 超时时间可配置
+
+* [ ] 超时后抛出明确错误
+
+* [ ] 不阻塞其他请求
+
+* [ ] 超时时间可配置
 
 **输出：** `src/mcp/timeout.ts`
 
 ---
 
 ### 1.3.5 集成到 MCP 服务器
+
 **父任务：** 1.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -422,15 +486,19 @@ npm install --save-dev @types/node
 4. 添加请求日志
 
 **验收：**
-- [ ] 工具列表请求返回 35 个工具
-- [ ] 工具调用请求正确路由
-- [ ] 日志记录请求和响应
+
+* [ ] 工具列表请求返回 35 个工具
+
+* [ ] 工具调用请求正确路由
+
+* [ ] 日志记录请求和响应
 
 **输出：** `src/mcp/ultrapower-mcp-server.ts`（更新）
 
 ---
 
 ### 1.4.1 创建集成测试框架
+
 **父任务：** 1.4 集成测试套件
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -443,15 +511,19 @@ npm install --save-dev @types/node
 4. 实现请求/响应辅助函数
 
 **验收：**
-- [ ] 测试服务器可启动
-- [ ] 可发送 MCP 请求
-- [ ] 可接收 MCP 响应
+
+* [ ] 测试服务器可启动
+
+* [ ] 可发送 MCP 请求
+
+* [ ] 可接收 MCP 响应
 
 **输出：** `src/mcp/__tests__/integration.test.ts`
 
 ---
 
 ### 1.4.2 测试 LSP 工具调用
+
 **父任务：** 1.4
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -464,14 +536,17 @@ npm install --save-dev @types/node
 4. 验证返回结果格式
 
 **验收：**
-- [ ] LSP 工具调用成功
-- [ ] 返回结果符合预期
+
+* [ ] LSP 工具调用成功
+
+* [ ] 返回结果符合预期
 
 **输出：** `src/mcp/__tests__/integration.test.ts`（更新）
 
 ---
 
 ### 1.4.3 测试其他 7 类工具
+
 **父任务：** 1.4
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -487,14 +562,17 @@ npm install --save-dev @types/node
 7. 测试 Skills 工具（list_omc_skills）
 
 **验收：**
-- [ ] 每类工具至少 1 个测试通过
-- [ ] 覆盖率 >80%
+
+* [ ] 每类工具至少 1 个测试通过
+
+* [ ] 覆盖率 >80%
 
 **输出：** `src/mcp/__tests__/integration.test.ts`（更新）
 
 ---
 
 ### 1.4.4 测试向后兼容性
+
 **父任务：** 1.4
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -507,14 +585,17 @@ npm install --save-dev @types/node
 4. 验证三种方式都能成功
 
 **验收：**
-- [ ] 三种调用方式都通过
-- [ ] 返回结果一致
+
+* [ ] 三种调用方式都通过
+
+* [ ] 返回结果一致
 
 **输出：** `src/mcp/__tests__/integration.test.ts`（更新）
 
 ---
 
 ### 1.4.5 配置 CI 流水线
+
 **父任务：** 1.4
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -527,14 +608,17 @@ npm install --save-dev @types/node
 4. 上传测试报告
 
 **验收：**
-- [ ] CI 流水线运行成功
-- [ ] 测试结果可见
+
+* [ ] CI 流水线运行成功
+
+* [ ] 测试结果可见
 
 **输出：** `.github/workflows/mcp-tests.yml`
 
 ---
 
 ### 1.5.1 更新 REFERENCE.md
+
 **父任务：** 1.5 文档更新
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -547,14 +631,17 @@ npm install --save-dev @types/node
 4. 添加使用示例
 
 **验收：**
-- [ ] 文档完整准确
-- [ ] 包含所有工具
+
+* [ ] 文档完整准确
+
+* [ ] 包含所有工具
 
 **输出：** `docs/REFERENCE.md`（更新）
 
 ---
 
 ### 1.5.2 创建 MCP 服务器使用指南
+
 **父任务：** 1.5
 **预计时间：** 2 小时
 **负责人：** writer (haiku)
@@ -568,14 +655,17 @@ npm install --save-dev @types/node
 5. 添加故障排查指南
 
 **验收：**
-- [ ] 文档清晰易懂
-- [ ] 包含完整配置示例
+
+* [ ] 文档清晰易懂
+
+* [ ] 包含完整配置示例
 
 **输出：** `docs/guides/mcp-server-usage.md`
 
 ---
 
 ### 1.5.3 更新 README.md
+
 **父任务：** 1.5
 **预计时间：** 30 分钟
 **负责人：** writer (haiku)
@@ -588,8 +678,10 @@ npm install --save-dev @types/node
 4. 链接到详细文档
 
 **验收：**
-- [ ] README 包含 MCP 信息
-- [ ] 链接正确
+
+* [ ] README 包含 MCP 信息
+
+* [ ] 链接正确
 
 **输出：** `README.md`（更新）
 
@@ -598,6 +690,7 @@ npm install --save-dev @types/node
 ## 阶段 2：社区 MCP 服务器集成（Week 2-3）
 
 ### 2.1.1 创建 MCP 客户端基础类
+
 **父任务：** 2.1 MCP 客户端实现
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -610,14 +703,17 @@ npm install --save-dev @types/node
 4. 实现 disconnect() 方法
 
 **验收：**
-- [ ] 可连接到外部 MCP 服务器
-- [ ] 连接失败时抛出明确错误
+
+* [ ] 可连接到外部 MCP 服务器
+
+* [ ] 连接失败时抛出明确错误
 
 **输出：** `src/mcp/client.ts`
 
 ---
 
 ### 2.1.2 实现工具发现
+
 **父任务：** 2.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -630,14 +726,17 @@ npm install --save-dev @types/node
 4. 缓存工具列表
 
 **验收：**
-- [ ] 成功获取外部工具列表
-- [ ] 工具列表缓存生效
+
+* [ ] 成功获取外部工具列表
+
+* [ ] 工具列表缓存生效
 
 **输出：** `src/mcp/client.ts`（更新）
 
 ---
 
 ### 2.1.3 实现工具调用代理
+
 **父任务：** 2.1
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -650,14 +749,17 @@ npm install --save-dev @types/node
 4. 添加超时保护
 
 **验收：**
-- [ ] 成功代理工具调用
-- [ ] 错误处理正确
+
+* [ ] 成功代理工具调用
+
+* [ ] 错误处理正确
 
 **输出：** `src/mcp/client.ts`（更新）
 
 ---
 
 ### 2.1.4 实现连接重试机制
+
 **父任务：** 2.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -670,14 +772,17 @@ npm install --save-dev @types/node
 4. 连接失败后标记服务器不可用
 
 **验收：**
-- [ ] 重试机制生效
-- [ ] 不无限重试
+
+* [ ] 重试机制生效
+
+* [ ] 不无限重试
 
 **输出：** `src/mcp/client.ts`（更新）
 
 ---
 
 ### 2.1.5 编写客户端单元测试
+
 **父任务：** 2.1
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -690,15 +795,17 @@ npm install --save-dev @types/node
 4. 测试错误场景
 
 **验收：**
-- [ ] 测试覆盖率 >80%
-- [ ] 所有测试通过
+
+* [ ] 测试覆盖率 >80%
+
+* [ ] 所有测试通过
 
 **输出：** `src/mcp/__tests__/client.test.ts`
 
 ---
 
-
 ### 2.2.1 创建配置 schema
+
 **父任务：** 2.2 配置系统实现
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -711,14 +818,17 @@ npm install --save-dev @types/node
 4. 导出类型和验证函数
 
 **验收：**
-- [ ] Schema 完整（command, args, env, disabled）
-- [ ] 验证函数正确工作
+
+* [ ] Schema 完整（command, args, env, disabled）
+
+* [ ] 验证函数正确工作
 
 **输出：** `src/mcp/config-schema.ts`
 
 ---
 
 ### 2.2.2 实现配置加载器
+
 **父任务：** 2.2
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -732,15 +842,19 @@ npm install --save-dev @types/node
 5. 验证配置格式
 
 **验收：**
-- [ ] 正确加载两级配置
-- [ ] 合并逻辑正确
-- [ ] 无效配置抛出明确错误
+
+* [ ] 正确加载两级配置
+
+* [ ] 合并逻辑正确
+
+* [ ] 无效配置抛出明确错误
 
 **输出：** `src/mcp/config-loader.ts`
 
 ---
 
 ### 2.2.3 实现环境变量替换
+
 **父任务：** 2.2
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -753,15 +867,19 @@ npm install --save-dev @types/node
 4. 处理未定义变量
 
 **验收：**
-- [ ] 环境变量正确替换
-- [ ] 默认值生效
-- [ ] 未定义变量有明确错误
+
+* [ ] 环境变量正确替换
+
+* [ ] 默认值生效
+
+* [ ] 未定义变量有明确错误
 
 **输出：** `src/mcp/config-loader.ts`（更新）
 
 ---
 
 ### 2.2.4 编写配置加载测试
+
 **父任务：** 2.2
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -774,14 +892,17 @@ npm install --save-dev @types/node
 4. 测试配置验证
 
 **验收：**
-- [ ] 测试覆盖率 >80%
-- [ ] 所有测试通过
+
+* [ ] 测试覆盖率 >80%
+
+* [ ] 所有测试通过
 
 **输出：** `src/mcp/__tests__/config-loader.test.ts`
 
 ---
 
 ### 2.3.1 创建命名空间管理器
+
 **父任务：** 2.3 工具命名空间系统
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -795,15 +916,19 @@ npm install --save-dev @types/node
 5. 实现冲突检测
 
 **验收：**
-- [ ] 工具注册成功
-- [ ] 命名空间解析正确
-- [ ] 冲突检测生效
+
+* [ ] 工具注册成功
+
+* [ ] 命名空间解析正确
+
+* [ ] 冲突检测生效
 
 **输出：** `src/mcp/namespace.ts`
 
 ---
 
 ### 2.3.2 集成到服务器和客户端
+
 **父任务：** 2.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -816,14 +941,17 @@ npm install --save-dev @types/node
 4. 外部工具使用 `<server-name>:` 前缀
 
 **验收：**
-- [ ] 所有工具有正确前缀
-- [ ] 工具调用使用命名空间
+
+* [ ] 所有工具有正确前缀
+
+* [ ] 工具调用使用命名空间
 
 **输出：** `src/mcp/ultrapower-mcp-server.ts`, `src/mcp/client.ts`（更新）
 
 ---
 
 ### 2.3.3 编写命名空间测试
+
 **父任务：** 2.3
 **预计时间：** 1 小时
 **负责人：** test-engineer (sonnet)
@@ -836,14 +964,17 @@ npm install --save-dev @types/node
 4. 测试向后兼容（无前缀调用）
 
 **验收：**
-- [ ] 测试覆盖率 >80%
-- [ ] 所有测试通过
+
+* [ ] 测试覆盖率 >80%
+
+* [ ] 所有测试通过
 
 **输出：** `src/mcp/__tests__/namespace.test.ts`
 
 ---
 
 ### 2.4.1 测试 filesystem 服务器
+
 **父任务：** 2.4 社区服务器测试
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -857,15 +988,19 @@ npm install --save-dev @types/node
 5. 记录兼容性问题
 
 **验收：**
-- [ ] 连接成功
-- [ ] 工具调用成功率 >95%
-- [ ] 问题已记录
+
+* [ ] 连接成功
+
+* [ ] 工具调用成功率 >95%
+
+* [ ] 问题已记录
 
 **输出：** `src/mcp/__tests__/community-servers.test.ts`
 
 ---
 
 ### 2.4.2 测试 github 服务器
+
 **父任务：** 2.4
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -878,14 +1013,17 @@ npm install --save-dev @types/node
 4. 记录兼容性问题
 
 **验收：**
-- [ ] 连接成功
-- [ ] 工具调用成功率 >95%
+
+* [ ] 连接成功
+
+* [ ] 工具调用成功率 >95%
 
 **输出：** `src/mcp/__tests__/community-servers.test.ts`（更新）
 
 ---
 
 ### 2.4.3 测试 slack 服务器
+
 **父任务：** 2.4
 **预计时间：** 2 小时
 **负责人：** test-engineer (sonnet)
@@ -898,14 +1036,17 @@ npm install --save-dev @types/node
 4. 记录兼容性问题
 
 **验收：**
-- [ ] 连接成功
-- [ ] 工具调用成功率 >95%
+
+* [ ] 连接成功
+
+* [ ] 工具调用成功率 >95%
 
 **输出：** `src/mcp/__tests__/community-servers.test.ts`（更新）
 
 ---
 
 ### 2.4.4 创建兼容性矩阵
+
 **父任务：** 2.4
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -918,8 +1059,10 @@ npm install --save-dev @types/node
 4. 记录已知限制和解决方案
 
 **验收：**
-- [ ] 矩阵完整
-- [ ] 包含所有测试服务器
+
+* [ ] 矩阵完整
+
+* [ ] 包含所有测试服务器
 
 **输出：** `docs/compatibility-matrix.md`
 
@@ -928,6 +1071,7 @@ npm install --save-dev @types/node
 ## 阶段 3：协议标准化（Week 3-4）
 
 ### 3.1.1 更新工具注册使用新前缀
+
 **父任务：** 3.1 移除自定义前缀
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -939,14 +1083,17 @@ npm install --save-dev @types/node
 3. 保留旧前缀映射（向后兼容）
 
 **验收：**
-- [ ] 新前缀正常工作
-- [ ] 旧前缀仍可用
+
+* [ ] 新前缀正常工作
+
+* [ ] 旧前缀仍可用
 
 **输出：** `src/mcp/tool-adapter.ts`（更新）
 
 ---
 
 ### 3.1.2 添加废弃警告
+
 **父任务：** 3.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -959,15 +1106,19 @@ npm install --save-dev @types/node
 4. 输出警告到 stderr
 
 **验收：**
-- [ ] 旧前缀触发警告
-- [ ] 警告包含迁移指南链接
-- [ ] 不影响功能
+
+* [ ] 旧前缀触发警告
+
+* [ ] 警告包含迁移指南链接
+
+* [ ] 不影响功能
 
 **输出：** `src/mcp/deprecation.ts`
 
 ---
 
 ### 3.1.3 创建迁移脚本
+
 **父任务：** 3.1
 **预计时间：** 2 小时
 **负责人：** executor (sonnet)
@@ -980,15 +1131,19 @@ npm install --save-dev @types/node
 4. 生成迁移报告
 
 **验收：**
-- [ ] 脚本正确识别旧前缀
-- [ ] 替换准确
-- [ ] 生成详细报告
+
+* [ ] 脚本正确识别旧前缀
+
+* [ ] 替换准确
+
+* [ ] 生成详细报告
 
 **输出：** `scripts/migrate-tool-names.ts`
 
 ---
 
 ### 3.1.4 更新内部引用
+
 **父任务：** 3.1
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1001,14 +1156,17 @@ npm install --save-dev @types/node
 4. 验证所有引用
 
 **验收：**
-- [ ] 无旧前缀引用（除兼容层）
-- [ ] 所有测试通过
+
+* [ ] 无旧前缀引用（除兼容层）
+
+* [ ] 所有测试通过
 
 **输出：** 多个文件更新
 
 ---
 
 ### 3.1.5 创建迁移指南
+
 **父任务：** 3.1
 **预计时间：** 2 小时
 **负责人：** writer (haiku)
@@ -1021,14 +1179,17 @@ npm install --save-dev @types/node
 4. 列出常见问题
 
 **验收：**
-- [ ] 指南清晰完整
-- [ ] 包含迁移脚本用法
+
+* [ ] 指南清晰完整
+
+* [ ] 包含迁移脚本用法
 
 **输出：** `docs/migration-guide.md`
 
 ---
 
 ### 3.2.1 创建独立包目录
+
 **父任务：** 3.2 发布 npm 包
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1041,14 +1202,17 @@ npm install --save-dev @types/node
 4. 复制必要文件
 
 **验收：**
-- [ ] 目录结构正确
-- [ ] package.json 配置完整
+
+* [ ] 目录结构正确
+
+* [ ] package.json 配置完整
 
 **输出：** `packages/mcp-server/package.json`
 
 ---
 
 ### 3.2.2 创建包 README
+
 **父任务：** 3.2
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -1061,14 +1225,17 @@ npm install --save-dev @types/node
 4. 添加工具列表
 
 **验收：**
-- [ ] README 完整
-- [ ] 示例可直接使用
+
+* [ ] README 完整
+
+* [ ] 示例可直接使用
 
 **输出：** `packages/mcp-server/README.md`
 
 ---
 
 ### 3.2.3 配置构建流程
+
 **父任务：** 3.2
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1080,14 +1247,17 @@ npm install --save-dev @types/node
 3. 测试本地构建
 
 **验收：**
-- [ ] `npm run build` 成功
-- [ ] 生成可执行文件
+
+* [ ] `npm run build` 成功
+
+* [ ] 生成可执行文件
 
 **输出：** `packages/mcp-server/package.json`（更新）
 
 ---
 
 ### 3.2.4 发布到 npm
+
 **父任务：** 3.2
 **预计时间：** 30 分钟
 **负责人：** executor (sonnet)
@@ -1099,14 +1269,17 @@ npm install --save-dev @types/node
 3. 验证安装（`npx @ultrapower/mcp-server --version`）
 
 **验收：**
-- [ ] 包发布成功
-- [ ] 可通过 npx 运行
+
+* [ ] 包发布成功
+
+* [ ] 可通过 npx 运行
 
 **输出：** npm 包
 
 ---
 
 ### 3.3.1 实现废弃时间戳检查
+
 **父任务：** 3.3 向后兼容层
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1118,14 +1291,17 @@ npm install --save-dev @types/node
 3. 过期后抛出错误而非警告
 
 **验收：**
-- [ ] 时间戳检查正确
-- [ ] 过期后行为符合预期
+
+* [ ] 时间戳检查正确
+
+* [ ] 过期后行为符合预期
 
 **输出：** `src/mcp/deprecation.ts`（更新）
 
 ---
 
 ### 3.3.2 实现自动迁移提示
+
 **父任务：** 3.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1137,14 +1313,17 @@ npm install --save-dev @types/node
 3. 首次警告后记录到文件（避免重复）
 
 **验收：**
-- [ ] 提示清晰有用
-- [ ] 不重复显示
+
+* [ ] 提示清晰有用
+
+* [ ] 不重复显示
 
 **输出：** `src/mcp/deprecation.ts`（更新）
 
 ---
 
 ### 3.3.3 创建用户通知 hook
+
 **父任务：** 3.3
 **预计时间：** 1 小时
 **负责人：** executor (sonnet)
@@ -1156,14 +1335,17 @@ npm install --save-dev @types/node
 3. 记录已通知状态
 
 **验收：**
-- [ ] 首次启动显示通知
-- [ ] 不重复通知
+
+* [ ] 首次启动显示通知
+
+* [ ] 不重复通知
 
 **输出：** `src/hooks/mcp-migration-notice/`
 
 ---
 
 ### 3.3.4 添加禁用警告选项
+
 **父任务：** 3.3
 **预计时间：** 30 分钟
 **负责人：** executor (sonnet)
@@ -1174,15 +1356,17 @@ npm install --save-dev @types/node
 2. 更新文档说明
 
 **验收：**
-- [ ] 环境变量生效
-- [ ] 文档已更新
+
+* [ ] 环境变量生效
+
+* [ ] 文档已更新
 
 **输出：** `src/mcp/deprecation.ts`（更新）
 
 ---
 
-
 ### 3.4.1 创建 MCP 总览文档
+
 **父任务：** 3.4 生态系统文档
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -1195,14 +1379,17 @@ npm install --save-dev @types/node
 4. 链接到详细指南
 
 **验收：**
-- [ ] 文档清晰易懂
-- [ ] 包含所有链接
+
+* [ ] 文档清晰易懂
+
+* [ ] 包含所有链接
 
 **输出：** `docs/mcp/README.md`
 
 ---
 
 ### 3.4.2 创建服务器使用指南
+
 **父任务：** 3.4
 **预计时间：** 2 小时
 **负责人：** writer (haiku)
@@ -1216,14 +1403,17 @@ npm install --save-dev @types/node
 5. 故障排查
 
 **验收：**
-- [ ] 指南完整
-- [ ] 配置示例可用
+
+* [ ] 指南完整
+
+* [ ] 配置示例可用
 
 **输出：** `docs/mcp/server-guide.md`
 
 ---
 
 ### 3.4.3 创建客户端集成指南
+
 **父任务：** 3.4
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -1236,14 +1426,17 @@ npm install --save-dev @types/node
 4. 工具命名空间说明
 
 **验收：**
-- [ ] 指南完整
-- [ ] 示例可用
+
+* [ ] 指南完整
+
+* [ ] 示例可用
 
 **输出：** `docs/mcp/client-guide.md`
 
 ---
 
 ### 3.4.4 创建配置示例集
+
 **父任务：** 3.4
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -1256,14 +1449,17 @@ npm install --save-dev @types/node
 4. 常见社区服务器配置
 
 **验收：**
-- [ ] 至少 5 个示例
-- [ ] 示例可直接使用
+
+* [ ] 至少 5 个示例
+
+* [ ] 示例可直接使用
 
 **输出：** `docs/mcp/examples/*.json`
 
 ---
 
 ### 3.5.1 创建基准测试框架
+
 **父任务：** 3.5 性能基准测试
 **预计时间：** 2 小时
 **负责人：** performance-reviewer (sonnet)
@@ -1276,14 +1472,17 @@ npm install --save-dev @types/node
 4. 实现内存占用测试
 
 **验收：**
-- [ ] 测试框架可运行
-- [ ] 输出结构化结果
+
+* [ ] 测试框架可运行
+
+* [ ] 输出结构化结果
 
 **输出：** `benchmark/mcp-performance.ts`
 
 ---
 
 ### 3.5.2 运行基准测试
+
 **父任务：** 3.5
 **预计时间：** 1 小时
 **负责人：** performance-reviewer (sonnet)
@@ -1296,15 +1495,19 @@ npm install --save-dev @types/node
 4. 记录性能数据
 
 **验收：**
-- [ ] 延迟增加 <5%
-- [ ] 内存增加 <10MB
-- [ ] 数据已记录
+
+* [ ] 延迟增加 <5%
+
+* [ ] 内存增加 <10MB
+
+* [ ] 数据已记录
 
 **输出：** 性能数据
 
 ---
 
 ### 3.5.3 生成性能报告
+
 **父任务：** 3.5
 **预计时间：** 1 小时
 **负责人：** writer (haiku)
@@ -1317,9 +1520,12 @@ npm install --save-dev @types/node
 4. 添加结论和建议
 
 **验收：**
-- [ ] 报告完整
-- [ ] 包含图表
-- [ ] 结论明确
+
+* [ ] 报告完整
+
+* [ ] 包含图表
+
+* [ ] 结论明确
 
 **输出：** `docs/performance-report.md`
 
@@ -1330,15 +1536,22 @@ npm install --save-dev @types/node
 **总任务数：** 42 个原子任务
 
 **按阶段分布：**
-- 阶段 1（MCP 服务器包装器）：17 个任务
-- 阶段 2（社区服务器集成）：14 个任务
-- 阶段 3（协议标准化）：11 个任务
+
+* 阶段 1（MCP 服务器包装器）：17 个任务
+
+* 阶段 2（社区服务器集成）：14 个任务
+
+* 阶段 3（协议标准化）：11 个任务
 
 **按负责人分布：**
-- executor (sonnet)：24 个任务
-- test-engineer (sonnet)：10 个任务
-- writer (haiku)：7 个任务
-- performance-reviewer (sonnet)：1 个任务
+
+* executor (sonnet)：24 个任务
+
+* test-engineer (sonnet)：10 个任务
+
+* writer (haiku)：7 个任务
+
+* performance-reviewer (sonnet)：1 个任务
 
 **预计总工时：** 52 小时（约 6.5 个工作日）
 
@@ -1359,24 +1572,24 @@ npm install --save-dev @types/node
 1.5.1 → 1.5.2 → 1.5.3
 
 阶段 2：
-2.1.1 → 2.1.2 → 2.1.3 → 2.1.4 → 2.1.5
+1.1.1 → 2.1.2 → 2.1.3 → 2.1.4 → 2.1.5
                                   ↓
-2.2.1 → 2.2.2 → 2.2.3 → 2.2.4
+1.2.1 → 2.2.2 → 2.2.3 → 2.2.4
                           ↓
-2.3.1 → 2.3.2 → 2.3.3
+1.3.1 → 2.3.2 → 2.3.3
                   ↓
-2.4.1 → 2.4.2 → 2.4.3 → 2.4.4
+1.4.1 → 2.4.2 → 2.4.3 → 2.4.4
 
 阶段 3：
-3.1.1 → 3.1.2 → 3.1.3 → 3.1.4 → 3.1.5
+1.1.1 → 3.1.2 → 3.1.3 → 3.1.4 → 3.1.5
                                   ↓
-3.2.1 → 3.2.2 → 3.2.3 → 3.2.4
+1.2.1 → 3.2.2 → 3.2.3 → 3.2.4
                           ↓
-3.3.1 → 3.3.2 → 3.3.3 → 3.3.4
+1.3.1 → 3.3.2 → 3.3.3 → 3.3.4
                           ↓
-3.4.1 → 3.4.2 → 3.4.3 → 3.4.4
+1.4.1 → 3.4.2 → 3.4.3 → 3.4.4
                           ↓
-3.5.1 → 3.5.2 → 3.5.3
+1.5.1 → 3.5.2 → 3.5.3
 ```
 
 ---
@@ -1397,7 +1610,7 @@ npm install --save-dev @types/node
 1. **工具适配器（1.2.2-1.2.9）：** 8 个任务可并行
    - 预计节省：6 小时
 
-2. **社区服务器测试（2.4.1-2.4.3）：** 3 个任务可并行
+1. **社区服务器测试（2.4.1-2.4.3）：** 3 个任务可并行
    - 预计节省：2 小时
 
 **优化后总工时：** 44 小时（约 5.5 个工作日）
@@ -1407,28 +1620,44 @@ npm install --save-dev @types/node
 ## 验收标准总览
 
 **阶段 1 完成标准：**
-- [ ] 所有 17 个任务验收通过
-- [ ] MCP 服务器可独立启动
-- [ ] 35 工具全部可通过 MCP 调用
-- [ ] 集成测试通过率 100%
+
+* [ ] 所有 17 个任务验收通过
+
+* [ ] MCP 服务器可独立启动
+
+* [ ] 35 工具全部可通过 MCP 调用
+
+* [ ] 集成测试通过率 100%
 
 **阶段 2 完成标准：**
-- [ ] 所有 14 个任务验收通过
-- [ ] 成功连接 ≥3 个社区 MCP 服务器
-- [ ] 工具命名空间无冲突
-- [ ] 兼容性矩阵完成
+
+* [ ] 所有 14 个任务验收通过
+
+* [ ] 成功连接 ≥3 个社区 MCP 服务器
+
+* [ ] 工具命名空间无冲突
+
+* [ ] 兼容性矩阵完成
 
 **阶段 3 完成标准：**
-- [ ] 所有 11 个任务验收通过
-- [ ] 旧前缀废弃警告生效
-- [ ] npm 包发布成功
-- [ ] 性能下降 <5%
+
+* [ ] 所有 11 个任务验收通过
+
+* [ ] 旧前缀废弃警告生效
+
+* [ ] npm 包发布成功
+
+* [ ] 性能下降 <5%
 
 **整体完成标准：**
-- [ ] 所有 42 个原子任务完成
-- [ ] CI/CD 流水线全绿
-- [ ] 文档完整
-- [ ] 性能达标
+
+* [ ] 所有 42 个原子任务完成
+
+* [ ] CI/CD 流水线全绿
+
+* [ ] 文档完整
+
+* [ ] 性能达标
 
 ---