用途
Agent Instructions Auditor 用于审计 AI 编码代理的指令文件,覆盖 Claude、Codex、Gemini 三类代理,检查其质量、一致性与最佳实践。它属于 L3 Worker,分类为 0XX Shared。
主要能力
审计按六个阶段进行:
阶段 1:发现文件 在目标项目中定位指令文件。Claude 主文件为 CLAUDE.md,回退为 .claude/settings.local.json;Codex 主文件为 AGENTS.md,回退为 .codex/instructions.md;Gemini 主文件为 GEMINI.md,回退为 AGENTS.md(与 Codex 共享)。报告哪些文件存在、哪些代理共享文件。
阶段 2:Token 预算审计 对每个指令文件检查行数(≤100 通过,101-150 警告,>150 失败)、估算 token(≤2,500 通过,2,501-3,500 警告,>3,500 失败)、章节数(≤8 通过,9-12 警告,>12 失败)。token 估算方式为 wc -w {file} × 1.3(英文平均 tokens/词比例)。输出每个文件的行数、词数、估算 token 表格。
阶段 3:提示缓存安全性 检查会破坏基于前缀的提示缓存的内容:无时间戳(grep -E '\d{4}-\d{2}-\d{2}.\d{2}:\d{2}',WARN)、内容中无日期(grep -E '(January|February...',WARN)、无动态计数(grep -E '\d+ skills|\d+ tools|\d+ servers',硬编码计数会变化,WARN)、无绝对路径(grep -E '[A-Z]:\|/home/...',WARN)、结构稳定(无条件章节,INFO)。
阶段 4:内容质量 检查:是否有构建/测试命令(找到 npm|cargo|pytest|dotnet 命令为通过,缺失则需添加);是否无抽象原则(无“write quality code”“follow best practices”,发现模糊指令为失败);是否无冗余文档(无 API 文档、无完整架构描述,发现可从代码发现的内容为失败);是否有硬边界(找到 NEVER|ALWAYS|MUST|DO NOT 规则为通过,缺失明确禁止为失败);是否有 Compact Instructions 章节(存在且含保留优先级为通过,缺失则 /compact 时会丢失决策);是否有 MCP 工具偏好(内置→MCP 工具映射表,缺失则代理使用次优工具);是否无工具输出示例(无大代码块或命令输出,发现则每轮膨胀)。
阶段 5:跨代理一致性 对比所有找到的指令文件:MCP 工具偏好(所有文件同一表格为通过,部分缺失为失败)、关键规则(相同核心规则为通过,规则分歧为失败)、构建/测试命令(相同命令为通过,不同或缺失为失败)、结构章节(相同章节顺序为通过,结构不一致为失败)。对每个不一致,展示 diff 并建议哪个文件为事实来源(通常是 CLAUDE.md)。
阶段 6:报告 生成审计报告表格,包含文件、行数、约 token、缓存安全、质量评分、问题;汇总跨代理不一致数量;给出可操作建议,例如创建缺失的 GEMINI.md、为 CLAUDE.md 添加 ## Compact Instructions。
使用方式
在以下时机使用:编辑任何指令文件后;添加/移除 MCP 服务器或钩子后;发布或出版前;会话退化(上下文膨胀症状)时。
完成定义
所有指令文件被发现并审计;token 预算在限制内(每个 ≤2,500 tokens);未发现提示缓存破坏项(或报告为 WARN);内容质量检查通过(或报告问题);跨代理一致性已验证;生成带可操作建议的报告。
限制
资料未提供该工具的安装方式、运行命令、收费模式、平台支持等具体信息。