用途:validator-run 用于执行自主验证套件(agent-validate run),仅在明确要求完整验证时使用,例如“run the validator”“run the gauntlet”“run validation”“validate this”,或在 commit、push、PR 前要求验证。不应仅因编码任务完成、用户要求通用审查或只要求检查而选用。
主要能力与流程:
- 运行验证:如需启用特定审查,为每个请求追加 --enable-review <name>,用 Bash 运行 agent-validate run,timeout 设为 300000,必须等待并读取完整输出(通常 1-2 分钟),确认出现 Status: 行。
- 检查状态:Passed 或 Passed with warnings 进入总结;Failed 必须继续修复;Retry limit exceeded 进入总结;看不到状态行时,读取验证器日志目录中最新的 console.*.log(如 validator_logs/console.1.log)查找 Status:,必要时也检查 validator_logs/previous/;若都没有,可能超时或失败,需重跑或排查,不得当作通过。
- 提取失败:状态为 Failed 时,运行 agent-validate update-review list 获取 REVIEW 违规的 ID、优先级、gate、file:line、问题与建议修复,保留 ID;对每个失败的 CHECK,仅依据控制台 [FAIL] 输出或 --report 的 CHECK FAILURES 部分,读取指定日志或重跑报告的命令。不要扫描日志目录或读取 review JSON。
- 报告失败:打印检查失败与 update-review list 输出,包含每个违规 ID。
- 修复:修复反馈合理支持或人类可能意图的问题;跳过时简要说明原因。可跳过纯风格或主观偏好、人类不希望更改的情况;不得以“问题早已存在”或“超出范围”为由跳过。带 Fix Skill 的 CHECK 失败调用对应技能,带 Fix Instructions 的按说明处理,REVIEW 违规按上述指引修复或跳过。
- 更新审查决定:用 ID 记录决定,运行 agent-validate update-review fix <id> "<what changed>" 或 agent-validate update-review skip <id> "<why>";ID 在下一次验证运行前保持稳定;不要直接编辑 validator_logs/ 或配置的日志目录。
- 重新验证:不得跳过,用与第 1 步相同的命令(含 --enable-review 标志)再次运行,timeout 300000,工具检测到已有日志会自动切换到验证模式,回到第 2 步重复。
- 总结会话:给出最终状态、已修复问题、已跳过问题及原因、未解决失败(若重试超限)。
适用场景:提交、推送或创建 PR 前的完整验证,以及用户明确要求运行验证器时。
限制:仅限显式验证请求;不适用于通用审查或仅检查;必须看到明确 Status: 行,不得假设成功;日志缺失时需排查而非视为通过;不得直接编辑日志目录。