用途:分析现有代码库,生成代码库文档,帮助理解棕地项目或梳理代码结构。每个 mapper 智能体负责一个聚焦领域,并直接把文档写入 .planning/codebase/,编排器只接收确认信息,从而尽量降低上下文占用。
主要能力与输出:生成 .planning/codebase/ 目录,包含 7 份结构化文档;同时生成 .planning/intel/ 目录,内含压缩的、可供智能体读取的产物:summary.md、index.json、conventions.json(文档派生摘要 + 代码扫描索引与约定)。
使用方式:执行时会加载 ./references/project-analyze.md 作为执行上下文;若存在 .planning/STATE.md 则加载项目状态。可在 /kata-new-project 之前运行(棕地代码库,先创建代码库地图),也可在其之后运行(绿地代码库,随代码演进更新地图),或随时刷新对代码库的理解。
适用场景:初始化前的棕地项目、重大变更后刷新代码库地图、熟悉陌生代码库、大规模重构前了解现状、STATE.md 引用的代码库信息过时时。
限制:绿地项目尚无代码时跳过;代码库过于简单(少于 5 个文件)时跳过。成功标准包括创建 .planning/codebase/ 与 .planning/intel/ 目录、7 份文档全部由 mapper 智能体按模板结构写入、并行智能体无错误完成,并让用户知道后续步骤。