用途：为代码仓库建立、审计或迁移代理指令体系。以 AGENTS.md 为代理工作方式的唯一事实来源，CLAUDE.md 作为其同级配套，REVIEW.md 作为可选的审查标准化层，原生审查适配器（Copilot、Devin、Greptile）作为最后阶段可配置输出。
主要能力：基于仓库真实证据生成根级与文件夹级 AGENTS.md；默认每个 AGENTS.md 配同级 CLAUDE.md 符号链接，不支持符号链接时退化为单行 @AGENTS.md 包装；按需生成 REVIEW.md 及作用域审查文件；迁移 .cursorrules、Copilot、Gemini 配置到 AGENTS.md；审计既有指令文件；最后一步可选生成 Copilot、Devin、Greptile 审查适配器。
使用方式：先界定请求类型（新建、审计、迁移、扩展），用 scripts/audit-agents-md.sh 做只读审计，用 tree -d 或 tree -dL 2 . 建立文件夹地图；执行 Wave 1 架构发现与 Wave 2 文件夹深挖，合并后再撰写文件；计划确定后才可用 scripts/scaffold-agents-md.sh（仅显式 --write 才写入）；稳定后再创建配套入口点，最后验证并询问是否生成原生适配器。
适用场景：新仓库初始化代理指令、仅有 CLAUDE.md 的仓库迁移、monorepo 或大 src/ 树的文件夹级指令、多代理团队协作、生成 Copilot/Devin/Greptile 审查适配器。
限制：不适用于创建或修改技能本身（用 build-skill）、检查工作是否完成（用 audit-completion）、审查具体 PR（用 run-review Mode A）或与指令文件无关的多代理运行时编排。命令与路径必须经真实文件验证，不可确认时标记 [unverified]；不得凭空编造。原有配置应补充而非盲目替换，保留既有 Always、Ask、Never、WARNING、CRITICAL、DO NOT 规则；存在既有文件时先出审计报告再编辑，除非用户明确豁免。