用途:在任务执行期间持续跟踪必需的验证门禁,而不是等到最后才检查,从而减少漏掉失败或跳过检查的情况。
主要能力:每个门禁包含名称(如 lint、unit-tests、migration-dry-run)、命令、是否必需、最近状态(pending、pass、fail、waived)和备注。必需门禁必须通过或被豁免才能完成。
使用方式:通过命令行操作,例如查看状态 python3 gate.py --status;添加门禁 python3 gate.py --add --name lint --command "npm run lint";添加可选门禁加 --optional;记录结果 python3 gate.py --record --name lint --status pass;豁免需备注 --status waived --note "...";完成前运行 python3 gate.py --ready --format json。
适用场景:任务包含多个测试、lint、构建、审查或迁移检查;用户要求测试优先或完成门禁;跨会话工作需要保留验证状态;准备宣布完成时。
限制:记录结果不会自动运行命令;豁免必须提供备注;必需门禁默认 pending 直到被记录。状态保存在 ~/.openclaw/skill-state/quality-gate-orchestrator/state.yaml,包含 gates、last_ready_at、ready 和 gate_history 字段。未提供收费、平台或效果信息。