2.4 KiB
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