用途:审计自定义子代理定义,覆盖 Claude Code 的 .claude/agents/.md 与 Codex 的 .codex/agents/.toml,目标是让每个代理可加载、彼此可区分、建模正确且可安全委派。适用于接入委派或编排流程前的检查、代理被错误委派或从不委派、从其他项目复制代理或安装插件后、新增代理可能冲突、以及定期清理。不适用于技能、钩子、规则或跨主机配置健康报告。
主要能力:发现范围内全部代理;按宿主原生 schema 校验可加载性;检查同名冲突与描述重叠;按评分表打分(Claude Code 15 分,Codex 12 分,阈值 Good≥80%、Needs work 60-79%、Fix<60%);逐代理交互式复核并应用确认的修改;输出审计报告。
使用方式:默认执行发现、解析、冲突检查、评分、交互复核与报告六步;audit-only 时只列建议改动。发现命令示例:find -L .claude/agents -name ".md" 2>/dev/null;find -L .codex/agents -name ".toml" 2>/dev/null。可用 claude plugin validate .claude/agents(v2.1.233 或更高)检查 frontmatter 解析。
限制:子代理默认后台运行且不获得 AskUserQuestion 与计划模式工具,系统提示中“询问用户”“等待批准”等指令无法执行;插件代理会忽略 hooks、mcpServers、permissionMode 与 initialPrompt;allowed-tools 等技能字段会被静默忽略;Haiku 代理的 effort 字段无效;会话开始后新建目录中的代理需重启才被识别。资料未提供收费与价格信息。