用途：维护少量高信号的 AGENTS.md 文件。根目录 AGENTS.md 说明仓库目的、导航、通用工具链、规范命令与文档/技能链接；嵌套 AGENTS.md 说明模块/包目的、局部命令与模块引用。采用渐进式披露，尽量精简，把细节放入文档或技能。
适用时机：AGENTS.md 缺失、臃肿、矛盾或过时；出现新包/服务/模块；仓库结构变化；团队需要跨异构技术栈的一致智能体上下文。
工作流程：先发现仓库形态，识别根目录（尽量用 git root）及 package.json、pnpm-workspace.yaml、go.mod、go.work、pyproject.toml、Cargo.toml、pubspec.yaml、pom.xml、build.gradle 等标记，并定位 docs/、README.md、已有 AGENTS.md。再判定模块边界：目录含独立构建/包清单，或代表可部署/服务单元（apps/、services/、packages/），且技术栈与父级不同时，生成嵌套 AGENTS.md。根文件建议不超过 60 行，包含一句话仓库目的、主要工具链/包管理器、规范命令（非常规时）、文档链接、进入模块时读取嵌套文件的说明，可选技能引用。嵌套文件建议不超过 40 行，包含一句话模块目的、模块命令、本地文档引用，可选技能引用。
渐进式披露：不内嵌风格指南、CI 策略或架构细节，改为链接 docs/STYLE_GUIDE.md、docs/ARCHITECTURE.md 或技能；除非对正确性/安全关键，避免“始终/从不”规则。
安全与正确性：绝不编造命令，命令应从 package scripts、Makefile、CI 配置、README 推断；不确定时写“Known commands: see ”并留空链接位置。保留安全、密钥、部署等关键警告。只创建或更新仓库根与模块目录的 AGENTS.md，不创建智能体配置文件夹。技能位置不假设 .agents/ 或固定目录，若引用本地技能先检测项目已有技能根，否则仅按名称引用外部技能，不新建隐藏智能体目录。技能引用按检测结果给出本地路径或外部名称。资料未提供安装命令、收费或平台信息。