用途：为仓库生成一套精简、有证据支撑的 AGENTS.md 指令栈，输出可以是计划、建议的文件内容，或在用户明确要求写入时实际应用文件。它属于指令脚手架，若用户只是询问仓库的智能体上下文是否健康，应先用 repo-agent-context-audit。
主要能力：运行只读发现与扫描命令，检查现有 AGENTS.md、CLAUDE.md、WARP.md、.claude/instructions.md、.github/copilot-instructions.md、README、CONTRIBUTING、包清单、Makefile、CI 工作流和测试命令；产出带证据与验证命令的分层 AGENTS.md 计划；在用户要求时起草精确文件内容。
使用方式：默认先给出限定范围的计划再编辑，只有用户明确要求应用时才写入或修改文件。可运行 python3 scripts/scan_repo_context.py <repo-root> 或加 --json。应用时根文件通常保持 80-150 行，嵌套文件聚焦该目录的归属、事实来源规则和验证命令，使用真实命令与路径，保留现有高上下文文件，每条禁止项配具体替代方案。
适用场景：需要为仓库建立或改进智能体指令、拆分根级与目录级规则、处理生成文件目录或高风险目录（迁移、部署、认证、密钥、支付等）时。
限制：不要仅凭名称推断命令或归属；不要为每个目录都加嵌套文件；不要为统一命名而覆盖现有 CLAUDE.md、WARP.md 或 AGENTS.md；命令无法从仓库证据验证时应留作待确认事实而非猜测；未经验证不要批量规范化多个仓库。验证时运行受影响范围的窄验证命令，并视情况重跑扫描脚本；无法验证时报告缺失前提与应稍后运行的命令。