# 验证检查清单 (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` 时，脚本会自动执行上述检查并在日志中显示每项的检查结果。

---

## 失败处理

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

回滚命令：
```bash
rm -f sample_output.json
```