用途：validator-help 用于对 agent-validator 的行为做基于证据的诊断，回答诸如“验证器为什么失败”“解释验证器行为”等问题。它只做诊断，不自动修复问题，依据运行时产物和 CLI 输出而非源代码。
主要能力：按固定顺序排查。先读取 .validator/config.yml 取得 log_dir（默认 validator_logs），再优先查看被动证据：<log_dir>/.debug.log（带时间戳的事件日志）、<log_dir>/.execution_state（含 last_run_completed_at、branch、commit、working_tree_ref、unhealthy_adapters）、<log_dir>/console..log、<log_dir>/check_.log、<log_dir>/review_*.json 以及 .validator/config.yml。被动证据不足时才运行 CLI 命令，并区分已确认结论与推断。
使用方式：必要时使用 agent-validate list（查看已配置的 gate 与入口）、health（检查适配器可用性与健康状态）、detect（查看变更文件及适用 gate）、validate（校验 config.yml 语法与 schema）、clean（归档当前日志并重置状态，具破坏性，需先与用户确认）。按问题领域加载对应参考文件：配置问题、gate 问题、锁问题、适配器问题。
输出契约：每次诊断必须包含 Diagnosis（发生了什么及原因）、Evidence（读取的文件、字段值与命令输出）、Confidence（High/Medium/Low，证据缺失时降级）、Next Steps（可执行建议）。
Bug 提交：高置信度且指向 agent-validator 缺陷时，自动调用 validator-issue 并传 --auto-file <diagnosis summary>；高置信度但属配置、用户错误或预期行为则不提交；中置信度且疑似缺陷时先询问用户；低置信度不提示也不提交。
限制：仅诊断不修复；依赖日志与状态文件，缺失或为空时置信度下降；不基于源码分析。