edit | blame | history | raw

实验规范

创建人员:Codex
文件职责:记录 project B 实验员必须遵守的实验规范。本文件引用 common/exp-doc/实验规范.md,不得削弱 common 实验规范硬约束。
管理规范/模板:../../common/exp-doc/实验规范.md
引用文件:../../common/exp-doc/实验规范.md;../../common/exp-doc/实验环境创建指南.md

1. 基本口径

本项目所有实验员必须同时遵守 ../../common/exp-doc/实验规范.md 和本文件。

本文件当前没有额外补充规则,但保留本项目核心实验文档说明,方便实验员直接理解本项目证据链。

2. 核心实验文档作用

文档 作用
实验总纲.md 记录本项目所有实验事项的背景、目标、边界、状态、结果包入口和结论
实验设计.md 记录本项目所有实验的设计、步骤、依赖、产物和判定标准
实验执行日志.md 记录本项目所有实验 run、输入、关键中间过程、中间数据路径、输出、异常、自检和重跑
实验存储体系.md 说明实验数据、结果包、图片、表 schema 和读取追踪方式
实验审计报告.md 记录设计审核、执行审核、复审结论,以及审核员发现的问题
实验问题记录.md 记录非审计来源实验问题;审计问题只在需要跨轮跟踪时登记索引

3. 本地目录口径

项目内实验文档使用相对路径。

项目级实验账本:

  1. 实验总纲.md
  2. 实验设计.md
  3. 实验执行日志.md

新实验默认追加到上述三本账本,不创建单实验独立总纲、设计或执行日志。

4. 执行日志补充口径

project B 的执行日志不能只记录开始和结果。每个 run 至少要记录:

  1. 输入快照在哪里。
  2. 每个关键中间步骤做了什么。
  3. 中间数据或中间表保存在哪里。
  4. 最终结果、图、summary、manifest 在哪里。
  5. 每个关键步骤的行数、数量、hash 或等价校验。

需要审计员复核的中间数据应保存到 ../exp-data/result/<run_id>/intermediate/ 或等价正式结果包目录,不应只保存在 ../exp-data/tmp/