From 59bc552091d44a71f312fd274c19d5b98bd667de Mon Sep 17 00:00:00 2001 From: Cai <cai@nbcai.cc> Date: Sun, 02 Aug 2026 17:32:59 +0800 Subject: [PATCH] chore: update project roles research and development artifacts --- exp-doc/目录导读.md | 68 ++++++++++++++++------------------ 1 files changed, 32 insertions(+), 36 deletions(-) diff --git "a/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" "b/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" index 36c5be3..6a60c68 100644 --- "a/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" +++ "b/exp-doc/\347\233\256\345\275\225\345\257\274\350\257\273.md" @@ -1,46 +1,42 @@ -# exp-doc 目录导读 +# exp-doc 目录导读 -创建人员：Codex -文件职责：说明 `common/exp-doc` 目录下实验规范和实验模板文档的用途。 -管理规范/模板：../../管理系统说明.md；../../体系说明.md；common/exp-doc/实验规范.md。 -引用文件：实验规范.md；本目录下全部 `*模版.md` 文件。 +创建人员：management.admin +文件职责：说明 `project-info` 项目实验体系文档入口和相邻数据目录用途。 +管理规范/模板：../项目规范.md；../../common/exp-doc/实验环境创建指南.md；../../common/exp-doc/实验规范.md。 +引用文件：实验规范.md；实验审计规范.md；实验存储体系.md；实验总纲.md；实验设计.md；实验执行日志.md；实验审计报告.md；实验问题记录.md；../项目配置清单.md。 +记录方式：目录入口文档；本目录正式文件新增、删除、改名或职责变化时同步更新。 -## 1. 目录定位 +## 1. 本体系定位 -本目录保存通用实验体系规范和实验体系模板。 +`project-info` 的实验体系用于对股市信息分析中的假设、数据口径、K 线统计、研报/新闻规则和信息拓扑方法做可复核验证。实验体系只输出实验结果和边界，不替代案例体系的案例叙事，也不直接给出交易建议。 -`实验规范.md` 是体系说明文件，不是模板。 +## 2. 文档入口 -`*模版.md` 文件用于新项目或新实验事项创建时实例化对应实验文档。 +| 文件 | 作用 | +|---|---| +| `实验规范.md` | 本项目实验员必须遵守的本地规范入口 | +| `实验审计规范.md` | 本项目实验审核员必须遵守的本地审核规范入口 | +| `实验审核规范.md` | common 审核规范的项目副本/兼容入口；优先使用 `实验审计规范.md` | +| `实验存储体系.md` | 实验数据、结果包、图片、日志和 schema 的存储口径 | +| `实验总纲.md` | 实验事项背景、目标、边界、状态和结论账本 | +| `实验设计.md` | 实验设计、步骤、依赖、产物和判定标准 | +| `实验执行日志.md` | 实验 run、输入、关键过程、输出、异常、自检和重跑记录 | +| `实验审计报告.md` | 设计审核、执行审核、复审和审计问题主记录 | +| `实验问题记录.md` | 非审计来源实验问题，审计问题只做索引 | -## 2. 文件清单 +## 3. 数据目录 -| 文件 | 类型 | 作用 | -|---|---|---| -| 实验规范.md | 体系规范 | 说明实验体系核心流程、文档职责和审计闭环 | -| 实验环境创建指南.md | 创建指南 | 指导 AI 在项目中创建完整实验员工作环境 | -| 实验总纲模版.md | 模板 | 创建项目级实验总纲滚动账本 | -| 实验设计模版.md | 模板 | 创建项目级实验设计滚动账本 | -| 实验执行日志模版.md | 模板 | 创建项目级实验执行日志滚动账本 | -| 实验存储体系创建指南.md | 创建指南 | 指导项目创建实验存储体系文档、数据目录、schema 和读取规则 | -| 实验审核规范.md | 审核规范 | 定义实验设计审核、执行审核、复审和审计报告记录规则；项目内应实例化为 `实验审计规范.md` | -| 实验审计报告模版.md | 模板 | 创建项目级实验审计报告滚动账本 | -| 实验问题记录模版.md | 模板 | 创建项目级实验非审计问题闭环滚动账本；审计问题只做索引 | +| 目录 | 作用 | +|---|---| +| `../exp-data/raw/` | 实验原始输入索引、抽样数据或外部文件引用 | +| `../exp-data/result/` | 正式结果包、manifest、summary、readout 和中间可复核产物 | +| `../exp-data/img/` | 实验图片、图表和图片 manifest | +| `../exp-data/tmp/` | 临时数据，不得作为正式证据入口 | -## 3. 使用顺序 +## 4. 当前实验入口 -创建正式实验事项时，建议顺序： +| 实验 ID | 名称 | 状态 | 入口 | +|---|---|---|---| +| `EXP-SMOKE-001` | 实验体系初始化 dry-run | 初始化完成，待审核员复核 | `实验总纲.md`、`实验设计.md`、`实验执行日志.md`、`实验审计报告.md` | -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、最新审计和最新问题记录都追加到对应文件末尾。 +新增正式实验时，应先写 `实验总纲.md` 和 `实验设计.md`；设计审核通过后才能执行，执行完成后必须提交执行审核。 -- Gitblit v1.9.3