SuperAPI AI 工具集

gsd-map-codebase

编程与开发

查看项目

更新于 11-09 17:30

技能介绍

用途

gsd-map-codebase 用于分析代码库,并通过并行 mapper 智能体产出位于 .planning/codebase/ 目录下的代码库文档。每个 mapper 智能体探索一个重点区域,并直接把文档写入 .planning/codebase/;编排器只接收确认信息,从而把上下文使用保持在最低水平。

主要能力

  • 输出 .planning/codebase/ 文件夹,内含 7 份关于代码库状态的结构化文档。
  • 支持通过参数切换工作流:参数首个 token 为 --fast 时,去掉该标志并运行扫描工作流(其余参数包括可选的 --focus 一并传入);为 --query 时,去掉该标志并运行情报工作流(其余参数作为子命令传入);否则将全部参数作为重点领域传给 map-codebase 工作流。
  • 若存在 .planning/STATE.md,会加载项目状态,在项目已初始化时读取上下文。
  • 执行上下文引用 @~/.gemini/antigravity/gsd-core/workflows/map-codebase.md。

使用方式

该命令可运行于以下场景:通过 /gsd-onboard 进行首次棕地项目设置时(先创建代码库地图);在 /gsd-new-project 之后(绿地代码库,随代码演进而更新代码库地图);以及任何时候需要刷新对代码库的理解时。

适用场景包括:棕地项目初始化之前先理解现有代码;重大变更后刷新代码库地图;刷新或深化已完成入驻的代码库地图;大型重构前了解当前状态;STATE.md 引用的代码库信息过时时。

不适用场景:尚无代码的绿地项目(无可映射内容);过于简单的代码库(少于 5 个文件)。

成功标准

.planning/codebase/ 目录已创建;全部 7 份代码库文档由 mapper 智能体写入;文档遵循模板结构;并行智能体无错误完成;用户知晓后续步骤。

限制

资料未提供具体安装命令、收费方式、支持平台与性能指标等信息。