用途：审计并改进代码仓库，使其适配 Codex/Codex App、Claude Code、OpenCode 的可靠智能体协作。默认仅审计，先呈现发现并等待批准，除非用户明确要求实施改动。
主要能力：从仓库根目录运行 python scripts/audit_repo.py --root . 生成 JSON 报告；仅在用户明确需要个人配置时加 --include-user-scope。脚本检测结构风险，但不能证明文档中的命令或架构仍然有效，需对照实际构建文件、脚本和布局复核。报告涵盖：就绪度、优势领域、主要失效模式、首要动作；仓库规模与语言/框架；指令拓扑（规范文件、兼容垫片、嵌套路由、上下文预算风险）；各智能体实际存在的设置、MCP、技能与子代理；P0 至 P3 问题及文件路径与证据；具体修改与验证命令。
使用方式：先阅读仓库现有指令链再检查其他文件；按需查阅 instruction-files.md、rubric.md、checklist.md、best-practices.md。对必需的构建/测试/lint 命令和钩子，须实际在当前环境执行验证，配置项或钩子文件存在不等于生效，例如缺少 lefthook 会导致检查未运行；不得为测试钩子而提交、推送、部署或执行破坏性操作。阻塞钩子需验证合规夹具通过、违规夹具被拒；确认测试命令真正运行而非零用例或跳过；未能执行的项目标为“未验证”，与确认失败区分。
实施改动：确认范围后保持单一事实来源，推荐根 AGENTS.md 加含 @AGENTS.md 的 CLAUDE.md；就近放置限定规则；只对真实发现错误处添加路由索引；不将生成目录、依赖、缓存、次级工作树和不相关子树纳入路由表；把不可协商规则转为钩子、linter 或 CI；展示 diff，重跑审计与测试并说明剩余缺口。
限制：超过 3000 个受跟踪文件的工作区应强调导航与聚焦验证；含多个子 Git 仓库时，每个子仓库视为独立指令根，Codex 每次运行只构建一次指令链，切换工作目录不会加载子仓库文件，需显式元仓库路由规则并全新会话验证。不检查凭据存储，不打印机密。无需要的智能体配置不应扣分，但声称跨智能体却无法被发现应标记。