用途:为 AI 代理和人类在关键目录边界放置 AGENTS.md,提供轻量、分层的指引。根目录放跨域规则与模块地图,嵌套目录放各组件/模块的技术专属说明,可选在模块级添加功能地图。强调简短精确的要点,深度内容链接到文档。
主要能力:生成根 AGENTS.md(全局规则、monorepo 模块/子项目地图、跨域工作流如前后端 API、认证会话、契约位置、本地联调、跨仓库验证指引);为每个组件生成嵌套 AGENTS.md(后端运行/测试/数据库迁移、前端运行/构建/测试与环境变量、文档结构与预览构建);按需生成模块地图与功能地图表格。
使用方式:先确认是 monorepo 还是单项目、仓库布局与主要模块、需记录的跨域工作流、功能地图(5-15 个用户可见功能及归属模块)、MCP 使用规则、硬性规则(禁止改动项、必需命令、风格规则)。放置启发式:仓库根、各主要组件根(如 backend/、frontend/、docs/、infra/)、约定或风险不同的子目录;避免过深,文件过多会成噪音。工作流:盘点仓库、起草根文件、按组件起草嵌套文件、按需构建地图、校验父子范围一致性。模板位于 references/agents-template.md、references/module-map-format.md、references/feature-map-format.md、references/docs-structure.md。
适用场景:monorepo 或多模块项目需要为 AI 代理提供分层上下文;需要记录跨域工作流与模块归属;需要统一各模块运行、测试与验证方式。
限制:资料未提供具体安装命令、收费、平台支持与效果数据;默认不打开 docs/,仅在要求时查阅;需避免父子指引冲突,长内容应移入 docs/。