用途:分析代码库并生成 .planning/codebase/ 下的结构化文档,帮助使用者掌握代码库状态。每个 mapper 智能体负责一个关注领域,直接写入文档,编排器只接收确认信息,以减少上下文占用。
主要能力:产出 .planning/codebase/ 文件夹,内含 7 份关于代码库状态的结构化文档,遵循模板结构;支持并行智能体执行。
使用方式:命令后可直接传入关注领域文本。首个参数为 --fast 时,去掉该标记并执行 ~/.claude/gsd-core/workflows/scan.md,可继续传 --focus;首个参数为 --query 时,去掉该标记并运行 intel 工作流,其余参数作为子命令;否则将全部参数作为关注领域传给 map-codebase 工作流。若存在 .planning/STATE.md 则加载项目上下文。可通过 /gsd-onboard 在首次棕地初始化时运行(先建代码库地图),也可在 /gsd-new-project 之后对绿地代码库运行以随演进更新地图,或随时刷新理解。
适用场景:棕地项目初始化前先理解既有代码;重大变更后刷新地图;刷新或深化已入职项目的代码库地图;大重构前了解现状;STATE.md 中代码库信息过时时。
限制:尚无代码的绿地项目无需运行;文件数少于 5 的简单代码库可跳过。成功标准为目录创建、7 份文档写入、遵循模板、并行智能体无错误完成,且用户知晓后续步骤。官方说明未提供更多内容。