用途:为代码库生成分层的 AGENTS.md 知识库文件,包含根目录文档以及按复杂度评分筛选出的子目录文档,供 AI 代理在开发时参考项目结构与约定。
主要能力:支持更新模式(默认,修改已有并酌情新建)与 --create-new 模式(先读取现有内容再全部删除并从头重建);可用 --max-depth=2 限制目录深度(默认 5)。工作流分四阶段:发现与分析(并行 explore 代理、bash 结构分析、LSP 代码地图、读取现有 AGENTS.md)、评分与位置决策、生成(先根目录再并行子目录)、审查去重。评分矩阵综合文件数、子目录数、代码占比、模块边界、符号密度、导出数与引用中心性等因子,决定哪些目录需要生成文档。
使用方式:通过命令行参数控制模式与深度,例如 --create-new 与 --max-depth=2。生成时根目录文档包含概览、结构、查找指引、代码地图、约定、反模式、命令等章节,子目录文档限制在 30-80 行且不重复父级内容。
适用场景:中大型代码库、monorepo、多语言项目,需要为 AI 代理提供项目级上下文时。
限制:资料未提供安装命令、收费与价格信息;LSP 不可用时回退到 explore 代理与 AST-grep;并非每个目录都需要 AGENTS.md,评分低于阈值时跳过。