| | |
| | | # 实验总纲模版 |
| | | # 实验总纲 |
| | | |
| | | 创建人员:<填写创建人员或 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`。 |