Cai
2026-08-09 0af27bb8065d68281593a5efb2fe64ea8e8d7d57
exp-doc/实验总纲.md
@@ -1,95 +1,29 @@
# 实验总纲模版
# 实验总纲
创建人员:<填写创建人员或 AI>
文件职责:记录项目内所有实验事项的背景、目标、主线口径、阶段结论、结果包入口和下一步;对应管理系统里的事项总纲账本。
管理规范/模板:common/exp-doc/实验规范.md;本文件由 common/exp-doc/实验总纲模版.md 实例化。
引用文件:<填写实验规范、实验设计、实验执行日志、实验审计报告、实验存储体系、来源聊天记录或上游文档>
创建人员:management.admin
文件职责:记录 `project-info` 项目实验事项的背景、目标、边界、状态、结果包入口和结论。
管理规范/模板:../../common/exp-doc/实验总纲模版.md;../../common/exp-doc/实验环境创建指南.md。
引用文件:实验规范.md;实验设计.md;实验执行日志.md;实验审计报告.md;实验存储体系.md。
记录方式:append-only 滚动账本;新增实验或状态变化时追加记录。
## 0. 当前总览
## 1. 当前总览
> 本节用于人和 AI 快速进入当前状态,可以随最新进展更新;详细实验记录仍必须追加到文件末尾。
| 实验 ID | 名称 | 状态 | 结论 |
|---|---|---|---|
| `EXP-SMOKE-001` | 实验体系初始化 dry-run | 已记录,待审核员复核 | 环境链路可承接实验事项;无真实业务结论 |
- 当前主线:<当前实验主线或研究方向>
- 当前最新实验:<实验事项 ID / 名称 / 状态>
- 当前有效结论:<只写已被结果和审核支持的结论>
- 当前阻断项:<无/待补数据/设计未审/执行未审/其他>
- 当前下一步:<下一步动作>
- 关键入口:<实验设计.md / 实验执行日志.md / 实验审计报告.md / 结果包索引>
## 2. 实验事项:EXP-SMOKE-001
## 1. 固定口径和长期约定
- 项目名称:<填写项目名称>
- 项目路径:<相对路径或项目标识>
- 实验记录维护方式:append-only;新实验、新结论、新修订追加到文件末尾,最新内容在最后。
- 历史记录处理:历史结论不得删除;如失效,追加“失效/降读/替代”说明并指向证据。
- 路径规则:项目内文件默认使用相对路径;不要默认写本机绝对路径。
- 关键来源聊天记录规则:用户原始要求或其可打开路径必须进入对应实验块的背景。
## 2. 实验记录追加区
> 从这里开始按时间顺序追加。不要把最新实验插到文件开头;不要为每个实验创建独立总纲文件。
> 推荐结构参考长期滚动账本:背景 -> 目标 -> 设计入口 -> 结果入口 -> 关键结果 -> 当前读法 -> 下一步。
## <YYYY-MM-DD> <实验事项 ID>:<实验名称>
- 创建人员:<填写>
- 创建时间:<YYYY-MM-DD HH:mm:ss>
- 当前状态:<未开始/设计中/待设计审核/设计审核通过/执行中/待执行审核/完成/暂停/取消>
- 当前结论:<未形成/阶段结论/完成结论>
### 背景、由来和关键聊天记录
- 背景:<为什么要做>
- 由来:<来自哪个讨论、需求、方法论、前序实验或异常>
- 原理来源:<上游文档、案例、数据观察或聊天路径>
- 关键来源聊天记录:<粘贴最重要原文,或给出可直接打开的路径>
- 聊天要求摘要:<把用户要求压成要点,方便审核员对照>
### 目标和边界
- 主目标:<本实验最核心要回答的问题>
- 次目标:<可选>
- 不属于本轮目标:<明确不验证什么>
- 数据边界:<数据范围、时间范围、样本范围>
- 方法边界:<本轮使用/不使用的方法>
- 结论边界:<本轮最多能说明什么>
### 设计、执行和审计入口
- 实验设计:`实验设计.md` 中 <设计 ID / 小节标题>
- 执行日志:`实验执行日志.md` 中 <run_id / 小节标题>
- 设计审核:`实验审计报告.md` 中 <audit_id / 小节标题>
- 执行审核:`实验审计报告.md` 中 <audit_id / 小节标题>
- 非审计问题 / 审计问题索引:`实验问题记录.md` 中 <issue_id / 小节标题;如无填写无>
### 结果包和关键证据入口
- 结果包:<路径>
- summary/readout:<路径>
- 核心表:<路径>
- 核心图或可视化证据:<路径>
- manifest/hash/输入快照:<路径>
### 关键结果
- <关键指标 1>:<取值和读法>
- <关键指标 2>:<取值和读法>
- <关键异常或缺口>:<无/说明>
### 当前读法
- 可以读成:<证据支持的结论>
- 不能读成:<防止过读>
- 降读/失效记录:<如无填写无;如有说明原因和替代结论>
### 下一步
- 下一步动作:<继续实验/补数据/补对照/回写方法论/进入实现/暂停>
- 继续条件:<满足什么条件才继续>
- 停止条件:<满足什么条件必须停止或降级>
### 结论回写
- 回写目标:<方法论/需求/代码/数据/下一轮实验/暂停说明>
- 回写内容:<填写>
- 回写状态:<待回写/已回写/不回写>
- 实验 ID:EXP-SMOKE-001
- 实验名称:实验体系初始化 dry-run
- 创建人员:management.admin
- 创建时间:2026-06-25T20:55:00+08:00
- 当前状态:待审核员复核
- 背景:修复 `project-info` 初始创建时实验体系目录和本地文档未按创建指南完整落地的问题。
- 目标:验证 `exp-doc/`、`exp-data/`、设计、执行日志、审计报告和问题记录之间能形成最小可追溯链路。
- 边界:本事项不是股市业务实验,不查询数据库、不生成统计结果、不产生交易建议。
- 设计入口:`exp-doc/实验设计.md#实验设计exp-smoke-001`
- 执行入口:`exp-doc/实验执行日志.md#2026-06-25-run-exp-smoke-001`
- 审计入口:`exp-doc/实验审计报告.md#2026-06-25-audit-exp-smoke-001`
- 结果包入口:无真实结果包;本事项为体系 dry-run。
- 当前结论:本地文档和数据目录已补齐,仍需审核员确认是否满足 `common/exp-doc/实验环境创建指南.md`。