用途：当用户要求创建、更新、精简或审计 AGENTS.md，或 monorepo 需要根级与包级分层指令，或现有指令含过时命令、重复策略、无依据声明时使用；也用于与 CLAUDE.md、.github/copilot-instructions.md 等指令文件对齐。若任务需要打包式生成、资产或备份流程，则使用 @agents-generator。
主要能力：保留既有维护者意图，优先就地改进而非整体重写；建立有界证据地图（README、CONTRIBUTING、清单与锁文件、任务运行器、构建配置、CI 工作流、代表性源码与测试），据此写出精确安装、构建、lint、类型检查、测试命令与仓库结构、变更规则及安全边界；支持根级与嵌套范围划分，仅将差异写入子树文件。
使用方式：先读取目标路径适用的全部指令文件，识别生成文件、迁移、密钥边界等；用 rg --files 和 rg 辅助发现；写入直接、可测试的陈述，如“From the repository root, run npm test -- path/to/file.test.ts for a focused test.”；交付前完整重读、去重、核对文件存在与命令来源，报告改动文件、所用证据、实际执行的检查及未决不确定性。
限制：仓库证据可能不完整或矛盾；命令可能依赖本地不可用的凭证或服务；各工具对 AGENTS.md 的支持与优先级不同。此为会修改文件的状态变更类 skill，需审查 diff；不得引入密钥、凭据、内部 URL、个人数据，不得为验证文档运行部署、发布或数据库变更等高风险命令，不得擅自上传私有仓库内容。