用途：自动发现并加载项目层级中的 AGENTS.md 文件，为 AI 编程代理提供完整操作上下文。
主要能力：扫描当前工作目录及所有上级目录（至文件系统根或仓库根），查找 AGENTS.md 或 agents.md；搜索工作区子目录中适用于子项目或模块的额外文件；确定加载顺序，靠近仓库根的文件先加载（全局上下文），更深目录的文件后加载（覆盖或补充）；读取每个文件并提取指令块、工作流定义和约束声明；合并为统一上下文并标注层级间冲突；以结构化摘要呈现来源路径、指令数量和检测到的冲突；缓存本次会话的发现结果，避免重复扫描。
输出：按目录深度排序的 AGENTS.md 路径列表、合并后的指令集、冲突报告、会话缓存状态。
错误处理：未找到文件时提示确认工作目录或创建 AGENTS.md；目录遍历权限被拒时限制扫描深度至仓库根（通过 .git/ 判断）；检测到循环符号链接时跳过并记录警告；层级指令冲突时默认应用更具体的深层指令；文件编码错误时尝试 latin-1 回退并报告路径。
适用场景：含逐包代理指令的 monorepo、存在冲突提交策略的嵌套工作区、首次克隆且无代理文件的仓库。
限制：需要读取和 Glob 权限以遍历目录树，需要 Grep 访问以在多个候选文件时搜索内容；需存在一个或多个 AGENTS.md 文件。
资源：Claude Code AGENTS.md 规范 https://docs.anthropic.com/en/docs/agents ；monorepo 代理配置模式 https://docs.anthropic.com/en/docs/claude-code 。