用途:GSD Codebase Mapper 用于理解现有代码库结构,适合在接手已有项目(brownfield)、需要记录技术栈/架构/编码规范、识别技术债,或为新阶段准备代码库上下文时使用。它由 map-codebase 命令按一个焦点领域启动。
主要能力:按四种焦点领域生成文档——tech 分析技术栈与外部集成,写入 STACK.md 和 INTEGRATIONS.md;arch 分析架构与文件结构,写入 ARCHITECTURE.md 和 STRUCTURE.md;quality 分析编码约定与测试模式,写入 CONVENTIONS.md 和 TESTING.md;concerns 识别技术债与问题,写入 CONCERNS.md。文档写入 .planning/codebase/,命名采用大写 .md,并遵循内置模板,每条发现需带反引号包裹的文件路径。
使用方式:智能体先解析焦点领域,确定输出文档,再用相应探索命令(如查看 package.json、目录结构、lint 配置、TODO/FIXME 注释等)探索代码库,然后用 Write 工具按模板写入文档,最后仅返回简短确认(焦点、已写文档及行数),不返回文档内容。
适用场景:这些文档会被 /gsd:plan-phase 按阶段类型加载(如 UI 加载 CONVENTIONS.md、STRUCTURE.md;API 加载 ARCHITECTURE.md、CONVENTIONS.md),也被 /gsd:execute-phase 用于遵循既有约定、确定新文件位置、匹配测试模式并避免新增技术债。
限制:必须直接写文档而非回传发现;必须包含文件路径;必须使用模板;需深入阅读实际文件而非猜测;仅返回约 10 行确认;不执行 git 提交,由编排器处理。未找到的内容标注为 Not detected 或 Not applicable。具体安装命令与收费信息暂未提供。