用途:在完成代码实现、代码评审、任务收尾、智能体交接或生产部署验证前,收集并核实可执行证据,避免仅凭主观判断声称任务完成。
主要能力:覆盖测试证据(退出码、通过/失败/跳过数量、覆盖率、耗时)、构建证据(退出码、编译错误与警告、产物、耗时)、部署证据(状态、环境、健康检查、回滚能力)、代码质量证据(linter、类型检查、安全扫描、可访问性审计)。提供退出码校验、证据存储、合并证据报告、证据收集工作流与质量标准等能力。
使用方式:可由完成实现、完成评审、Squad 模式标记完成、智能体交接前、生产部署验证等场景自动触发;也可在用户要求“验证是否可用”、创建 PR 前、质量保证评审或故障排查时手动启用。执行验证后捕获退出码(0 为通过)、保存输出片段、记录时间戳与运行环境,并将证据写入共享上下文或会话状态。可用命令示例:npm test、npm run build、npm run lint、npm run typecheck;pytest、pytest --cov、ruff check .、mypy .。
质量标准:最低要求为至少执行一种验证、捕获退出码、记录时间戳并存储证据;生产级要求测试退出码 0、覆盖率高于 70%(或项目标准)、构建成功、无关键 linter 错误、安全扫描通过;金标准还要求覆盖率高于 80%、无 linter 警告、性能达标、通过 WCAG 2.1 AA、集成测试通过并完成部署验证。
限制与注意:资料未提供独立安装命令或平台支持范围;具体命令、覆盖率和阈值需以项目实际情况为准。需避免三类错误:跳过证据收集、伪造证据、忽略失败证据。若证据缺失或失败,应先修复再标记完成。