validate-delivery 的用途是在任务交付前自主校验其完整性与可发布性,无需人工干预,并以结构化 JSON 返回给编排器。
主要能力包括六项检查:评审状态(approve 或 override 才通过);测试通过(自动识别 npm test、pytest、cargo test、go test 等运行器,无测试则视为通过);构建通过(识别 npm run build、cargo build --release、go build 等,无构建步骤则通过);需求满足(从任务描述中解析短横线或数字列表项,逐条验证是否已实现,最多取 10 条);无回归(对比改动前后测试通过数量);差异风险评分(可选、顾问性质)。
差异风险基于 repo-intel 地图计算:风险分大于 0.6 的文件需要明确的测试覆盖证据,大于 0.7 需标记人工复核;该检查始终为通过状态,绝不单独阻断发布。若缺少 repo-intel 地图,会询问是否生成,生成失败或不可用时则跳过并注明原因。
使用方式上,当用户提出交付校验、就绪检查或完成验证时触发。全部检查通过时返回 approved 为 true,并附带各检查结果与可选风险摘要;任一失败时返回 failedChecks 及针对性的修复指令(如修复失败测试运行 npm test、修复构建运行 npm run build、实现缺失需求并列出条目),工作流可在修复后自动重试。
适用场景为编码任务发布前的自动化质量门禁,尤其适合需要在 CI 或智能体工作流中无人值守验证完成的场合。
限制方面:需要能够访问仓库与相应测试、构建命令;需求解析仅覆盖描述中的短横线或编号列表;差异风险依赖 repo-intel,不可用时仅作跳过提示;该技能不做人工评审本身,仅检查评审结果状态。