validator-run

/validator-run

运行自主验证套件。

调用策略

仅在收到明确的验证请求时使用此技能，例如“运行验证器”“运行全面验证”“运行验证”“验证这个”或“提交/推送/创建 PR 前进行验证”。

不要仅仅因为完成了编码任务、用户要求进行一般性审查，或用户只要求执行检查，就选择此技能。

流程

步骤 1 - 运行 Agent 验证器

如果调用者要求启用特定审查，请在运行命令中为每项所需审查追加 --enable-review <name>。

使用 Bash 运行 agent-validate run，并设置 timeout: 300000。务必等待并阅读完整的命令输出后再继续——该命令通常需要 1 到 2 分钟。继续之前，确认输出中能看到 Status: 行。

步骤 2 - 检查状态

切勿假定验证成功——继续之前，必须看到明确的 Status: 行。检查状态并按以下方式处理：

• Status: Passed → 转到步骤 8。
• Status: Passed with warnings → 转到步骤 8。
• Status: Failed → 继续步骤 3。必须继续，不要在此处停止。
• Status: Retry limit exceeded → 转到步骤 8。
• 看不到状态行 → **已知问题：**运行 LLM 审查子进程时，Bun 可能会丢弃所有 stdout/stderr。请读取控制台日志文件以获取状态：在验证器日志目录中找到最新的 console.*.log（例如 validator_logs/console.1.log），并在其中查找 Status: 行。如果该目录中没有控制台日志，也请检查 validator_logs/previous/ 中最近归档运行的日志。如果这两个位置都没有控制台日志，则命令可能已超时或未能运行——请使用更长的超时时间重新运行，或调查错误。不要在没有确认状态的情况下当作验证通过处理。

步骤 3 - 提取失败项

状态为 Failed 时必须执行：

• 使用 Bash 运行 agent-validate update-review list，查看 REVIEW 违规项。该命令会列出每个待处理违规项的 ID、优先级、门禁、file:line、问题和建议修复方法。保留这些 ID，以便在步骤 6 中使用。
• 对于每项失败的 CHECK，只能使用运行结果中的控制台 [FAIL] 输出或 --report 的 CHECK FAILURES 部分所报告的内容：检查命令、修复说明或修复技能，以及日志路径。若要查看错误输出，请读取指定的单个日志文件，或重新运行所报告的命令。重新运行命令时，请遵循报告中指定的工作目录。
• 不要列出或扫描日志目录。不要读取审查 JSON 文件。

步骤 4 - 报告失败项

输出检查失败项和步骤 3 中 update-review list 的结果，包括每项审查违规的 ID。

步骤 5 - 修复

根据反馈中有充分依据或符合人工预期的内容，合理修复问题。跳过问题时，请简要说明跳过的内容及原因。

可接受的跳过理由：

• 纯粹出于风格或主观偏好
• 人工不会希望对此进行更改

不得以下列理由跳过：

• “问题是预先存在的”——除非有其他可接受的理由，否则必须修复
• “问题超出范围”——必须处理有效反馈，即使需要重构或进行非简单的更改

针对每项失败，按以下方式处理：

• 有修复技能的 CHECK 失败：调用指定技能
• 有修复说明的 CHECK 失败：按说明操作
• REVIEW 违规：根据上述指导修复或跳过

步骤 6 - 更新审查决定

针对已处理的每项 REVIEW 违规，使用步骤 3 中的 ID。只有在需要刷新 ID 时，才再次运行 agent-validate update-review list。使用 agent-validate update-review fix <id> "<what changed>" 或 agent-validate update-review skip <id> "<why>" 记录每项决定。

在下一次运行验证器之前，ID 会保持稳定。步骤 7 前记录所有决定。

**不要直接编辑 validator_logs/ 或配置的日志目录中的文件。**使用 update-review 记录审查决定。

步骤 7 - 重新运行验证

绝不要跳过此步骤——如果运行失败，必须修复并重新运行。再次使用 Bash 和 timeout: 300000 运行步骤 1 中的同一条命令（包括任何 --enable-review 标志）。该工具会检测现有日志并自动切换到验证模式。返回步骤 2，检查状态行并重复此操作。

步骤 8 - 总结会话

提供会话总结：

• 最终状态：（通过 / 有警告通过 / 超出重试次数限制）
• 已修复的问题：（列出关键修复）
• 已跳过的问题：（列出跳过的项目及原因）
• 尚未解决的故障：（如果超出重试次数限制，列出未经验证的修复和剩余问题）