用途：审计 Claude Code 和 Codex 的钩子配置，检查有效性、安全性与正确性，覆盖 settings.json、hooks.json、config.toml、插件以及技能或智能体 frontmatter。适用于首次添加钩子、钩子从不触发或每次工具调用都触发、工具执行前明显卡顿、策略钩子未能拦截、从其他项目或机器复制钩子之后，以及定期排查钩子是否仍有用。
主要能力：发现范围内每个存在的 Claude Code 与 Codex 钩子位置；按各宿主规则分别评分，不用 Codex 语义评 Claude 钩子或反之；校验事件与处理器类型是否匹配、匹配器是否合法、命令能否解析执行、退出码与 JSON 决策是否符合事件契约；识别死配置（如 Codex 中 prompt/agent 处理器会被解析后跳过）；核对 disableAllHooks、allowManagedHooksOnly、allowedHttpHookUrls 等生效设置；对 Codex 提示钩子信任状态与 /hooks 审查结果；与 ctxharness doctor --format json 报告对账，额外发现需 file:line 证据。
使用方式：可按参数限定范围——无参数审计全部存在位置，claude 或 codex 只审计该宿主，文件路径只审计该文件；audit-only 或用户要求不改动时只执行列出与报告步骤，逐条列出建议变更而不编辑。评分每钩子满分 10 分，含事件与处理器类型、匹配器、命令、超时、安全等维度；目标是让每个钩子真正可用、范围正确且运行安全。
限制：官方实时文档与规则冲突时以文档为准，并报告分歧而非按过期文本评分；~/.claude/settings.local.json 非文档化位置，存在时报告但不视其钩子为生效；Codex 的 [hooks.state] 为未文档化实现，只如实报告且不打印哈希值，也不当作事件；被包装器注入 --dangerously-bypass-hook-trust 时信任结论不代表实际运行；文档未定义多钩子改写同一调用时哪个 updatedInput 生效。具体超时默认值、事件数量与字段细节以官方文档为准。