# exp-doc 目录导读

创建人员：Codex  
文件职责：说明 `common/exp-doc` 目录下实验规范和实验模板文档的用途。  
管理规范/模板：../../管理系统说明.md；../../体系说明.md；common/exp-doc/实验规范.md。  
引用文件：实验规范.md；本目录下全部 `*模版.md` 文件。

## 1. 目录定位

本目录保存通用实验体系规范和实验体系模板。

`实验规范.md` 是体系说明文件，不是模板。

`*模版.md` 文件用于新项目或新实验事项创建时实例化对应实验文档。

## 2. 文件清单

| 文件 | 类型 | 作用 |
|---|---|---|
| 实验规范.md | 体系规范 | 说明实验体系核心流程、文档职责和审计闭环 |
| 实验环境创建指南.md | 创建指南 | 指导 AI 在项目中创建完整实验员工作环境 |
| 实验总纲模版.md | 模板 | 创建项目级实验总纲滚动账本 |
| 实验设计模版.md | 模板 | 创建项目级实验设计滚动账本 |
| 实验执行日志模版.md | 模板 | 创建项目级实验执行日志滚动账本 |
| 实验存储体系创建指南.md | 创建指南 | 指导项目创建实验存储体系文档、数据目录、schema 和读取规则 |
| 实验审核规范.md | 审核规范 | 定义实验设计审核、执行审核、复审和审计报告记录规则；项目内应实例化为 `实验审计规范.md` |
| 实验审计报告模版.md | 模板 | 创建项目级实验审计报告滚动账本 |
| 实验问题记录模版.md | 模板 | 创建项目级实验非审计问题闭环滚动账本；审计问题只做索引 |

## 3. 使用顺序

创建正式实验事项时，建议顺序：

1. 先按 `实验环境创建指南.md` 在项目中创建实验环境。
2. 用 `实验总纲模版.md` 创建项目级实验总纲。
3. 用 `实验设计模版.md` 创建项目级实验设计。
4. 设计审核通过后执行实验。
5. 用 `实验执行日志模版.md` 记录执行。
6. 将结果包入口回写到实验总纲和实验设计。
7. 按 `实验存储体系创建指南.md` 建立或更新项目内 `实验存储体系.md`，并按该体系归档结果资产。
8. 按 common `实验审核规范.md` 和项目本地 `实验审计规范.md` 审核设计和执行，并用 `实验审计报告模版.md` 创建或更新项目 `实验审计报告.md`。
9. 非审计来源问题用 `实验问题记录模版.md` 处理闭环；审计员发现的问题主记录写入实验审计报告，必要时在问题记录中建索引。结论回写记录到实验总纲和审计报告。

项目实验入口不再强制使用单独导读或总纲列表模板；AI 直接读取实验总纲即可。项目如果已有总索引，可在总索引里放实验总纲入口。

所有项目级实验文档默认采用 append-only 方式维护：最新实验、最新设计、最新 run、最新审计和最新问题记录都追加到对应文件末尾。