generate_module_docs MCP 工具在深层子目录下无法生成文档

[ljh740]

问题描述

generate_module_docs MCP 工具在处理深层子目录时，虽然返回成功状态，但实际上并未生成文档文件。只有顶层目录能正常输出文档。

环境信息

• 操作系统: macOS
• Claude Code: 最新版本
• 工具: mcp__ccw-tools__generate_module_docs

复现步骤

1. 准备一个具有深层目录结构的项目（如深度 5-6 层）
2. 对深层子目录执行 generate_module_docs：

   mcp__ccw-tools__generate_module_docs({
     projectName: "myproject",
     sourcePath: "./src/modules/feature/submodule/controller",
     strategy: "single",
     tool: "gemini"
   })

3. 工具返回成功，包含 duration_seconds 和正确的 output_path
4. 检查输出目录 - 没有生成 .md 文件

期望行为

应在以下位置生成文档文件：

.workflow/docs/myproject/src/modules/feature/submodule/controller/
├── API.md
└── README.md

实际行为

• 工具返回 {"success": true, ...}
• 目录结构被创建（但为空文件夹）
• 深层子目录中没有生成 .md 文件
• 仅顶层目录（深度 0-1）能正常生成文档

补充信息

在查看详细输出时，发现路径重复拼接的问题：

Directory not found: /project/src/submodule/src/submodule

这表明 sourcePath 在内部处理时被错误地拼接了两次。