Files
val-blog/org/verification/anvil_v1/checklist.md
T

2.4 KiB

验证检查清单 (Checklist)

本清单定义了 Anvil 执行验证的完整检查项,分为三个阶段。


前置检查 (Pre-Check)

在执行验证前,确保以下条件满足:

# 检查项 验证方式 通过标准
1 验证包目录存在 test -d org/verification/anvil_v1 目录存在
2 sample_input.json 存在且格式正确 JSON 解析验证 有效 JSON
3 sample_input.json 包含必要字段 字段检查 包含 task_id, scope, constraints, acceptance_criteria
4 task_id 非空 字符串检查 task_id 长度 > 0
5 acceptance_criteria 定义明确 内容检查 至少包含一项验收标准
6 脚本文件存在且可执行 test -x run.sh run.sh 存在且有执行权限

执行检查 (Execution Check)

在验证执行过程中,检查以下关键点:

# 检查项 验证方式 通过标准
7 执行日志正常输出 日志检查 包含 "Starting", "Processing", "Completed" 阶段日志
8 输入参数正确解析 变量检查 task_id, scope 正确读取
9 约束条件验证通过 约束检查 所有 constraints 得到满足或明确记录
10 验收标准逐项核对 标准检查 acceptance_criteria 逐项验证并记录结果

收尾检查 (Post-Check)

执行完成后,验证最终产物:

# 检查项 验证方式 通过标准
11 sample_output.json 已生成 文件存在检查 文件存在
12 sample_output.json 格式正确 JSON 解析验证 有效 JSON
13 sample_output.json 包含必要字段 字段检查 包含 status, artifacts, metrics, errors
14 status 字段值有效 值检查 status 为 "success" 或 "failure"
15 artifacts 数组格式正确 数组检查 数组类型,非 null
16 errors 数组存在 数组检查 errors 字段存在(可为空数组)

检查项统计

  • 前置检查: 6 项
  • 执行检查: 4 项
  • 收尾检查: 6 项
  • 总计: 16 项

使用方法

运行 ./run.sh 时,脚本会自动执行上述检查并在日志中显示每项的检查结果。


失败处理

任何检查项失败都会导致验证失败。可通过查看日志定位失败的具体检查项。

回滚命令:

rm -f sample_output.json