用途:审计或改进仓库范围内的 Codex AGENTS.md、AGENTS.override.md、配置的兜底说明,以及配套的 code_map.md 导航文件,产出以证据为先、贴合启动上下文的精简仓库指引。
主要能力:解析项目根目录、启动 CWD、候选文件与生效配置证据;依据 Codex 发现语义判断哪些文件实际生效,构建从根到 CWD 的指令链,识别被遮蔽项、空文件与字节预算状态;单独盘点链外文件。还可核对命令、路径、归属、边界与反复出现的失败,并按质量准则判断指令需求与导航需求。
使用方式:审计/优化/计划模式下只检查并返回证据报告与建议 diff,不写文件。已批准计划或明确限定的改动/修复,可直接编辑范围内本地文件并验证,无需再次审批。完全明确的琐碎编辑可直接进行;显式调用技能时采用最小检查、编辑、验证后停止。默认优先使用结构化工具,shell 兜底可用一行 rg --files --hidden 配合 include/exclude glob。
适用场景:维护仓库级 AI 指令、排查指令链遮蔽或配置缺失、精简臃肿的 AGENTS 指引、同步 code_map.md 导航。
限制与边界:涉及用户全局、外部、破坏性、高成本或扩大范围的工作须先确认;除非被要求,不写入 Codex home 指引。证据需区分事实、默认、推断与缺失证据;evals/ 视为发布证据而非模型或人工证明;保留人工与管理内容,仅当共享契约变化时才改动两个同级 fenced code_map.md 模板。审计输出包含优先级发现、证据、影响、diff、置信度、条件链/遮蔽、AGENTS 与 map 的独立决策、验证与风险;编辑输出包含变更文件、结果、保留情况与检查通过/失败/跳过。其他细节暂未提供。